Agent skill

Messari X402

by moonpay in moonpay/skills

Access Messari's full API via x402 pay-per-request — no API key needed.

MITAuto-check passedBusiness, Finance & HR

Install Messari X402

skills CLI
$ npx skills add moonpay/skills --skill messari-x402 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install moonpay/skills messari-x402 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/moonpay/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/messari-x402 .claude/skills/messari-x402 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
messari-x402
GitHub stars
113
Token cost
~1.8k tokens
SKILL.md length
543 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Access Messari's full API via x402 pay-per-request — no API key needed.

  • Works in 3 steps: Wallet with USDC on Base: mp token… → Small ETH on Base for gas → If no USDC: bridge from Ethereum or swap…
  • Tasks that involve Fundraising and pitch decks
  • SKILL.md covers Goal, Prerequisites, Core command and Endpoint Reference, plus 7 more sections
  • Reaches api.messari.io

What it does

Messari X402 is an agent skill from moonpay/skills. Access Messari's full API via x402 pay-per-request — no API key needed. Asset data, market metrics, signals, news, fundraising, token unlocks, on-chain networks, and AI chat, all paid with USDC on Base.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Fundraising and pitch decks and Smart contracts. It works with x402 and Circle USDC. The repository describes itself as: Skills for AI agents to move money — on-ramps, swaps, wallets, deposits, and more via the MoonPay CLI. The licence is MIT.

When your agent uses it

  • Tasks that involve Fundraising and pitch decks
  • Tasks that involve Smart contracts

Example prompts

  • “/messari-x402”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Wallet with USDC on Base: mp token balance list --wallet main --chain base
  2. Small ETH on Base for gas
  3. If no USDC: bridge from Ethereum or swap via mp token swap --chain base

What it can do on your machine

Read from SKILL.md and the folder at commit aa672ab. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.messari.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Messari X402 loads about 1.8k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 543 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from moonpay/skills at commit aa672ab, republished under its MIT licence (© moonpay). 543 words, ~1,770 tokens.

