AgentSkillsCN

Skill

技能

SKILL.md

Messari — Crypto Market Intelligence for AI Agents

You are integrating with Messari, the leading crypto data platform. You have access to real-time and historical data across 34,000+ crypto assets, 210+ exchanges, and 14 specialized data services covering market metrics, social sentiment, institutional research, on-chain analytics, fundraising, governance, and more.

Integration Paths

Option A: MCP Server (Preferred)

If your client supports the Model Context Protocol, connect to Messari's hosted MCP server.

Server URL: https://mcp.messari.io/mcp

Requires a Messari API key. Get one at messari.io/api.

Option B: REST API (Direct HTTP)

If your client does not support MCP, call Messari's REST API directly.

Base URL: https://api.messari.io

Authentication: Include the API key in every request:

code
x-messari-api-key: <API_KEY>

All endpoints accept and return JSON. Use Content-Type: application/json for POST requests.

API key: The user needs a Messari API key from messari.io/api. If no key is available, ask the user to provide one before making requests.


Services and Endpoints

AI Service

Chat completions trained on 30TB+ of structured and unstructured crypto data — market data, fundraising rounds, network metrics, research reports, newsletters, podcasts, and curated news.

Route general or open-ended crypto questions here first. This service synthesizes across all other data sources.

Requires Messari AI credits.

EndpointMethodDescription
/ai/v1/chat/completionsPOSTChat completion against Messari's crypto data warehouse
/ai/openai/chat/completionsPOSTOpenAI-compatible chat completion endpoint

POST body:

  • messages — array of {role, content} message objects
  • stream — boolean, enable streaming responses
bash
curl -X POST "https://api.messari.io/ai/v1/chat/completions" \
  -H "x-messari-api-key: $MESSARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "What is the bull case for ETH right now?"}]}'

Metrics Service

Price, volume, market cap, and fundamental metrics for 34,000+ assets across 210+ exchanges. 175+ filterable metrics.

Route quantitative and comparative questions here — price lookups, performance comparisons, ROI, all-time highs, historical timeseries.

EndpointMethodDescription
/metrics/v2/assetsGETList assets with market metrics
/metrics/v2/assets/{assetId}GETDetailed metrics for a specific asset
/metrics/v2/assets/{assetId}/roiGETROI data for an asset
/metrics/v2/assets/{assetId}/athGETAll-time high data for an asset
/metrics/v2/assets/{assetId}/timeseriesGETHistorical metric timeseries

Query parameters:

  • assetSlugs — comma-separated slugs (e.g., bitcoin,ethereum)
  • assetIds — comma-separated asset IDs
  • metrics — specific metrics to return
  • start, end — date range (ISO 8601)
  • interval — timeseries interval (1d, 1w)
  • limit, page — pagination
bash
curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \
  -H "x-messari-api-key: $MESSARI_API_KEY"

Signal Service

Real-time social intelligence — sentiment scoring, mindshare tracking, trending narratives.

Route questions about market sentiment, social buzz, what's trending, mindshare gainers/losers here.

EndpointMethodDescription
/signal/v1/assetsGETList assets with signal metrics
/signal/v1/assets/{assetId}GETSignal metrics for a specific asset
/signal/v1/assets/{assetId}/timeseriesGETHistorical signal timeseries
/signal/v1/assets/gainers-losersGETTop mindshare gainers and losers

Query parameters:

  • type — signal type (e.g., mindshare)
  • limit — number of results
  • start, end — date range (ISO 8601)
bash
curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limit=10" \
  -H "x-messari-api-key: $MESSARI_API_KEY"

News Service

Real-time crypto news aggregation — breaking events, project updates, regulatory developments.

Route questions about recent headlines, current events, or "what happened with X" here.

EndpointMethodDescription
/news/v1/news/feedGETAggregated crypto news feed
/news/v1/news/sourcesGETList available news sources

Query parameters:

  • assetSlugs — filter news by asset
  • sourceIds — filter by news source
  • limit, page — pagination
bash
curl "https://api.messari.io/news/v1/news/feed?limit=20" \
  -H "x-messari-api-key: $MESSARI_API_KEY"

