Messari
Scanned@jds950
npx machina-cli add skill @jds950/messari-crypto --openclawMessari Crypto Intel
Real-time crypto market intelligence via Messari's REST API — AI-powered analysis, on-chain metrics, sentiment, news, and institutional-grade research without building data pipelines.
Prerequisites
- Messari API Key — get one at messari.io/api
- Messari AI Credits — required for AI completion endpoints
REST API Overview
Base URL: https://api.messari.io
Authentication: Include your API key in every request:
x-messari-api-key: <YOUR_API_KEY>
All endpoints accept and return JSON. Use Content-Type: application/json for POST requests.
Service Routing Table
| Service | Base Path | Use When |
|---|---|---|
| AI | /ai/ | General crypto questions, synthesis across data sources |
| Signal | /signal/v1/ | Sentiment, mindshare, trending narratives |
| Metrics | /metrics/v2/ | Price, volume, market cap, fundamentals |
| News | /news/v1/ | Real-time crypto news, breaking events |
| Research | /research/v1/ | Institutional reports, protocol deep dives |
| Stablecoins | /stablecoins/v2/ | Stablecoin supply, per-chain breakdowns |
| Exchanges | /exchanges/v2/ | Exchange volume, metrics, timeseries |
| Networks | /networks/v2/ | L1/L2 network metrics, timeseries |
| Protocols | /protocols/v2/ | DeFi protocol metrics (DEX, lending, staking) |
| Token Unlocks | /token-unlocks/v1/ | Vesting schedules, unlock events |
| Fundraising | /fundraising/v1/ | Funding rounds, investors, M&A |
| Intel | /intel/v1/ | Governance events, protocol updates |
| Topics | /topics/v1/ | Trending topic classes, daily timeseries |
| X-Users | /signal/v1/x-users/ | Crypto X/Twitter user metrics |
For detailed endpoint documentation, see references/api_services.md.
Example Requests
AI Chat Completion
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?"}
]
}'
Asset Metrics Lookup
curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \
-H "x-messari-api-key: $MESSARI_API_KEY"
Signal Mindshare Gainers
curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limit=10" \
-H "x-messari-api-key: $MESSARI_API_KEY"
News Feed
curl "https://api.messari.io/news/v1/news/feed?limit=20" \
-H "x-messari-api-key: $MESSARI_API_KEY"
Routing Guidance
General crypto questions
Route through AI first — broadest context, synthesizes across market data, research, news, social.
Quantitative questions
Use Metrics for price/volume/fundamentals. Exchanges for exchange-level data. Networks for L1/L2 metrics. Protocols for DeFi-specific data.
Sentiment and narratives
Signal for mindshare and sentiment. Topics for trending narrative classes. X-Users for influencer-level metrics.
Specific asset classes
Stablecoins for stablecoin supply and flows. Token Unlocks for vesting schedules and upcoming unlocks.
Research, news, and events
Research for deep dives and reports. News for real-time events. Intel for governance and protocol updates. Fundraising for funding rounds and M&A.
Multi-service queries
Combine services for richer answers. Example — "Is SOL overvalued?":
- Metrics → current price, volume, fundamentals
- Signal → sentiment and mindshare trend
- Token Unlocks → upcoming supply pressure
- AI → synthesize a view from all data
Overview
Messari Crypto Intel delivers real-time market intelligence via Messari's REST API, combining AI-powered analysis, sentiment signals, comprehensive metrics, news, and institutional research. It spans 34,000+ assets across 210+ exchanges and data domains such as Token Unlocks, Fundraising, Intel, Topics, and X-Users, enabling data-backed crypto questions. Requires a Messari API key and Messari AI credits.
How This Skill Works
Authenticate with the x-messari-api-key header and route queries to the appropriate service endpoints (AI, Signal, Metrics, News, Research, Stablecoins, Exchanges, Networks, Protocols, Token Unlocks, Fundraising, Intel, Topics, X-Users). Endpoints return JSON data suitable for dashboards, analyses, and reports, enabling cross-source crypto insights in real time.
When to Use It
- Need real-time market intelligence across assets and exchanges.
- Analyze token fundamentals, prices, and on-chain metrics.
- Gauge sentiment, mindshare, and trending narratives.
- Track token unlocks, fundraising rounds, or governance events.
- Fetch stablecoin flows, news, or institutional research.
Quick Start
- Step 1: Create a Messari API key and ensure you have Messari AI credits.
- Step 2: Make a request to the appropriate endpoint (e.g., /metrics/v2/assets?assetSlugs=bitcoin,ethereum) with header x-messari-api-key.
- Step 3: Parse the JSON response and feed it into your dashboards, alerts, or reports.
Best Practices
- Securely store and rotate your Messari API key; ensure you have sufficient AI credits.
- Route queries to the right service: AI for synthesis, Metrics for prices, Signal for sentiment, Protocols for DeFi metrics.
- Combine data from multiple endpoints for cross-source analysis.
- Cache frequent queries and respect rate limits to avoid throttling.
- Validate asset slugs and parameters (e.g., assetSlugs, limit) before requests.
Example Use Cases
- Retrieve price, volume, and fundamentals for bitcoin and ethereum via Metrics.
- Pull sentiment and mindshare for top assets using Signal.
- Deep-dive into a DeFi protocol with Protocols metrics and News.
- Check token unlock schedules for a major ICO with Token Unlocks.
- Monitor governance events and fundraising activity in Intel and Fundraising.
