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
- Wallet with USDC on Base:
mp token balance list --wallet main --chain base
- Small ETH on Base for gas
- If no USDC: bridge from Ethereum or swap via
mp token swap --chain base
Core command
mp x402 request \
--method <GET|POST> \
--url "https://api.messari.io<path>" \
--body '<json>' \ # POST only
--wallet main \
--chain base
Endpoint Reference
AI & Intelligence
| Endpoint | Method | Cost | Description |
|---|
/ai/v2/chat/completions | POST | $0.25 | AI chat with Messari's crypto knowledge graph |
/ai/v1/deep-research | POST | varies | Start async deep-research report |
/ai/v1/deep-research/{id} | GET | $0 | Poll report status |
Assets
| Endpoint | Method | Cost | Description |
|---|
/v2/assets | GET | $0.00 | List all assets |
/v2/assets/details | GET | ~$0.05 | Up to 20 asset details (?assets=btc,eth) |
/v2/assets/ath | GET | ~$0.05 | All-time highs |
/v2/assets/roi | GET | ~$0.05 | Return on investment metrics |
/v1/assets/timeseries/{slug} | GET | ~$0.18 | Price/volume timeseries |
Markets & Exchanges
| Endpoint | Method | Cost | Description |
|---|
/v1/markets | GET | $0.00 | List trading pairs |
/v1/markets/timeseries/{slug} | GET | ~$0.18 | Market price/volume timeseries |
/exchanges | GET | $0.00–$0.55 | Exchange list and metrics |
/exchanges/{slug}/timeseries/{metric} | GET | ~$0.55 | Exchange volume, futures data |
Signals & Social
| Endpoint | Method | Cost | Description |
|---|
/signal/v1/assets | GET | ~$0.35 | Asset sentiment and mindshare |
/signal/v1/assets/mindshare-gainers-24h | GET | ~$0.35 | Top mindshare movers (24h) |
/signal/v1/assets/mindshare-gainers-7d | GET | ~$0.35 | Top mindshare movers (7d) |
/signal/v1/x-users | GET | ~$0.75 | Influential X accounts |
/signal/v1/x-users/{id}/timeseries | GET | ~$0.75 | Social engagement timeseries |
News & Events
| Endpoint | Method | Cost | Description |
|---|
/news/v1/news/feed | GET | ~$0.55 | Aggregated crypto news feed |
/news/v1/news/sources | GET | $0.00 | Available news sources |
/v1/events | POST | ~$0.15 | Query governance, security, partnership events |
/v1/events/{id} | GET | ~$0.05 | Event history |
Fundraising
| Endpoint | Method | Cost | Description |
|---|
/funding/v1/rounds | GET | ~$0.35 | Recent funding rounds |
/funding/v1/rounds/investors | GET | ~$0.35 | Investors by round |
/funding/v1/funds | GET | ~$0.15 | Venture funds |
/funding/v1/funds/managers | GET | ~$0.15 | Fund managers |
/funding/v1/organizations | GET | ~$0.25 | Organizations |
/funding/v1/projects | GET | ~$0.25 | Projects |
/funding/v1/mergers-and-acquisitions | GET | ~$0.35 | M&A deals |
Networks & Protocols
| Endpoint | Method | Cost | Description |
|---|
/v2/networks | GET | ~$0.10 | List networks |
/v1/networks/timeseries/{metric} | GET | ~$0.25 | Network metrics (5m–1d) |
/protocols | GET | ~$0.10 | All protocols |
/protocols/{slug}/timeseries/{metric} | GET | ~$0.25 | Protocol metrics |
/protocols/dex | GET | ~$0.10 | DEX protocols |
/protocols/lending | GET | ~$0.10 | Lending protocols |
Stablecoins
| Endpoint | Method | Cost | Description |
|---|
/stablecoins | GET | ~$0.10 | List stablecoins |
/stablecoins/{slug}/timeseries | GET | ~$0.25 | Supply and usage metrics |
Token Unlocks & Vesting
| Endpoint | Method | Cost | Description |
|---|
/v1/allocations | GET | ~$0.25 | Token allocation info |
/v1/assets/{id}/events | GET | ~$0.75 | Unlock events |
/v1/assets/{id}/unlocks | GET | ~$0.75 | Unlock timeseries |
/v1/assets/{id}/vesting-schedule | GET | ~$0.50 | Vesting schedule |
Trending Topics
| Endpoint | Method | Cost | Description |
|---|
/v1/current | GET | ~$0.25 | Today's trending topics |
/v1/daily | GET | ~$0.25 | Historical topic timeseries (90-day max) |
/v1/classes | GET | $0.00 | Topic classifications |
Research Reports
| Endpoint | Method | Cost | Description |
|---|
/v1/reports | GET | ~$0.15 | Research reports (filterable by asset, tags) |
/v1/reports/{id} | GET | ~$0.05 | Specific report |
/v1/reports/tags | GET | $0.00 | Available tags |
Common query parameters
| Parameter | Values | Purpose |
|---|
assets | btc,eth,sol | Filter by asset slug |
granularity | hourly, daily, monthly | Timeseries resolution |
start_date | ISO 8601 | Start of range |
end_date | ISO 8601 | End of range |
limit | integer | Max results |
page | integer | Pagination |
Example: AI chat
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
mp x402 request \
--method GET \
--url "https://api.messari.io/v2/assets/details?assets=btc,eth,sol" \
--wallet main \
--chain base
Example: Mindshare gainers
mp x402 request \
--method GET \
--url "https://api.messari.io/signal/v1/assets/mindshare-gainers-24h" \
--wallet main \
--chain base
Discover all endpoints
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
Related skills
- 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