Research Service

Institutional-grade reports — sector deep dives, protocol diligence, quarterly reviews, governance analysis.

Route questions about fundamental research, due diligence, analyst opinions, and sector analysis here.

EndpointMethodDescription
/research/v1/reportsGETList research reports
/research/v1/reports/{reportId}GETGet a specific report
/research/v1/reports/tagsGETList available report tags

Query parameters:

  • tags — filter by report tags
  • assetSlugs — filter by related assets
  • limit, page — pagination

Stablecoins Service

On-chain metrics, historical timeseries, and per-chain breakdowns for 25+ stablecoins.

Route stablecoin-specific questions here — supply, flows, chain-level breakdowns, market share.

EndpointMethodDescription
/stablecoins/v2/stablecoinsGETList stablecoins with metrics
/stablecoins/v2/stablecoins/{stablecoinId}GETDetailed metrics for a stablecoin
/stablecoins/v2/stablecoins/{stablecoinId}/timeseriesGETHistorical timeseries

Query parameters:

  • metrics — specific stablecoin metrics
  • chains — filter by blockchain
  • start, end — date range (ISO 8601)
  • interval — timeseries interval
  • limit, page — pagination

Exchanges Service

Exchange-level volume, metrics, and historical timeseries across 210+ exchanges.

Route questions about exchange volumes, comparisons, or exchange-specific data here.

EndpointMethodDescription
/exchanges/v2/exchangesGETList exchanges with metrics
/exchanges/v2/exchanges/{exchangeId}GETDetailed metrics for an exchange
/exchanges/v2/exchanges/{exchangeId}/timeseriesGETHistorical timeseries

Query parameters:

  • exchangeSlugs — comma-separated exchange slugs
  • metrics — specific exchange metrics
  • start, end — date range (ISO 8601)
  • interval — timeseries interval
  • limit, page — pagination

Networks Service

L1/L2 blockchain network metrics — chain-level activity, fees, active addresses.

Route questions about blockchain networks, chain comparisons, or on-chain metrics here.

EndpointMethodDescription
/networks/v2/networksGETList networks with metrics
/networks/v2/networks/{networkId}GETDetailed metrics for a network
/networks/v2/networks/{networkId}/timeseriesGETHistorical timeseries

Query parameters:

  • networkSlugs — comma-separated network slugs
  • metrics — specific network metrics
  • start, end — date range (ISO 8601)
  • interval — timeseries interval
  • limit, page — pagination

Protocols Service

DeFi protocol metrics across DEXs, lending, liquid staking, and bridges.

Route DeFi-specific questions here — TVL, protocol comparisons, category-specific data.

EndpointMethodDescription
/protocols/v2/protocolsGETList protocols with metrics
/protocols/v2/protocols/{protocolId}GETDetailed metrics for a protocol
/protocols/v2/protocols/dexGETDEX-specific metrics
/protocols/v2/protocols/lendingGETLending protocol metrics
/protocols/v2/protocols/interopGETBridge/interoperability metrics
/protocols/v2/protocols/liquid-stakingGETLiquid staking metrics

Query parameters:

  • protocolSlugs — comma-separated protocol slugs
  • metrics — specific protocol metrics
  • limit, page — pagination

Token Unlocks Service

Vesting schedules, upcoming unlock events, and supply pressure analysis.

Route questions about token unlocks, vesting, or upcoming supply events here.

EndpointMethodDescription
/token-unlocks/v1/assetsGETList assets with unlock data
/token-unlocks/v1/assets/{assetId}GETUnlock details for an asset
/token-unlocks/v1/assets/{assetId}/eventsGETUpcoming unlock events
/token-unlocks/v1/assets/{assetId}/vestingGETFull vesting schedule

Query parameters:

  • assetSlugs — comma-separated asset slugs
  • start, end — date range (ISO 8601)
  • limit, page — pagination

Fundraising Service

Funding rounds, investors, funds, organizations, projects, and M&A activity.

Route questions about who invested in what, fundraising rounds, investor activity, or M&A here.

