messari-x402

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

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