Download SKILL.mdSave it as .claude/skills/messari-x402/SKILL.md (or your agent's skills folder).
name
messari-x402
description
Access Messari's full API via x402 pay-per-request — no API key needed. Asset data, market metrics, signals, news, fundraising, token unlocks, on-chain networks, and AI chat, all paid with USDC on Base.
tags
messari, x402, research, market-data, payments

Messari x402 API

Goal

Make pay-per-request HTTP calls to Messari's API using USDC on Base Mainnet. No API key required — the CLI handles the 402 payment flow automatically.

Prerequisites

  1. Wallet with USDC on Base: mp token balance list --wallet main --chain base
  2. Small ETH on Base for gas
  3. If no USDC: bridge from Ethereum or swap via mp token swap --chain base

Core command

bash
mp x402 request \
  --method <GET|POST> \
  --url "https://api.messari.io<path>" \
  --body '<json>' \        # POST only
  --wallet main \
  --chain base

Endpoint Reference

AI & Intelligence
EndpointMethodCostDescription
/ai/v2/chat/completionsPOST$0.25AI chat with Messari's crypto knowledge graph
/ai/v1/deep-researchPOSTvariesStart async deep-research report
/ai/v1/deep-research/{id}GET$0Poll report status
Assets
EndpointMethodCostDescription
/v2/assetsGET$0.00List all assets
/v2/assets/detailsGET~$0.05Up to 20 asset details (?assets=btc,eth)
/v2/assets/athGET~$0.05All-time highs
/v2/assets/roiGET~$0.05Return on investment metrics
/v1/assets/timeseries/{slug}GET~$0.18Price/volume timeseries
Markets & Exchanges
EndpointMethodCostDescription
/v1/marketsGET$0.00List trading pairs
/v1/markets/timeseries/{slug}GET~$0.18Market price/volume timeseries
/exchangesGET$0.00–$0.55Exchange list and metrics
/exchanges/{slug}/timeseries/{metric}GET~$0.55Exchange volume, futures data
Signals & Social
EndpointMethodCostDescription
/signal/v1/assetsGET~$0.35Asset sentiment and mindshare
/signal/v1/assets/mindshare-gainers-24hGET~$0.35Top mindshare movers (24h)
/signal/v1/assets/mindshare-gainers-7dGET~$0.35Top mindshare movers (7d)
/signal/v1/x-usersGET~$0.75Influential X accounts
/signal/v1/x-users/{id}/timeseriesGET~$0.75Social engagement timeseries
News & Events
EndpointMethodCostDescription
/news/v1/news/feedGET~$0.55Aggregated crypto news feed
/news/v1/news/sourcesGET$0.00Available news sources
/v1/eventsPOST~$0.15Query governance, security, partnership events
/v1/events/{id}GET~$0.05Event history
Fundraising
EndpointMethodCostDescription
/funding/v1/roundsGET~$0.35Recent funding rounds
/funding/v1/rounds/investorsGET~$0.35Investors by round
/funding/v1/fundsGET~$0.15Venture funds
/funding/v1/funds/managersGET~$0.15Fund managers
/funding/v1/organizationsGET~$0.25Organizations
/funding/v1/projectsGET~$0.25Projects
/funding/v1/mergers-and-acquisitionsGET~$0.35M&A deals
Networks & Protocols
EndpointMethodCostDescription
/v2/networksGET~$0.10List networks
/v1/networks/timeseries/{metric}GET~$0.25Network metrics (5m–1d)
/protocolsGET~$0.10All protocols
/protocols/{slug}/timeseries/{metric}GET~$0.25Protocol metrics
/protocols/dexGET~$0.10DEX protocols
/protocols/lendingGET~$0.10Lending protocols
Stablecoins
EndpointMethodCostDescription
/stablecoinsGET~$0.10List stablecoins
/stablecoins/{slug}/timeseriesGET~$0.25Supply and usage metrics
Show full SKILL.md (211 more words)Show less
Token Unlocks & Vesting
EndpointMethodCostDescription
/v1/allocationsGET~$0.25Token allocation info
/v1/assets/{id}/eventsGET~$0.75Unlock events
/v1/assets/{id}/unlocksGET~$0.75Unlock timeseries
/v1/assets/{id}/vesting-scheduleGET~$0.50Vesting schedule
EndpointMethodCostDescription
/v1/currentGET~$0.25Today's trending topics
/v1/dailyGET~$0.25Historical topic timeseries (90-day max)
/v1/classesGET$0.00Topic classifications
Research Reports
EndpointMethodCostDescription
/v1/reportsGET~$0.15Research reports (filterable by asset, tags)
/v1/reports/{id}GET~$0.05Specific report
/v1/reports/tagsGET$0.00Available tags

Common query parameters

ParameterValuesPurpose
assetsbtc,eth,solFilter by asset slug
granularityhourly, daily, monthlyTimeseries resolution
start_dateISO 8601Start of range
end_dateISO 8601End of range
limitintegerMax results
pageintegerPagination

Example: AI chat

bash
mp x402 request \
  --method POST \
  --url "https://api.messari.io/ai/v2/chat/completions" \
  --body '{"model":"messari","messages":[{"role":"user","content":"What is the current narrative driving SOL?"}]}' \
  --wallet main \
  --chain base

Example: Asset details

bash
mp x402 request \
  --method GET \
  --url "https://api.messari.io/v2/assets/details?assets=btc,eth,sol" \
  --wallet main \
  --chain base

Example: Mindshare gainers

bash
mp x402 request \
  --method GET \
  --url "https://api.messari.io/signal/v1/assets/mindshare-gainers-24h" \
  --wallet main \
  --chain base

Discover all endpoints

bash
mp x402 request \
  --method GET \
  --url "https://api.messari.io/.well-known/x402" \
  --wallet main \
  --chain base

Notes

  • Payments are in USDC on Base Mainnet (--chain base)
  • If the request fails (status ≥ 400), payment is not settled — you don't pay for errors
  • ETH on Base is needed for gas (small amount, ~$0.001 per tx)
  • Use --chain base always — Messari does not accept Solana payments
  • messari-token-research — Full token research workflow
  • messari-alpha-scout — Mindshare + trending + news workflow
  • messari-funding-intel — Funding rounds + M&A workflow
  • messari-deep-research — Async deep-research report generation
  • moonpay-auth — Create or import a local wallet
  • moonpay-check-wallet — Check USDC balance on Base before spending

© moonpay, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/messari-x402 of moonpay/skills.

Open the folder on GitHubat commit aa672ab

Compare with similar skills

Messari X402 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Messari X402 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Messari X402 this skillmoonpay/skills113—~1.8kAutomated safety check: PassMIT
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT
Crypto DataBlockRunAI/blockrun-mcp391—~2.8kAutomated safety check: PassMIT
ZerionBankrBot/skills1.2k—~3.6kAutomated safety check: PassNone
Lonestaroracle DataBankrBot/skills1.2k—~2kAutomated safety check: PassNone
BlockrunBlockRunAI/blockrun-mcp391—~2.7kAutomated safety check: PassMIT

Similar skills

  • Surf

    BlockRunAI/ClawRouter

    Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

    6.6k GitHub stars~4k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed
  • Crypto Data

    BlockRunAI/blockrun-mcp

    A skill your agent uses for any crypto data question — token/coin prices, FX, commodities, stocks, OHLC history, DEX pairs and liquidity, DeFi TVL, yield/APY pools, or raw JSON-RPC against a chain…

    391 GitHub stars~2.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Zerion

    BankrBot/skills

    Interpreted crypto wallet data for AI agents. An agent skill from BankrBot/skills.

    1.2k GitHub stars~3.6k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed
  • Lonestaroracle Data

    BankrBot/skills

    Live pay-per-call data for crypto and DeFi protocol risk, funding rates, open interest, liquidations, stablecoin health, macro, equities, and on-chain intelligence — settled per query in USDC on…

    1.2k GitHub stars~2k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed
  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    391 GitHub stars~2.7k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Polymarket Trading

    BlockRunAI/ClawRouter

    A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

    6.6k GitHub stars~1.4k tokensUpdated 4 days ago
    Business, Finance & HRAuto-check passed

More from moonpay/skills

All 39 skills in this repo
  • A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 29 days ago
    Auto-check: notes
  • Alchemy API

    moonpay/skills

    Integrates Alchemy blockchain APIs using an API key. An agent skill from moonpay/skills.

    113 GitHub stars~2.1k tokensUpdated 29 days ago
    Auto-check passed
  • Allium Onchain Data

    moonpay/skills

    Query blockchain data via Allium APIs. An agent skill from moonpay/skills.

    113 GitHub stars~1.9k tokensUpdated 29 days ago
    Auto-check passed
  • Corbits Marketplace

    moonpay/skills

    Paid API marketplace for AI agents via Corbits. An agent skill from moonpay/skills.

    113 GitHub stars~1.5k tokensUpdated 29 days ago
    Auto-check passed
  • Dune Analytics

    moonpay/skills

    Blockchain analytics via Dune REST API — execute DuneSQL queries against live on-chain data, discover decoded contract tables, and monitor credit usage.

    113 GitHub stars~1.3k tokensUpdated 29 days ago
    Auto-check passed
  • Moonpay Auth

    moonpay/skills

    Set up the MoonPay CLI, authenticate, and manage local wallets.

    113 GitHub stars~1.2k tokensUpdated 29 days ago
    Auto-check passed

Works with

Questions about Messari X402

What does Messari X402 do?

Access Messari's full API via x402 pay-per-request — no API key needed. Messari X402 is an agent skill from moonpay/skills. Access Messari's full API via x402 pay-per-request — no API key needed.

When should I use Messari X402?

Messari X402 fits situations like: tasks that involve Fundraising and pitch decks; tasks that involve Smart contracts.

How do I install Messari X402 in Claude Code?

Run `npx skills add moonpay/skills --skill messari-x402 -a claude-code`. Or copy the skill folder (skills/messari-x402 in moonpay/skills) into .claude/skills/messari-x402 in your project. Claude Code loads it when a task matches its description.

How do I install Messari X402 in Codex?

Run `npx skills add moonpay/skills --skill messari-x402 -a codex`. Or copy the skill folder (skills/messari-x402 in moonpay/skills) into .agents/skills/messari-x402 in your project. Codex loads it when a task matches its description.

Can I use Messari X402 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add moonpay/skills --skill messari-x402 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/messari-x402, .gemini/skills/messari-x402, .github/skills/messari-x402 and .opencode/skills/messari-x402 in your project.

What does Messari X402 need to run?

SKILL.md names no scripts, command-line tools or credentials: Messari X402 is instructions for the agent only.

Does Messari X402 access the network?

SKILL.md names 1 domain. In commands or code: api.messari.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Messari X402 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Messari X402 use?

Messari X402 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Messari X402 use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Messari X402?

Skills that share tags, products or a category with Messari X402: Surf (BlockRunAI/ClawRouter, 6.6k stars), Crypto Data (BlockRunAI/blockrun-mcp, 391 stars), Zerion (BankrBot/skills, 1.2k stars) and Lonestaroracle Data (BankrBot/skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Messari X402?

moonpay (a GitHub organization) maintains it in moonpay/skills, which has 113 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on September 10, 2026.

Source: moonpay/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.