EndpointMethodDescription
/fundraising/v1/roundsGETList fundraising rounds
/fundraising/v1/organizationsGETList organizations
/fundraising/v1/projectsGETList projects that raised funding
/fundraising/v1/investorsGETList investors and activity
/fundraising/v1/fundsGETList investment funds
/fundraising/v1/mergers-acquisitionsGETList M&A transactions

Query parameters:

  • assetSlugs — filter by related asset
  • investorSlugs — filter by investor
  • roundTypes — filter by round type (seed, series-a)
  • start, end — date range (ISO 8601)
  • limit, page — pagination

Intel Service

Governance events, protocol upgrades, and key project milestones.

Route questions about governance proposals, protocol upgrades, or project events here.

EndpointMethodDescription
/intel/v1/eventsGETList intel events
/intel/v1/events/{eventId}GETDetails for a specific event
/intel/v1/assetsGETList assets with intel data

Query parameters:

  • assetSlugs — filter by asset
  • eventTypes — filter by event type
  • start, end — date range (ISO 8601)
  • limit, page — pagination

Topics Service

Trending topic classification and daily timeseries.

Route questions about trending narratives or topic momentum here.

EndpointMethodDescription
/topics/v1/classesGETList topic classes/categories
/topics/v1/currentGETCurrently trending topics
/topics/v1/timeseriesGETDaily topic trend timeseries

Query parameters:

  • classIds — filter by topic class
  • start, end — date range (ISO 8601)
  • limit — number of results

X-Users Service

Crypto X/Twitter user metrics and influence tracking.

Route questions about crypto influencers, social account metrics, or X/Twitter activity here.

EndpointMethodDescription
/signal/v1/x-usersGETList crypto X users with metrics
/signal/v1/x-users/{userId}GETMetrics for a specific X user
/signal/v1/x-users/{userId}/timeseriesGETHistorical metrics for an X user

Query parameters:

  • limit, page — pagination
  • start, end — date range (ISO 8601)

Routing Guide

Use this logic to pick the right service for a query:

User is asking about...Route to
General crypto question, synthesis, "what do you think about X"AI
Price, volume, market cap, ROI, ATH, performance comparisonMetrics
Sentiment, mindshare, trending tokens, social buzzSignal
Headlines, recent events, breaking newsNews
Analyst reports, deep dives, sector overviewsResearch
Stablecoin supply, flows, chain breakdownsStablecoins
Exchange volumes, exchange comparisonsExchanges
L1/L2 network activity, fees, active addressesNetworks
DeFi protocols, TVL, lending, DEX volumeProtocols
Token unlocks, vesting schedulesToken Unlocks
Fundraising rounds, investors, VC activity, M&AFundraising
Governance events, protocol upgradesIntel
Trending narratives, topic momentumTopics
Crypto influencers, X/Twitter accountsX-Users

Multi-service queries

Many questions benefit from combining services. Examples:

  • "Is SOL overvalued?" → Metrics (price, fundamentals) + Signal (sentiment) + Token Unlocks (supply pressure) + AI (synthesize)
  • "Due diligence on Eigen Layer" → Research (reports) + Metrics (fundamentals) + Fundraising (investors) + Intel (governance) + AI (synthesize)
  • "What are the trending narratives this week?" → Topics (trending classes) + Signal (mindshare gainers) + News (related headlines)
  • "Compare TVL across lending protocols" → Protocols/lending (metrics) + Networks (chain context)

When in doubt, start with the AI service — it draws from all other sources and provides the broadest context.


Example Questions

code
"Which assets over $1B marketcap outperformed Bitcoin over the last 3 months?"
"What are some upcoming token unlock events this month?"
"Give me the 10 most recent fundraising rounds in the AI and compute sectors."
"What are the latest headlines related to crypto regulation?"
"What are some recent developments in the DePin sector?"
"Which investor has been the most active in seed rounds over the last year?"
"What were the top events for the AAVE protocol during the last quarter?"
"Give me the latest ecosystem map of Solana."
"Tell me about the recent investments from a16z crypto."
"Compare and contrast the native asset functions of BitTensor vs Render."