From 0c3e109f8c98f0eb41dac787aecd29d75c28c284 Mon Sep 17 00:00:00 2001 From: Ryan Sanna Date: Mon, 9 Mar 2026 12:47:38 -0700 Subject: [PATCH 1/3] add deep research, AI v2, bulk data, markets, and new sub-endpoints to skill docs --- SKILL.md | 65 +++++++++++++ openclaw-skill/messari-crypto/SKILL.md | 23 +++++ .../messari-crypto/references/api_services.md | 91 +++++++++++++++++++ 3 files changed, 179 insertions(+) diff --git a/SKILL.md b/SKILL.md index 0ff6d9b..440cf42 100644 --- a/SKILL.md +++ b/SKILL.md @@ -44,10 +44,16 @@ Requires Messari AI credits. |---|---|---| | `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | | `/ai/openai/chat/completions` | POST | OpenAI-compatible chat completion endpoint | +| `/ai/v2/chat/completions` | POST | v2 chat completion with inline citations, related questions, and verbosity control | +| `/ai/v1/questions/trending` | GET | Suggested questions based on trending crypto topics | **POST body:** - `messages` — array of `{role, content}` message objects - `stream` — boolean, enable streaming responses +- `verbosity` — `succinct`, `balanced`, or `verbose` (v2 only) +- `inline_citations` — boolean, include citation references in metadata (v2 only) +- `generate_related_questions` — integer, number of follow-up suggestions (v2 only) +- `response_format` — `markdown` or `plaintext` (v2 only) ```bash curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ @@ -56,6 +62,32 @@ curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ -d '{"messages": [{"role": "user", "content": "What is the bull case for ETH right now?"}]}' ``` +**Deep Research** — Generate comprehensive long-form research reports asynchronously (5-10 minutes). Reports include markdown content with cited sources. Costs 500 credits per report; Enterprise teams receive 10 free/month. + +| Endpoint | Method | Description | +|---|---|---| +| `/ai/v1/deep-research` | POST | Create a new deep research job | +| `/ai/v1/deep-research` | GET | List your deep research jobs | +| `/ai/v1/deep-research/{id}` | GET | Get job status; includes report when completed | +| `/ai/v1/deep-research/{id}/cancel` | POST | Cancel a queued or in-progress job | + +**POST body (Create):** +- `query` — research topic or question (required) +- `instructions` — optional system instructions to guide research style +- `job_id` — optional, pass existing job ID for follow-up refinement + +**Query parameters (List):** +- `limit` — max results (default 20, max 100) +- `offset` — pagination offset +- `status` — filter by: `queued`, `in_progress`, `completed`, `failed`, `cancelled` + +```bash +curl -X POST "https://api.messari.io/ai/v1/deep-research" \ + -H "x-messari-api-key: $MESSARI_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{"query": "What is the current state of liquid staking on Ethereum?"}' +``` + --- ### Metrics Service @@ -71,6 +103,9 @@ Route quantitative and comparative questions here — price lookups, performance | `/metrics/v2/assets/{assetId}/roi` | GET | ROI data for an asset | | `/metrics/v2/assets/{assetId}/ath` | GET | All-time high data for an asset | | `/metrics/v2/assets/{assetId}/timeseries` | GET | Historical metric timeseries | +| `/metrics/v1/markets` | GET | List trading pairs/markets across exchanges | +| `/metrics/v1/markets/{marketIdentifier}` | GET | Get a specific trading pair/market | +| `/metrics/v1/markets/metrics` | GET | List available market timeseries metrics | **Query parameters:** - `assetSlugs` — comma-separated slugs (e.g., `bitcoin,ethereum`) @@ -99,6 +134,10 @@ Route questions about market sentiment, social buzz, what's trending, mindshare | `/signal/v1/assets/{assetId}` | GET | Signal metrics for a specific asset | | `/signal/v1/assets/{assetId}/timeseries` | GET | Historical signal timeseries | | `/signal/v1/assets/gainers-losers` | GET | Top mindshare gainers and losers | +| `/signal/v1/assets/mindshare-gainers-24h` | GET | Assets with biggest mindshare gains (24h) | +| `/signal/v1/assets/mindshare-gainers-7d` | GET | Assets with biggest mindshare gains (7d) | +| `/signal/v1/assets/mindshare-losers-24h` | GET | Assets with biggest mindshare losses (24h) | +| `/signal/v1/assets/mindshare-losers-7d` | GET | Assets with biggest mindshare losses (7d) | **Query parameters:** - `type` — signal type (e.g., `mindshare`) @@ -251,6 +290,8 @@ Route questions about token unlocks, vesting, or upcoming supply events here. | `/token-unlocks/v1/assets/{assetId}` | GET | Unlock details for an asset | | `/token-unlocks/v1/assets/{assetId}/events` | GET | Upcoming unlock events | | `/token-unlocks/v1/assets/{assetId}/vesting` | GET | Full vesting schedule | +| `/token-unlocks/v1/allocations` | GET | Get token allocation data across assets | +| `/token-unlocks/v1/assets/{assetId}/unlocks` | GET | Interval-based unlock timeseries data | **Query parameters:** - `assetSlugs` — comma-separated asset slugs @@ -273,6 +314,8 @@ Route questions about who invested in what, fundraising rounds, investor activit | `/fundraising/v1/investors` | GET | List investors and activity | | `/fundraising/v1/funds` | GET | List investment funds | | `/fundraising/v1/mergers-acquisitions` | GET | List M&A transactions | +| `/fundraising/v1/rounds/investors` | GET | Investors that participated in filtered rounds | +| `/fundraising/v1/funds/managers` | GET | Managers of filtered funds | **Query parameters:** - `assetSlugs` — filter by related asset @@ -338,6 +381,22 @@ Route questions about crypto influencers, social account metrics, or X/Twitter a - `limit`, `page` — pagination - `start`, `end` — date range (ISO 8601) +### Bulk Data Service + +High-performance bulk data download in CSV or JSONL format. Designed for data scientists, analysts, and researchers needing large historical datasets. + +Route bulk download, historical data export, CSV/JSONL dataset requests here. + +| Endpoint | Method | Description | +|---|---|---| +| `/bulk/v1/datasets` | GET | List available bulk datasets for your subscription tier | +| `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset in CSV or JSONL format | + +**Query parameters:** +- `format` — `csv` or `jsonl` +- `start`, `end` — date range (ISO 8601) +- Granularities: `5m`, `15m`, `30m`, `1h`, `1d` + --- ## Routing Guide @@ -360,6 +419,9 @@ Use this logic to pick the right service for a query: | Governance events, protocol upgrades | **Intel** | | Trending narratives, topic momentum | **Topics** | | Crypto influencers, X/Twitter accounts | **X-Users** | +| In-depth research report, comprehensive analysis on a crypto topic | **Deep Research** (under AI) | +| Bulk data download, large historical datasets, CSV/JSONL export | **Bulk Data** | +| Trading pair data, market-specific price and volume | **Markets** (under Metrics) | ### Multi-service queries @@ -387,4 +449,7 @@ When in doubt, start with the **AI** service — it draws from all other sources "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." +"Generate a deep research report on the current state of liquid staking." +"What are the trending questions in crypto right now?" +"Download bulk historical price data for Ethereum over the last year." ``` diff --git a/openclaw-skill/messari-crypto/SKILL.md b/openclaw-skill/messari-crypto/SKILL.md index 924bf37..51f6a88 100644 --- a/openclaw-skill/messari-crypto/SKILL.md +++ b/openclaw-skill/messari-crypto/SKILL.md @@ -52,8 +52,13 @@ All endpoints accept and return JSON. Use `Content-Type: application/json` for P | Service | Base Path | Use When | |---|---|---| | **AI** | `/ai/` | General crypto questions, synthesis across data sources | +| **AI (v2)** | `/ai/v2/` | Enhanced chat with citations, verbosity control, related questions | +| **Deep Research** | `/ai/v1/deep-research` | In-depth async research reports (500 credits, 5-10 min) | +| **Trending Questions** | `/ai/v1/questions/` | Trending crypto questions asked by the community | +| **Bulk Data** | `/bulk/v1/` | Large-scale dataset downloads (CSV/JSONL) for quant workflows | | **Signal** | `/signal/v1/` | Sentiment, mindshare, trending narratives | | **Metrics** | `/metrics/v2/` | Price, volume, market cap, fundamentals | +| **Markets** | `/metrics/v1/markets` | Exchange-level market pair data and metrics | | **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 | @@ -83,6 +88,20 @@ curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ }' ``` +### Deep Research Report + +```bash +# Start a deep research job (async — takes 5-10 minutes) +curl -X POST "https://api.messari.io/ai/v1/deep-research" \ + -H "x-messari-api-key: $MESSARI_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{"query": "What are the key risks and opportunities for Ethereum in 2025?"}' + +# Poll for the result +curl "https://api.messari.io/ai/v1/deep-research/{id}" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + ### Asset Metrics Lookup ```bash @@ -117,9 +136,11 @@ Use **Metrics** for price/volume/fundamentals. **Exchanges** for exchange-level ### Specific asset classes **Stablecoins** for stablecoin supply and flows. **Token Unlocks** for vesting schedules and upcoming unlocks. +**Bulk Data** for large-scale CSV/JSONL dataset downloads. ### 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. +**Deep Research** for long-form, sourced research reports on any crypto topic (async, 5-10 min). ### Multi-service queries Combine services for richer answers. Example — "Is SOL overvalued?": @@ -127,3 +148,5 @@ Combine services for richer answers. Example — "Is SOL overvalued?": 2. **Signal** → sentiment and mindshare trend 3. **Token Unlocks** → upcoming supply pressure 4. **AI** → synthesize a view from all data +5. **Deep Research** → commission a full research report with citations +6. **Bulk Data** → download large datasets for offline analysis diff --git a/openclaw-skill/messari-crypto/references/api_services.md b/openclaw-skill/messari-crypto/references/api_services.md index 0005bd4..2644f4f 100644 --- a/openclaw-skill/messari-crypto/references/api_services.md +++ b/openclaw-skill/messari-crypto/references/api_services.md @@ -23,13 +23,54 @@ protocol comparisons, narrative summaries. |---|---|---| | `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | | `/ai/openai/chat/completions` | POST | OpenAI-compatible chat completion endpoint | +| `/ai/v2/chat/completions` | POST | Enhanced chat with citations, verbosity control, related questions | +| `/ai/v1/questions/trending` | GET | Trending crypto questions asked by the community | **Key parameters (POST body):** - `messages` — array of `{role, content}` message objects - `stream` — boolean, enable streaming responses +**Additional v2 parameters (POST body):** +- `verbosity` — `"succinct"`, `"balanced"`, or `"verbose"` (controls response length) +- `inline_citations` — boolean, embed source citations inline +- `generate_related_questions` — boolean, return follow-up question suggestions +- `response_format` — `"markdown"` or `"plaintext"` +- `allow_clarification_query` — boolean, allow the model to ask clarifying questions + +**Trending questions parameters (GET):** +- `limit` — number of trending questions to return (default: 5) + --- +## Deep Research Service + +Async long-form research reports powered by Messari AI. Each report costs 500 AI credits and takes 5-10 minutes. + +**Use for:** in-depth research reports with citations on any crypto topic — protocol deep dives, market theses, risk analysis. + +| Endpoint | Method | Description | +|---|---|---| +| `/ai/v1/deep-research` | POST | Start a new deep research job | +| `/ai/v1/deep-research` | GET | List your deep research jobs | +| `/ai/v1/deep-research/{id}` | GET | Get status and results of a research job | +| `/ai/v1/deep-research/{id}/cancel` | POST | Cancel a running research job | + +**POST body parameters:** +- `query` — (required) the research question +- `instructions` — (optional) additional context or constraints for the report +- `job_id` — (optional) existing job ID for follow-up research + +**GET list parameters:** +- `limit` — number of jobs to return +- `offset` — pagination offset +- `status` — filter by job status (`queued`, `in_progress`, `completed`, `failed`, `cancelled`) + +**Job statuses:** `queued` → `in_progress` → `completed` | `failed` | `cancelled` + +**Response (completed job):** +- `output.report` — full report in markdown +- `output.sources` — list of cited sources + ## Signal Service Real-time social intelligence and narrative tracking. @@ -42,6 +83,10 @@ Real-time social intelligence and narrative tracking. | `/signal/v1/assets/{assetId}` | GET | Signal metrics for a specific asset | | `/signal/v1/assets/{assetId}/timeseries` | GET | Historical signal timeseries for an asset | | `/signal/v1/assets/gainers-losers` | GET | Top mindshare gainers and losers | +| `/signal/v1/assets/mindshare-gainers-24h` | GET | Top mindshare gainers over 24 hours | +| `/signal/v1/assets/mindshare-gainers-7d` | GET | Top mindshare gainers over 7 days | +| `/signal/v1/assets/mindshare-losers-24h` | GET | Top mindshare losers over 24 hours | +| `/signal/v1/assets/mindshare-losers-7d` | GET | Top mindshare losers over 7 days | **Key query parameters:** - `type` — signal type (e.g., `mindshare`) @@ -65,6 +110,9 @@ Comprehensive quantitative data across the crypto market. | `/metrics/v2/assets/{assetId}/roi` | GET | ROI data for an asset | | `/metrics/v2/assets/{assetId}/ath` | GET | All-time high data for an asset | | `/metrics/v2/assets/{assetId}/timeseries` | GET | Historical metric timeseries for an asset | +| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | +| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | +| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | **Key query parameters:** - `assetSlugs` — comma-separated asset slugs (e.g., `bitcoin,ethereum`) @@ -212,6 +260,8 @@ Token vesting schedules and unlock events. | `/token-unlocks/v1/assets/{assetId}` | GET | Token unlock details for an asset | | `/token-unlocks/v1/assets/{assetId}/events` | GET | Upcoming unlock events for an asset | | `/token-unlocks/v1/assets/{assetId}/vesting` | GET | Full vesting schedule for an asset | +| `/token-unlocks/v1/allocations` | GET | Token allocation breakdowns across categories | +| `/token-unlocks/v1/assets/{assetId}/unlocks` | GET | Specific unlock events for an asset | **Key query parameters:** - `assetSlugs` — comma-separated asset slugs @@ -234,6 +284,8 @@ Crypto fundraising data including rounds, investors, and M&A activity. | `/fundraising/v1/investors` | GET | List investors and their activity | | `/fundraising/v1/funds` | GET | List investment funds | | `/fundraising/v1/mergers-acquisitions` | GET | List M&A transactions | +| `/fundraising/v1/rounds/investors` | GET | List investors participating in specific rounds | +| `/fundraising/v1/funds/managers` | GET | List fund managers and their portfolios | **Key query parameters:** - `assetSlugs` — filter by related asset @@ -298,3 +350,42 @@ Crypto X/Twitter user metrics and influence tracking. **Key query parameters:** - `limit`, `page` — pagination - `start`, `end` — date range for timeseries (ISO 8601) + +--- + +## Bulk Data Service + +Large-scale dataset downloads for quantitative analysis. + +**Use for:** downloading full historical datasets in CSV or JSONL format — useful for backtesting, data science, and quant workflows. + +**Requires:** appropriate subscription tier for the dataset. + +| Endpoint | Method | Description | +|---|---|---| +| `/bulk/v1/datasets` | GET | List available datasets for your subscription tier | +| `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset at specified granularity | + +**Key query parameters:** +- `datasetSlug` — dataset identifier +- `granularity` — time granularity: `5m`, `15m`, `30m`, `1h`, `1d` +- Output format: CSV or JSONL depending on Accept header + +--- + +## Markets Service + +Exchange-level market pair data and metrics. + +**Use for:** market-pair-level analysis, exchange trading pair volumes, spread data. + +| Endpoint | Method | Description | +|---|---|---| +| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | +| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | +| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | + +**Key query parameters:** +- `marketIdentifier` — market pair ID (e.g., exchange-specific pair identifier) +- `metrics` — specific market metrics to return +- `limit`, `page` — pagination From 020c49b26723b4621b76c95ea4a91d8eebf7411d Mon Sep 17 00:00:00 2001 From: Ryan Sanna Date: Mon, 9 Mar 2026 13:31:29 -0700 Subject: [PATCH 2/3] refactor structure, add progressive disclosure, add frontmatter --- README.md | 107 +++-- claude/messari-api/SKILL.md | 121 ++++++ .../messari-api/references/endpoints.md | 241 ++++------- openclaw-skill/README.md | 121 ------ openclaw-skill/messari-crypto/SKILL.md | 152 ------- .../messari-crypto/references/api_services.md | 391 ----------------- openclaw/messari-api/SKILL.md | 133 ++++++ openclaw/messari-api/references/endpoints.md | 394 ++++++++++++++++++ 8 files changed, 791 insertions(+), 869 deletions(-) create mode 100644 claude/messari-api/SKILL.md rename SKILL.md => claude/messari-api/references/endpoints.md (58%) delete mode 100644 openclaw-skill/README.md delete mode 100644 openclaw-skill/messari-crypto/SKILL.md delete mode 100644 openclaw-skill/messari-crypto/references/api_services.md create mode 100644 openclaw/messari-api/SKILL.md create mode 100644 openclaw/messari-api/references/endpoints.md diff --git a/README.md b/README.md index 300e18a..8b7aee7 100644 --- a/README.md +++ b/README.md @@ -1,50 +1,24 @@ # Messari Agent Skills -Crypto intelligence for AI agents — MCP, REST API, and agent-native skill files for [Messari](https://messari.io). +This repository contains [Claude](https://claude.ai) and [OpenClaw](https://openclaw.ai) skill files that wrap the full [Messari REST API](https://docs.messari.io) — giving AI agents access to crypto market data, on-chain metrics, sentiment, news, research, and more across 34,000+ assets. -## For AI Agents +For AI-powered answers that synthesize across Messari's entire data warehouse, use the [Messari MCP Server](https://docs.messari.io/mcp-server/hosted). -Point your agent at [`SKILL.md`](./SKILL.md) for self-contained integration instructions — all endpoints, authentication, routing logic, and examples in one file. +## Getting Started -**Raw URL:** `https://raw.githubusercontent.com/messari/skills/master/SKILL.md` +### 1. Get an API key -## What's Here - -### [Messari Hosted MCP Server](https://docs.messari.io/mcp-server/hosted) - -Messari's hosted MCP server. Gives any MCP-compatible AI client direct access to Messari's data stack: - -- **MessariAI** — Integrate with MessariAI to unlock all of our AI capabilities -- **Asset & Market Data** — Market data such as price, trading volume and marketcap for over 40,000 assets -- **Signals** — Track social data and narratives including mindshare and sentiment across individual crypto projects, or at the sector/sub-sector level -- **News** — Aggregated news from 500+ sources including headlines, links and summaries, with assets tagged per article -- **Research** — Access to Messari's Protocol Reporting Research -- **Stablecoins** — Onchain data for 30+ stablecoins such as USDT, USDC and DAI, including stablecoin marketcap, active addresses, transfers, transaction volume and more -- **Networks** — Onchain data for 25+ Layer-1s and Layer-2s such as Ethereum and Solana, including transaction fees, active addresses, and more -- **Protocols** — Onchain data for 200+ protocols such as Uniswap and Aave, including Total Value Locked, active addresses, deposits/borrows, trading volume, and more -- **Exchanges** — Spot volumes, futures volume and futures open interest across cryptocurrency exchanges -- **Token Unlocks** — Monitor token vesting schedules, upcoming unlock events, and token allocation details for over 200 crypto projects -- **Fundraising** — Crypto's biggest fundraising database for funding rounds, M&A deals, and investors -- **Intel** — Real-time onchain and offchain event monitoring with human curated summaries -- **Topics** — Topic-based content aggregation and trending narrative tracking - -Full documentation: **[docs.messari.io/mcp-server/hosted](https://docs.messari.io/mcp-server/hosted)** - -### [`openclaw-skill/`](./openclaw-skill/) - -An [OpenClaw](https://openclaw.ai) / [ClawHub](https://clawhub.ai) skill that wraps Messari's REST API directly. OpenClaw does not natively support MCP, so this skill provides endpoint routing, authentication, and API reference documentation for standard HTTP requests. - -## Quick Start +Sign up at [messari.io](https://messari.io) and get an [API key](https://messari.io/api). -### 1. Get a Messari account +### 2. Choose your integration -Sign up at [messari.io](https://messari.io) and get an [API key](https://messari.io/api). +#### MCP Server (Recommended for AI-powered answers) -### 2. Set up your client +The Messari MCP Server connects any MCP-compatible client to Messari's data stack, including MessariAI for synthesized, citation-backed responses. -#### Claude / Claude Code +**Server URL:** `https://mcp.messari.io/mcp` -Run from your terminal: +**Claude / Claude Code:** ```bash claude mcp add --transport http --scope user messari https://mcp.messari.io/mcp @@ -62,7 +36,7 @@ Or add to your project's `.mcp.json`: } ``` -#### Codex +**Codex:** Add to `~/.codex/config.toml`: @@ -71,9 +45,9 @@ Add to `~/.codex/config.toml`: url = "https://mcp.messari.io/mcp" ``` -#### Cursor +**Cursor:** -Add to `.cursor/mcp.json` (project-level) or `~/.cursor/mcp.json` (global): +Add to `.cursor/mcp.json` or `~/.cursor/mcp.json`: ```json { @@ -85,15 +59,47 @@ Add to `.cursor/mcp.json` (project-level) or `~/.cursor/mcp.json` (global): } ``` -#### OpenClaw +Full MCP documentation: [docs.messari.io/mcp-server/hosted](https://docs.messari.io/mcp-server/hosted) -OpenClaw does not support MCP. Install the skill instead: +#### Skills (Direct REST API access) + +These skills teach your agent to call Messari's REST API directly — useful when your client doesn't support MCP, or when you want full control over which endpoints are called. + +**Claude / Claude Code:** + +Point your agent at the skill file: + +`https://raw.githubusercontent.com/messari/skills/main/claude/messari-api/SKILL.md` + +Or see [`claude/messari-api/`](./claude/messari-api/) for the full skill directory. + +**OpenClaw / ClawHub:** ```bash -clawhub install messari/messari-crypto +clawhub install messari/messari-api ``` -The skill calls `https://api.messari.io` directly with the `x-messari-api-key` header. See [`openclaw-skill/`](./openclaw-skill/) for details. +Or see [`openclaw/messari-api/`](./openclaw/messari-api/) for the full skill directory. + +## API Coverage + +Both skills provide routing, authentication, and endpoint reference for these Messari API services: + +- **AI** — Chat completions and deep research reports across Messari's crypto data warehouse +- **Metrics** — Price, volume, market cap, and fundamentals for 34,000+ assets +- **Signal** — Sentiment, mindshare, and trending narrative tracking +- **News** — Real-time aggregated news from 500+ sources +- **Research** — Institutional-grade analyst reports and sector deep dives +- **Stablecoins** — On-chain metrics and per-chain breakdowns for 25+ stablecoins +- **Exchanges** — Volume and metrics across 210+ exchanges +- **Networks** — L1/L2 blockchain network activity, fees, active addresses +- **Protocols** — DeFi protocol metrics (DEXs, lending, liquid staking, bridges) +- **Token Unlocks** — Vesting schedules and upcoming unlock events +- **Fundraising** — Funding rounds, investors, funds, M&A activity +- **Intel** — Governance events, protocol upgrades, project milestones +- **Topics** — Trending topic classification and timeseries +- **X-Users** — Crypto X/Twitter user metrics and influence tracking +- **Bulk Data** — Large-scale CSV/JSONL dataset downloads ### 3. Start asking questions @@ -101,23 +107,16 @@ The skill calls `https://api.messari.io` directly with the `x-messari-api-key` h "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 is the percent change in price for Aave and Maker over the last month?" "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 is decentralized compute and why it is important to AI?" "What were the top events for the AAVE protocol during the last quarter?" -"Give me the latest ecosystem map of Solana." -"What is the average DexVolume and total fee revenue last month for Ethereum, Solana and Base?" -"Tell me about the recent investments from a16z crypto." -"What are some trends that Messari has written about recently?" -"Has the GMX protocol undergone any audits?" -"Compare and contrast the native asset functions of BitTensor vs Render." +"Compare TVL across top lending protocols." +"What are the trending crypto narratives right now?" ``` ## Links - [MCP Server Documentation](https://docs.messari.io/mcp-server/hosted) -- [Messari API](https://messari.io/api) +- [Messari API Documentation](https://docs.messari.io) +- [Messari API Key](https://messari.io/api) - [Messari](https://messari.io) -- [OpenClaw Skill on ClawHub](https://clawhub.ai/messari/messari-crypto) diff --git a/claude/messari-api/SKILL.md b/claude/messari-api/SKILL.md new file mode 100644 index 0000000..4592e4a --- /dev/null +++ b/claude/messari-api/SKILL.md @@ -0,0 +1,121 @@ +--- +name: messari-api +description: > + Queries Messari's REST API for crypto market data across 14 services: AI chat completions, + asset metrics and prices, social sentiment and mindshare, news, institutional research, + stablecoins, exchanges, L1/L2 networks, DeFi protocols, token unlocks, fundraising rounds, + governance intel, trending topics, and X/Twitter user analytics. Covers 34,000+ assets and + 210+ exchanges. Use when answering questions about crypto markets, token analysis, sentiment, + on-chain metrics, protocol data, fundraising, or any blockchain data question. +--- + +# Messari REST API + +Crypto market intelligence across 14 data services via Messari's REST API. + +## Authentication + +Every request requires the `x-messari-api-key` header. Obtain a key at [messari.io/api](https://messari.io/api). If no key is available, ask the user to provide one before making requests. + +**Base URL:** `https://api.messari.io` + +``` +x-messari-api-key: +``` + +All endpoints accept and return JSON. Use `Content-Type: application/json` for POST requests. + +## Service Routing + +| User is asking about... | Route to | Base path | +|---|---|---| +| General crypto question, synthesis, "what do you think about X" | **AI** | `/ai/` | +| In-depth research report with citations (async, 5-10 min) | **Deep Research** | `/ai/v1/deep-research` | +| Price, volume, market cap, ROI, ATH, performance comparison | **Metrics** | `/metrics/v2/` | +| Trading pair data, market-specific price and volume | **Markets** | `/metrics/v1/markets` | +| Sentiment, mindshare, trending tokens, social buzz | **Signal** | `/signal/v1/` | +| Headlines, recent events, breaking news | **News** | `/news/v1/` | +| Analyst reports, deep dives, sector overviews | **Research** | `/research/v1/` | +| Stablecoin supply, flows, chain breakdowns | **Stablecoins** | `/stablecoins/v2/` | +| Exchange volumes, exchange comparisons | **Exchanges** | `/exchanges/v2/` | +| L1/L2 network activity, fees, active addresses | **Networks** | `/networks/v2/` | +| DeFi protocols, TVL, lending, DEX volume | **Protocols** | `/protocols/v2/` | +| Token unlocks, vesting schedules | **Token Unlocks** | `/token-unlocks/v1/` | +| Fundraising rounds, investors, VC activity, M&A | **Fundraising** | `/fundraising/v1/` | +| Governance events, protocol upgrades | **Intel** | `/intel/v1/` | +| Trending narratives, topic momentum | **Topics** | `/topics/v1/` | +| Crypto influencers, X/Twitter accounts | **X-Users** | `/signal/v1/x-users/` | +| Bulk data download, large historical datasets, CSV/JSONL export | **Bulk Data** | `/bulk/v1/` | +| Trending questions the community is asking | **Trending Questions** | `/ai/v1/questions/` | + +For full endpoint details, parameters, and examples, see [references/endpoints.md](references/endpoints.md). + +## Multi-Service Queries + +Many questions benefit from combining services. Follow this workflow: + +``` +Multi-Service Query Checklist: +- [ ] Identify which services are relevant to the question +- [ ] Query each service for its piece of the answer +- [ ] If any request fails, retry once then note the gap +- [ ] Synthesize results into a unified answer +- [ ] Optionally route through AI service for final synthesis +``` + +**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) +- **"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. + +## Common Parameters + +Most GET endpoints share these query parameters: + +- `limit`, `page` — pagination +- `start`, `end` — date range (ISO 8601) +- Asset filters: `assetSlugs` (comma-separated slugs like `bitcoin,ethereum`) or `assetIds` +- `metrics` — specific metrics to return +- `interval` — timeseries interval (`1d`, `1w`) + +## Quick Examples + +### AI Chat Completion + +```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?"}]}' +``` + +### Asset Metrics + +```bash +curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + +### Signal Mindshare Gainers + +```bash +curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limit=10" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + +### News Feed + +```bash +curl "https://api.messari.io/news/v1/news/feed?limit=20" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + +## Notes + +- The **AI** and **Deep Research** endpoints require Messari AI credits (a paid usage quota managed at [messari.io/account](https://messari.io/account)). All other endpoints work with just the API key. +- Deep Research jobs are asynchronous — submit a query, then poll for results (5-10 min). Each report costs 500 credits. +- The **Bulk Data** service requires an appropriate subscription tier for the requested dataset. diff --git a/SKILL.md b/claude/messari-api/references/endpoints.md similarity index 58% rename from SKILL.md rename to claude/messari-api/references/endpoints.md index 440cf42..056c4d8 100644 --- a/SKILL.md +++ b/claude/messari-api/references/endpoints.md @@ -1,42 +1,33 @@ -# 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](https://messari.io/api). - -### Option B: REST API (Direct HTTP) - -If your client does not support MCP, call Messari's REST API directly. +# Messari REST API — Endpoint Reference **Base URL:** `https://api.messari.io` - -**Authentication:** Include the API key in every request: - -``` -x-messari-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](https://messari.io/api). If no key is available, ask the user to provide one before making requests. +**Auth Header:** `x-messari-api-key: ` + +## Contents + +- [AI Service](#ai-service) +- [Deep Research](#deep-research) +- [Metrics Service](#metrics-service) +- [Markets Service](#markets-service) +- [Signal Service](#signal-service) +- [News Service](#news-service) +- [Research Service](#research-service) +- [Stablecoins Service](#stablecoins-service) +- [Exchanges Service](#exchanges-service) +- [Networks Service](#networks-service) +- [Protocols Service](#protocols-service) +- [Token Unlocks Service](#token-unlocks-service) +- [Fundraising Service](#fundraising-service) +- [Intel Service](#intel-service) +- [Topics Service](#topics-service) +- [X-Users Service](#x-users-service) +- [Bulk Data Service](#bulk-data-service) --- -## Services and Endpoints - -### AI Service +## 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. +Chat completions across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first. Requires Messari AI credits. @@ -44,16 +35,21 @@ Requires Messari AI credits. |---|---|---| | `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | | `/ai/openai/chat/completions` | POST | OpenAI-compatible chat completion endpoint | -| `/ai/v2/chat/completions` | POST | v2 chat completion with inline citations, related questions, and verbosity control | +| `/ai/v2/chat/completions` | POST | v2 chat completion with inline citations, verbosity control, related questions | | `/ai/v1/questions/trending` | GET | Suggested questions based on trending crypto topics | **POST body:** - `messages` — array of `{role, content}` message objects - `stream` — boolean, enable streaming responses -- `verbosity` — `succinct`, `balanced`, or `verbose` (v2 only) -- `inline_citations` — boolean, include citation references in metadata (v2 only) -- `generate_related_questions` — integer, number of follow-up suggestions (v2 only) -- `response_format` — `markdown` or `plaintext` (v2 only) + +**Additional v2 parameters:** +- `verbosity` — `succinct`, `balanced`, or `verbose` +- `inline_citations` — boolean, include citation references in metadata +- `generate_related_questions` — integer, number of follow-up suggestions +- `response_format` — `markdown` or `plaintext` + +**Trending questions parameters (GET):** +- `limit` — number of trending questions to return (default: 5) ```bash curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ @@ -62,24 +58,34 @@ curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ -d '{"messages": [{"role": "user", "content": "What is the bull case for ETH right now?"}]}' ``` -**Deep Research** — Generate comprehensive long-form research reports asynchronously (5-10 minutes). Reports include markdown content with cited sources. Costs 500 credits per report; Enterprise teams receive 10 free/month. +--- + +## Deep Research + +Asynchronous long-form research reports with citations. Each report costs 500 AI credits and takes 5-10 minutes. | Endpoint | Method | Description | |---|---|---| | `/ai/v1/deep-research` | POST | Create a new deep research job | -| `/ai/v1/deep-research` | GET | List your deep research jobs | +| `/ai/v1/deep-research` | GET | List deep research jobs | | `/ai/v1/deep-research/{id}` | GET | Get job status; includes report when completed | | `/ai/v1/deep-research/{id}/cancel` | POST | Cancel a queued or in-progress job | -**POST body (Create):** +**POST body:** - `query` — research topic or question (required) - `instructions` — optional system instructions to guide research style - `job_id` — optional, pass existing job ID for follow-up refinement -**Query parameters (List):** +**GET list parameters:** - `limit` — max results (default 20, max 100) - `offset` — pagination offset -- `status` — filter by: `queued`, `in_progress`, `completed`, `failed`, `cancelled` +- `status` — filter: `queued`, `in_progress`, `completed`, `failed`, `cancelled` + +**Job lifecycle:** `queued` → `in_progress` → `completed` | `failed` | `cancelled` + +**Completed job response includes:** +- `output.report` — full report in markdown +- `output.sources` — list of cited sources ```bash curl -X POST "https://api.messari.io/ai/v1/deep-research" \ @@ -90,11 +96,9 @@ curl -X POST "https://api.messari.io/ai/v1/deep-research" \ --- -### Metrics Service +## 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. +Price, volume, market cap, and fundamental metrics for 34,000+ assets across 210+ exchanges. | Endpoint | Method | Description | |---|---|---| @@ -103,9 +107,6 @@ Route quantitative and comparative questions here — price lookups, performance | `/metrics/v2/assets/{assetId}/roi` | GET | ROI data for an asset | | `/metrics/v2/assets/{assetId}/ath` | GET | All-time high data for an asset | | `/metrics/v2/assets/{assetId}/timeseries` | GET | Historical metric timeseries | -| `/metrics/v1/markets` | GET | List trading pairs/markets across exchanges | -| `/metrics/v1/markets/{marketIdentifier}` | GET | Get a specific trading pair/market | -| `/metrics/v1/markets/metrics` | GET | List available market timeseries metrics | **Query parameters:** - `assetSlugs` — comma-separated slugs (e.g., `bitcoin,ethereum`) @@ -122,11 +123,26 @@ curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \ --- -### Signal Service +## Markets Service -Real-time social intelligence — sentiment scoring, mindshare tracking, trending narratives. +Exchange-level trading pair data and metrics. + +| Endpoint | Method | Description | +|---|---|---| +| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | +| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | +| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | -Route questions about market sentiment, social buzz, what's trending, mindshare gainers/losers here. +**Query parameters:** +- `marketIdentifier` — market pair ID +- `metrics` — specific market metrics to return +- `limit`, `page` — pagination + +--- + +## Signal Service + +Real-time social intelligence — sentiment scoring, mindshare tracking, trending narratives. | Endpoint | Method | Description | |---|---|---| @@ -151,11 +167,9 @@ curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limi --- -### News Service - -Real-time crypto news aggregation — breaking events, project updates, regulatory developments. +## News Service -Route questions about recent headlines, current events, or "what happened with X" here. +Real-time crypto news aggregation from 500+ sources. | Endpoint | Method | Description | |---|---|---| @@ -174,11 +188,9 @@ curl "https://api.messari.io/news/v1/news/feed?limit=20" \ --- -### Research Service +## 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. +Institutional-grade reports — sector deep dives, protocol diligence, quarterly reviews. | Endpoint | Method | Description | |---|---|---| @@ -193,11 +205,9 @@ Route questions about fundamental research, due diligence, analyst opinions, and --- -### Stablecoins Service - -On-chain metrics, historical timeseries, and per-chain breakdowns for 25+ stablecoins. +## Stablecoins Service -Route stablecoin-specific questions here — supply, flows, chain-level breakdowns, market share. +On-chain metrics and per-chain breakdowns for 25+ stablecoins. | Endpoint | Method | Description | |---|---|---| @@ -214,12 +224,10 @@ Route stablecoin-specific questions here — supply, flows, chain-level breakdow --- -### Exchanges Service +## Exchanges Service Exchange-level volume, metrics, and historical timeseries across 210+ exchanges. -Route questions about exchange volumes, comparisons, or exchange-specific data here. - | Endpoint | Method | Description | |---|---|---| | `/exchanges/v2/exchanges` | GET | List exchanges with metrics | @@ -235,12 +243,10 @@ Route questions about exchange volumes, comparisons, or exchange-specific data h --- -### Networks Service +## 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. - | Endpoint | Method | Description | |---|---|---| | `/networks/v2/networks` | GET | List networks with metrics | @@ -256,12 +262,10 @@ Route questions about blockchain networks, chain comparisons, or on-chain metric --- -### Protocols Service +## Protocols Service DeFi protocol metrics across DEXs, lending, liquid staking, and bridges. -Route DeFi-specific questions here — TVL, protocol comparisons, category-specific data. - | Endpoint | Method | Description | |---|---|---| | `/protocols/v2/protocols` | GET | List protocols with metrics | @@ -278,19 +282,17 @@ Route DeFi-specific questions here — TVL, protocol comparisons, category-speci --- -### Token Unlocks Service +## Token Unlocks Service Vesting schedules, upcoming unlock events, and supply pressure analysis. -Route questions about token unlocks, vesting, or upcoming supply events here. - | Endpoint | Method | Description | |---|---|---| | `/token-unlocks/v1/assets` | GET | List assets with unlock data | | `/token-unlocks/v1/assets/{assetId}` | GET | Unlock details for an asset | | `/token-unlocks/v1/assets/{assetId}/events` | GET | Upcoming unlock events | | `/token-unlocks/v1/assets/{assetId}/vesting` | GET | Full vesting schedule | -| `/token-unlocks/v1/allocations` | GET | Get token allocation data across assets | +| `/token-unlocks/v1/allocations` | GET | Token allocation data across assets | | `/token-unlocks/v1/assets/{assetId}/unlocks` | GET | Interval-based unlock timeseries data | **Query parameters:** @@ -300,12 +302,10 @@ Route questions about token unlocks, vesting, or upcoming supply events here. --- -### Fundraising Service +## 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. - | Endpoint | Method | Description | |---|---|---| | `/fundraising/v1/rounds` | GET | List fundraising rounds | @@ -326,12 +326,10 @@ Route questions about who invested in what, fundraising rounds, investor activit --- -### Intel Service +## Intel Service Governance events, protocol upgrades, and key project milestones. -Route questions about governance proposals, protocol upgrades, or project events here. - | Endpoint | Method | Description | |---|---|---| | `/intel/v1/events` | GET | List intel events | @@ -346,12 +344,10 @@ Route questions about governance proposals, protocol upgrades, or project events --- -### Topics Service +## Topics Service Trending topic classification and daily timeseries. -Route questions about trending narratives or topic momentum here. - | Endpoint | Method | Description | |---|---|---| | `/topics/v1/classes` | GET | List topic classes/categories | @@ -365,12 +361,10 @@ Route questions about trending narratives or topic momentum here. --- -### X-Users Service +## X-Users Service Crypto X/Twitter user metrics and influence tracking. -Route questions about crypto influencers, social account metrics, or X/Twitter activity here. - | Endpoint | Method | Description | |---|---|---| | `/signal/v1/x-users` | GET | List crypto X users with metrics | @@ -381,75 +375,20 @@ Route questions about crypto influencers, social account metrics, or X/Twitter a - `limit`, `page` — pagination - `start`, `end` — date range (ISO 8601) -### Bulk Data Service +--- -High-performance bulk data download in CSV or JSONL format. Designed for data scientists, analysts, and researchers needing large historical datasets. +## Bulk Data Service -Route bulk download, historical data export, CSV/JSONL dataset requests here. +High-performance bulk data download in CSV or JSONL format for large historical datasets. + +Requires an appropriate subscription tier for the requested dataset. | Endpoint | Method | Description | |---|---|---| -| `/bulk/v1/datasets` | GET | List available bulk datasets for your subscription tier | +| `/bulk/v1/datasets` | GET | List available bulk datasets for subscription tier | | `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset in CSV or JSONL format | **Query parameters:** - `format` — `csv` or `jsonl` - `start`, `end` — date range (ISO 8601) - Granularities: `5m`, `15m`, `30m`, `1h`, `1d` - ---- - -## 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 comparison | **Metrics** | -| Sentiment, mindshare, trending tokens, social buzz | **Signal** | -| Headlines, recent events, breaking news | **News** | -| Analyst reports, deep dives, sector overviews | **Research** | -| Stablecoin supply, flows, chain breakdowns | **Stablecoins** | -| Exchange volumes, exchange comparisons | **Exchanges** | -| L1/L2 network activity, fees, active addresses | **Networks** | -| DeFi protocols, TVL, lending, DEX volume | **Protocols** | -| Token unlocks, vesting schedules | **Token Unlocks** | -| Fundraising rounds, investors, VC activity, M&A | **Fundraising** | -| Governance events, protocol upgrades | **Intel** | -| Trending narratives, topic momentum | **Topics** | -| Crypto influencers, X/Twitter accounts | **X-Users** | -| In-depth research report, comprehensive analysis on a crypto topic | **Deep Research** (under AI) | -| Bulk data download, large historical datasets, CSV/JSONL export | **Bulk Data** | -| Trading pair data, market-specific price and volume | **Markets** (under Metrics) | - -### 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 - -``` -"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." -"Generate a deep research report on the current state of liquid staking." -"What are the trending questions in crypto right now?" -"Download bulk historical price data for Ethereum over the last year." -``` diff --git a/openclaw-skill/README.md b/openclaw-skill/README.md deleted file mode 100644 index ed40700..0000000 --- a/openclaw-skill/README.md +++ /dev/null @@ -1,121 +0,0 @@ -# Messari Crypto Intelligence - -**Real-time crypto market intelligence for AI agents — powered by Messari's REST API.** - -Drop Messari's entire crypto data stack into your AI workflow. This skill gives your agent direct access to Messari's REST API for AI-powered analysis, on-chain metrics, social sentiment, institutional research, news, DeFi protocol data, token unlock schedules, fundraising intelligence, and more across 34,000+ crypto assets. - -No data pipelines. No custom integrations. Just plug in your API key and ask questions. - ---- - -## What You Get - -**Messari AI** — Chat completions trained on 30TB+ of structured and unstructured crypto data. Market data, fundraising rounds, network metrics, research reports, newsletters, podcasts, and curated news — all synthesized in real time. - -**Signal** — Social sentiment scoring, token mindshare tracking, trending narrative detection, and influencer activity monitoring. Know what the market is talking about before it moves. - -**Metrics** — Price, volume, market cap, and fundamental metrics for 34,000+ assets across 210+ exchanges. 175+ filterable metrics for screening opportunities. - -**News** — Real-time crypto news aggregation. Breaking events, project updates, regulatory developments. - -**Research** — Institutional-grade reports from Messari's analyst team. Sector deep dives, protocol diligence, quarterly reviews, governance analysis. - -**Stablecoins** — On-chain metrics, historical timeseries, and per-chain breakdowns for 25+ stablecoins. Track supply shifts, flow patterns, and market share. - -**Exchanges** — Exchange-level volume, metrics, and historical timeseries across 210+ exchanges. - -**Networks** — L1/L2 blockchain network metrics and timeseries. Chain-level activity, fees, active addresses. - -**Protocols** — DeFi protocol metrics across DEXs, lending, liquid staking, and interoperability bridges. - -**Token Unlocks** — Vesting schedules, upcoming unlock events, and supply pressure analysis. - -**Fundraising** — Funding rounds, investors, funds, organizations, projects, and M&A activity. - -**Intel** — Governance events, protocol upgrades, and key project milestones. - -**Topics** — Trending narrative classes and daily topic timeseries. - -**X-Users** — Crypto X/Twitter user metrics and influence tracking. - ---- - -## Requirements - -- A **Messari API key** ([get one here](https://messari.io/api)) -- **Messari AI credits** for AI completion endpoints - ---- - -## Quick Start - -### 1. Install the skill - -```bash -clawhub install messari/messari-crypto -``` - -### 2. Set your API key - -Set the `MESSARI_API_KEY` environment variable, or configure it through your OpenClaw client. The skill passes this key as the `x-messari-api-key` header on every request. - -### 3. Start asking questions - -- "What's the bull case for ETH right now?" -- "Which tokens are gaining mindshare this week?" -- "Show me SOL's 90-day price and volume trend" -- "How has USDC supply shifted across chains this quarter?" -- "What token unlocks are coming up in the next 30 days?" -- "Summarize the latest research on restaking protocols" -- "Who are the most active crypto VCs this quarter?" - ---- - -## How It Works - -This skill wraps Messari's REST API directly. It provides: - -1. **REST API configuration** — base URL, authentication, and endpoint routing so your agent can call Messari's API via HTTP -2. **Service routing guidance** — helps your agent pick the right Messari endpoint (AI vs. Metrics vs. Signal, etc.) based on the query type -3. **Reference documentation** — detailed breakdown of all 14 API services with endpoint paths, methods, and parameters - -Your agent makes standard HTTP requests to `https://api.messari.io` with the `x-messari-api-key` header. No MCP server, no npm packages, no local processes — just REST calls. - ---- - -## Authentication - -Every request requires the `x-messari-api-key` header: - -```bash -curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin" \ - -H "x-messari-api-key: $MESSARI_API_KEY" -``` - ---- - -## Example Workflows - -**Portfolio check**: "How are my top 5 holdings performing this week?" → Metrics pulls price/volume, Signal adds sentiment context, AI synthesizes - -**Narrative tracking**: "What are the trending crypto narratives right now?" → Topics identifies trending classes, Signal provides mindshare data, Research provides depth - -**Due diligence**: "Give me a research summary on Eigen Layer" → Research pulls analyst reports, Metrics adds fundamental data, Fundraising shows investor backing, AI synthesizes - -**Stablecoin monitoring**: "Show me USDT vs USDC market share over the last 6 months" → Stablecoins service pulls per-chain timeseries data - -**Supply analysis**: "What major token unlocks are happening this month?" → Token Unlocks pulls upcoming events, Metrics adds current price context - -**DeFi research**: "Compare TVL across top lending protocols" → Protocols pulls lending-specific metrics, Networks adds chain-level context - ---- - -## Links - -- [Messari API](https://messari.io/api) -- [Messari API Docs](https://docs.messari.io) -- [Messari](https://messari.io) - ---- - -*Built by [Messari](https://messari.io). Open-source skill for the OpenClaw ecosystem.* diff --git a/openclaw-skill/messari-crypto/SKILL.md b/openclaw-skill/messari-crypto/SKILL.md deleted file mode 100644 index 51f6a88..0000000 --- a/openclaw-skill/messari-crypto/SKILL.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -name: messari-crypto -description: > - Crypto market intelligence powered by Messari's REST API. Provides real-time access to - Messari AI (chat completions over 30TB+ crypto data), Signal (sentiment, mindshare, trending - narratives), Metrics (prices, volumes, fundamentals for 34,000+ assets across 210+ exchanges), - News, Research, Stablecoins, Exchanges, Networks, Protocols, Token Unlocks, Fundraising, Intel, - Topics, and X-Users data. - Use when the user asks about crypto markets, token analysis, sentiment, protocol metrics, asset - research, trending narratives, stablecoin flows, token unlock schedules, fundraising rounds, - governance events, or any blockchain/crypto data question. - Requires a Messari API key (MESSARI_API_KEY). The AI completion endpoints also require - purchased Messari AI credits (a paid usage quota managed at messari.io/account). -homepage: https://github.com/messari/skills -source: https://github.com/messari/skills -env: - - name: MESSARI_API_KEY - description: Messari API key — get one at messari.io/account/api - required: true -metadata: - openclaw: - env: - - name: MESSARI_API_KEY - description: Messari API key — get one at messari.io/account/api - required: true ---- - -# Messari 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** (`MESSARI_API_KEY`) — [sign up for an API key](https://messari.io/api) or [retrieve your existing key](https://messari.io/account/api). Set this as an environment variable or configure it through your OpenClaw client. -- **Messari AI Credits** (optional) — a paid usage quota required only for the AI chat completion endpoints. Purchase and manage credits at [messari.io/account](https://messari.io/account). All other endpoints work with just the API key. - -## REST API Overview - -**Base URL:** `https://api.messari.io` - -**Authentication:** Include your API key in every request: - -``` -x-messari-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 | -| **AI (v2)** | `/ai/v2/` | Enhanced chat with citations, verbosity control, related questions | -| **Deep Research** | `/ai/v1/deep-research` | In-depth async research reports (500 credits, 5-10 min) | -| **Trending Questions** | `/ai/v1/questions/` | Trending crypto questions asked by the community | -| **Bulk Data** | `/bulk/v1/` | Large-scale dataset downloads (CSV/JSONL) for quant workflows | -| **Signal** | `/signal/v1/` | Sentiment, mindshare, trending narratives | -| **Metrics** | `/metrics/v2/` | Price, volume, market cap, fundamentals | -| **Markets** | `/metrics/v1/markets` | Exchange-level market pair data and metrics | -| **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](references/api_services.md) or the full [Messari API docs](https://docs.messari.io/introduction). - -## Example Requests - -### AI Chat Completion - -```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?"} - ] - }' -``` - -### Deep Research Report - -```bash -# Start a deep research job (async — takes 5-10 minutes) -curl -X POST "https://api.messari.io/ai/v1/deep-research" \ - -H "x-messari-api-key: $MESSARI_API_KEY" \ - -H "Content-Type: application/json" \ - -d '{"query": "What are the key risks and opportunities for Ethereum in 2025?"}' - -# Poll for the result -curl "https://api.messari.io/ai/v1/deep-research/{id}" \ - -H "x-messari-api-key: $MESSARI_API_KEY" -``` - -### Asset Metrics Lookup - -```bash -curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \ - -H "x-messari-api-key: $MESSARI_API_KEY" -``` - -### Signal Mindshare Gainers - -```bash -curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limit=10" \ - -H "x-messari-api-key: $MESSARI_API_KEY" -``` - -### News Feed - -```bash -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. -**Bulk Data** for large-scale CSV/JSONL dataset downloads. - -### 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. -**Deep Research** for long-form, sourced research reports on any crypto topic (async, 5-10 min). - -### Multi-service queries -Combine services for richer answers. Example — "Is SOL overvalued?": -1. **Metrics** → current price, volume, fundamentals -2. **Signal** → sentiment and mindshare trend -3. **Token Unlocks** → upcoming supply pressure -4. **AI** → synthesize a view from all data -5. **Deep Research** → commission a full research report with citations -6. **Bulk Data** → download large datasets for offline analysis diff --git a/openclaw-skill/messari-crypto/references/api_services.md b/openclaw-skill/messari-crypto/references/api_services.md deleted file mode 100644 index 2644f4f..0000000 --- a/openclaw-skill/messari-crypto/references/api_services.md +++ /dev/null @@ -1,391 +0,0 @@ -# Messari REST API Services Reference - -Detailed breakdown of each service available through the Messari REST API. - -**Base URL:** `https://api.messari.io` -**Auth Header:** `x-messari-api-key: ` - ---- - -## AI Service - -Messari's AI completions endpoint, trained on 30TB+ of structured and unstructured crypto data. - -**Data sources include:** market/price data, fundraising data, network metrics, Messari-exclusive -research reports, newsletters, podcasts, and curated third-party content (news, social posts). - -**Use for:** open-ended crypto questions, synthesis across multiple data sources, market analysis, -protocol comparisons, narrative summaries. - -**Requires:** Messari AI credits. - -| Endpoint | Method | Description | -|---|---|---| -| `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | -| `/ai/openai/chat/completions` | POST | OpenAI-compatible chat completion endpoint | -| `/ai/v2/chat/completions` | POST | Enhanced chat with citations, verbosity control, related questions | -| `/ai/v1/questions/trending` | GET | Trending crypto questions asked by the community | - -**Key parameters (POST body):** -- `messages` — array of `{role, content}` message objects -- `stream` — boolean, enable streaming responses - -**Additional v2 parameters (POST body):** -- `verbosity` — `"succinct"`, `"balanced"`, or `"verbose"` (controls response length) -- `inline_citations` — boolean, embed source citations inline -- `generate_related_questions` — boolean, return follow-up question suggestions -- `response_format` — `"markdown"` or `"plaintext"` -- `allow_clarification_query` — boolean, allow the model to ask clarifying questions - -**Trending questions parameters (GET):** -- `limit` — number of trending questions to return (default: 5) - ---- - -## Deep Research Service - -Async long-form research reports powered by Messari AI. Each report costs 500 AI credits and takes 5-10 minutes. - -**Use for:** in-depth research reports with citations on any crypto topic — protocol deep dives, market theses, risk analysis. - -| Endpoint | Method | Description | -|---|---|---| -| `/ai/v1/deep-research` | POST | Start a new deep research job | -| `/ai/v1/deep-research` | GET | List your deep research jobs | -| `/ai/v1/deep-research/{id}` | GET | Get status and results of a research job | -| `/ai/v1/deep-research/{id}/cancel` | POST | Cancel a running research job | - -**POST body parameters:** -- `query` — (required) the research question -- `instructions` — (optional) additional context or constraints for the report -- `job_id` — (optional) existing job ID for follow-up research - -**GET list parameters:** -- `limit` — number of jobs to return -- `offset` — pagination offset -- `status` — filter by job status (`queued`, `in_progress`, `completed`, `failed`, `cancelled`) - -**Job statuses:** `queued` → `in_progress` → `completed` | `failed` | `cancelled` - -**Response (completed job):** -- `output.report` — full report in markdown -- `output.sources` — list of cited sources - -## Signal Service - -Real-time social intelligence and narrative tracking. - -**Use for:** sentiment shifts, mindshare tracking, trending narratives, social-driven signals. - -| Endpoint | Method | Description | -|---|---|---| -| `/signal/v1/assets` | GET | List assets with signal metrics | -| `/signal/v1/assets/{assetId}` | GET | Signal metrics for a specific asset | -| `/signal/v1/assets/{assetId}/timeseries` | GET | Historical signal timeseries for an asset | -| `/signal/v1/assets/gainers-losers` | GET | Top mindshare gainers and losers | -| `/signal/v1/assets/mindshare-gainers-24h` | GET | Top mindshare gainers over 24 hours | -| `/signal/v1/assets/mindshare-gainers-7d` | GET | Top mindshare gainers over 7 days | -| `/signal/v1/assets/mindshare-losers-24h` | GET | Top mindshare losers over 24 hours | -| `/signal/v1/assets/mindshare-losers-7d` | GET | Top mindshare losers over 7 days | - -**Key query parameters:** -- `type` — signal type (e.g., `mindshare`) -- `limit` — number of results -- `start`, `end` — date range for timeseries (ISO 8601) - ---- - -## Metrics Service - -Comprehensive quantitative data across the crypto market. - -**Coverage:** 34,000+ assets, 210+ exchanges, 175+ filterable metrics. - -**Use for:** quantitative analysis, asset comparison, trend identification, portfolio-level data. - -| Endpoint | Method | Description | -|---|---|---| -| `/metrics/v2/assets` | GET | List assets with market metrics | -| `/metrics/v2/assets/{assetId}` | GET | Detailed metrics for a specific asset | -| `/metrics/v2/assets/{assetId}/roi` | GET | ROI data for an asset | -| `/metrics/v2/assets/{assetId}/ath` | GET | All-time high data for an asset | -| `/metrics/v2/assets/{assetId}/timeseries` | GET | Historical metric timeseries for an asset | -| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | -| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | -| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | - -**Key query parameters:** -- `assetSlugs` — comma-separated asset slugs (e.g., `bitcoin,ethereum`) -- `assetIds` — comma-separated asset IDs -- `metrics` — specific metrics to return -- `start`, `end` — date range for timeseries (ISO 8601) -- `interval` — timeseries interval (e.g., `1d`, `1w`) -- `limit`, `page` — pagination - ---- - -## News Service - -Real-time crypto news aggregation. - -**Use for:** event-driven queries, breaking news, project updates, regulatory developments. - -| Endpoint | Method | Description | -|---|---|---| -| `/news/v1/news/feed` | GET | Aggregated crypto news feed | -| `/news/v1/news/sources` | GET | List available news sources | - -**Key query parameters:** -- `assetSlugs` — filter news by asset -- `limit`, `page` — pagination -- `sourceIds` — filter by specific news sources - ---- - -## Research Service - -Institutional-grade research from Messari's analyst team. - -**Use for:** fundamental research, due diligence, sector analysis, protocol evaluations. - -| Endpoint | Method | Description | -|---|---|---| -| `/research/v1/reports` | GET | List research reports | -| `/research/v1/reports/{reportId}` | GET | Get a specific report | -| `/research/v1/reports/tags` | GET | List available report tags | - -**Key query parameters:** -- `tags` — filter by report tags -- `assetSlugs` — filter by related assets -- `limit`, `page` — pagination - ---- - -## Stablecoins Service - -Dedicated stablecoin analytics. - -**Coverage:** 25+ stablecoins with per-chain breakdowns. - -**Use for:** stablecoin supply analysis, chain-level flow tracking, market share shifts. - -| Endpoint | Method | Description | -|---|---|---| -| `/stablecoins/v2/stablecoins` | GET | List stablecoins with metrics | -| `/stablecoins/v2/stablecoins/{stablecoinId}` | GET | Detailed metrics for a stablecoin | -| `/stablecoins/v2/stablecoins/{stablecoinId}/timeseries` | GET | Historical timeseries for a stablecoin | - -**Key query parameters:** -- `metrics` — specific stablecoin metrics -- `chains` — filter by blockchain -- `start`, `end` — date range for timeseries (ISO 8601) -- `interval` — timeseries interval -- `limit`, `page` — pagination - ---- - -## Exchanges Service - -Crypto exchange market data. - -**Use for:** exchange volume analysis, exchange-level metrics, cross-exchange comparisons. - -| Endpoint | Method | Description | -|---|---|---| -| `/exchanges/v2/exchanges` | GET | List exchanges with metrics | -| `/exchanges/v2/exchanges/{exchangeId}` | GET | Detailed metrics for an exchange | -| `/exchanges/v2/exchanges/{exchangeId}/timeseries` | GET | Historical timeseries for an exchange | - -**Key query parameters:** -- `exchangeSlugs` — comma-separated exchange slugs -- `metrics` — specific exchange metrics -- `start`, `end` — date range for timeseries (ISO 8601) -- `interval` — timeseries interval -- `limit`, `page` — pagination - ---- - -## Networks Service - -L1/L2 blockchain network metrics. - -**Use for:** network activity analysis, chain comparisons, on-chain metrics. - -| Endpoint | Method | Description | -|---|---|---| -| `/networks/v2/networks` | GET | List networks with metrics | -| `/networks/v2/networks/{networkId}` | GET | Detailed metrics for a network | -| `/networks/v2/networks/{networkId}/timeseries` | GET | Historical timeseries for a network | - -**Key query parameters:** -- `networkSlugs` — comma-separated network slugs -- `metrics` — specific network metrics -- `start`, `end` — date range for timeseries (ISO 8601) -- `interval` — timeseries interval -- `limit`, `page` — pagination - ---- - -## Protocols Service - -DeFi protocol metrics across multiple categories. - -**Use for:** DeFi analysis, protocol comparisons, TVL tracking, yield data. - -| Endpoint | Method | Description | -|---|---|---| -| `/protocols/v2/protocols` | GET | List protocols with metrics | -| `/protocols/v2/protocols/{protocolId}` | GET | Detailed metrics for a protocol | -| `/protocols/v2/protocols/dex` | GET | DEX-specific protocol metrics | -| `/protocols/v2/protocols/lending` | GET | Lending protocol metrics | -| `/protocols/v2/protocols/interop` | GET | Interoperability/bridge protocol metrics | -| `/protocols/v2/protocols/liquid-staking` | GET | Liquid staking protocol metrics | - -**Key query parameters:** -- `protocolSlugs` — comma-separated protocol slugs -- `metrics` — specific protocol metrics -- `limit`, `page` — pagination - ---- - -## Token Unlocks Service - -Token vesting schedules and unlock events. - -**Use for:** tracking upcoming token unlocks, supply pressure analysis, vesting schedule lookup. - -| Endpoint | Method | Description | -|---|---|---| -| `/token-unlocks/v1/assets` | GET | List assets with token unlock data | -| `/token-unlocks/v1/assets/{assetId}` | GET | Token unlock details for an asset | -| `/token-unlocks/v1/assets/{assetId}/events` | GET | Upcoming unlock events for an asset | -| `/token-unlocks/v1/assets/{assetId}/vesting` | GET | Full vesting schedule for an asset | -| `/token-unlocks/v1/allocations` | GET | Token allocation breakdowns across categories | -| `/token-unlocks/v1/assets/{assetId}/unlocks` | GET | Specific unlock events for an asset | - -**Key query parameters:** -- `assetSlugs` — comma-separated asset slugs -- `start`, `end` — date range filter (ISO 8601) -- `limit`, `page` — pagination - ---- - -## Fundraising Service - -Crypto fundraising data including rounds, investors, and M&A activity. - -**Use for:** tracking funding rounds, investor activity, project fundraising history, M&A deals. - -| Endpoint | Method | Description | -|---|---|---| -| `/fundraising/v1/rounds` | GET | List fundraising rounds | -| `/fundraising/v1/organizations` | GET | List organizations involved in fundraising | -| `/fundraising/v1/projects` | GET | List projects that have raised funding | -| `/fundraising/v1/investors` | GET | List investors and their activity | -| `/fundraising/v1/funds` | GET | List investment funds | -| `/fundraising/v1/mergers-acquisitions` | GET | List M&A transactions | -| `/fundraising/v1/rounds/investors` | GET | List investors participating in specific rounds | -| `/fundraising/v1/funds/managers` | GET | List fund managers and their portfolios | - -**Key query parameters:** -- `assetSlugs` — filter by related asset -- `investorSlugs` — filter by investor -- `roundTypes` — filter by round type (e.g., `seed`, `series-a`) -- `start`, `end` — date range (ISO 8601) -- `limit`, `page` — pagination - ---- - -## Intel Service - -Governance events, protocol updates, and project milestones. - -**Use for:** tracking governance proposals, protocol upgrades, key project events. - -| Endpoint | Method | Description | -|---|---|---| -| `/intel/v1/events` | GET | List intel events | -| `/intel/v1/events/{eventId}` | GET | Details for a specific event | -| `/intel/v1/assets` | GET | List assets with intel event data | - -**Key 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 timeseries. - -**Use for:** identifying trending narratives, tracking topic momentum over time. - -| Endpoint | Method | Description | -|---|---|---| -| `/topics/v1/classes` | GET | List topic classes/categories | -| `/topics/v1/current` | GET | Currently trending topics | -| `/topics/v1/timeseries` | GET | Daily topic trend timeseries | - -**Key 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. - -**Use for:** tracking influential crypto accounts, social activity metrics, influence timeseries. - -| Endpoint | Method | Description | -|---|---|---| -| `/signal/v1/x-users` | GET | List crypto X/Twitter users with metrics | -| `/signal/v1/x-users/{userId}` | GET | Metrics for a specific X user | -| `/signal/v1/x-users/{userId}/timeseries` | GET | Historical metrics for an X user | - -**Key query parameters:** -- `limit`, `page` — pagination -- `start`, `end` — date range for timeseries (ISO 8601) - ---- - -## Bulk Data Service - -Large-scale dataset downloads for quantitative analysis. - -**Use for:** downloading full historical datasets in CSV or JSONL format — useful for backtesting, data science, and quant workflows. - -**Requires:** appropriate subscription tier for the dataset. - -| Endpoint | Method | Description | -|---|---|---| -| `/bulk/v1/datasets` | GET | List available datasets for your subscription tier | -| `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset at specified granularity | - -**Key query parameters:** -- `datasetSlug` — dataset identifier -- `granularity` — time granularity: `5m`, `15m`, `30m`, `1h`, `1d` -- Output format: CSV or JSONL depending on Accept header - ---- - -## Markets Service - -Exchange-level market pair data and metrics. - -**Use for:** market-pair-level analysis, exchange trading pair volumes, spread data. - -| Endpoint | Method | Description | -|---|---|---| -| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | -| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | -| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | - -**Key query parameters:** -- `marketIdentifier` — market pair ID (e.g., exchange-specific pair identifier) -- `metrics` — specific market metrics to return -- `limit`, `page` — pagination diff --git a/openclaw/messari-api/SKILL.md b/openclaw/messari-api/SKILL.md new file mode 100644 index 0000000..5884c8b --- /dev/null +++ b/openclaw/messari-api/SKILL.md @@ -0,0 +1,133 @@ +--- +name: messari-api +description: > + Queries Messari's REST API for crypto market data across 14 services: AI chat completions, + asset metrics and prices, social sentiment and mindshare, news, institutional research, + stablecoins, exchanges, L1/L2 networks, DeFi protocols, token unlocks, fundraising rounds, + governance intel, trending topics, and X/Twitter user analytics. Covers 34,000+ assets and + 210+ exchanges. Use when answering questions about crypto markets, token analysis, sentiment, + on-chain metrics, protocol data, fundraising, or any blockchain data question. +homepage: https://github.com/messari/skills +source: https://github.com/messari/skills +env: + - name: MESSARI_API_KEY + description: Messari API key — get one at messari.io/account/api + required: true +metadata: + openclaw: + env: + - name: MESSARI_API_KEY + description: Messari API key — get one at messari.io/account/api + required: true +--- + +# Messari REST API + +Crypto market intelligence across 14 data services via Messari's REST API. + +## Authentication + +Every request requires the `x-messari-api-key` header. Obtain a key at [messari.io/api](https://messari.io/api). If no key is available, ask the user to provide one before making requests. + +**Base URL:** `https://api.messari.io` + +``` +x-messari-api-key: +``` + +All endpoints accept and return JSON. Use `Content-Type: application/json` for POST requests. + +## Service Routing + +| User is asking about... | Route to | Base path | +|---|---|---| +| General crypto question, synthesis, "what do you think about X" | **AI** | `/ai/` | +| In-depth research report with citations (async, 5-10 min) | **Deep Research** | `/ai/v1/deep-research` | +| Price, volume, market cap, ROI, ATH, performance comparison | **Metrics** | `/metrics/v2/` | +| Trading pair data, market-specific price and volume | **Markets** | `/metrics/v1/markets` | +| Sentiment, mindshare, trending tokens, social buzz | **Signal** | `/signal/v1/` | +| Headlines, recent events, breaking news | **News** | `/news/v1/` | +| Analyst reports, deep dives, sector overviews | **Research** | `/research/v1/` | +| Stablecoin supply, flows, chain breakdowns | **Stablecoins** | `/stablecoins/v2/` | +| Exchange volumes, exchange comparisons | **Exchanges** | `/exchanges/v2/` | +| L1/L2 network activity, fees, active addresses | **Networks** | `/networks/v2/` | +| DeFi protocols, TVL, lending, DEX volume | **Protocols** | `/protocols/v2/` | +| Token unlocks, vesting schedules | **Token Unlocks** | `/token-unlocks/v1/` | +| Fundraising rounds, investors, VC activity, M&A | **Fundraising** | `/fundraising/v1/` | +| Governance events, protocol upgrades | **Intel** | `/intel/v1/` | +| Trending narratives, topic momentum | **Topics** | `/topics/v1/` | +| Crypto influencers, X/Twitter accounts | **X-Users** | `/signal/v1/x-users/` | +| Bulk data download, large historical datasets, CSV/JSONL export | **Bulk Data** | `/bulk/v1/` | +| Trending questions the community is asking | **Trending Questions** | `/ai/v1/questions/` | + +For full endpoint details, parameters, and examples, see [references/endpoints.md](references/endpoints.md). + +## Multi-Service Queries + +Many questions benefit from combining services. Follow this workflow: + +``` +Multi-Service Query Checklist: +- [ ] Identify which services are relevant to the question +- [ ] Query each service for its piece of the answer +- [ ] If any request fails, retry once then note the gap +- [ ] Synthesize results into a unified answer +- [ ] Optionally route through AI service for final synthesis +``` + +**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) +- **"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. + +## Common Parameters + +Most GET endpoints share these query parameters: + +- `limit`, `page` — pagination +- `start`, `end` — date range (ISO 8601) +- Asset filters: `assetSlugs` (comma-separated slugs like `bitcoin,ethereum`) or `assetIds` +- `metrics` — specific metrics to return +- `interval` — timeseries interval (`1d`, `1w`) + +## Quick Examples + +### AI Chat Completion + +```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?"}]}' +``` + +### Asset Metrics + +```bash +curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + +### Signal Mindshare Gainers + +```bash +curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limit=10" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + +### News Feed + +```bash +curl "https://api.messari.io/news/v1/news/feed?limit=20" \ + -H "x-messari-api-key: $MESSARI_API_KEY" +``` + +## Notes + +- The **AI** and **Deep Research** endpoints require Messari AI credits (a paid usage quota managed at [messari.io/account](https://messari.io/account)). All other endpoints work with just the API key. +- Deep Research jobs are asynchronous — submit a query, then poll for results (5-10 min). Each report costs 500 credits. +- The **Bulk Data** service requires an appropriate subscription tier for the requested dataset. diff --git a/openclaw/messari-api/references/endpoints.md b/openclaw/messari-api/references/endpoints.md new file mode 100644 index 0000000..056c4d8 --- /dev/null +++ b/openclaw/messari-api/references/endpoints.md @@ -0,0 +1,394 @@ +# Messari REST API — Endpoint Reference + +**Base URL:** `https://api.messari.io` +**Auth Header:** `x-messari-api-key: ` + +## Contents + +- [AI Service](#ai-service) +- [Deep Research](#deep-research) +- [Metrics Service](#metrics-service) +- [Markets Service](#markets-service) +- [Signal Service](#signal-service) +- [News Service](#news-service) +- [Research Service](#research-service) +- [Stablecoins Service](#stablecoins-service) +- [Exchanges Service](#exchanges-service) +- [Networks Service](#networks-service) +- [Protocols Service](#protocols-service) +- [Token Unlocks Service](#token-unlocks-service) +- [Fundraising Service](#fundraising-service) +- [Intel Service](#intel-service) +- [Topics Service](#topics-service) +- [X-Users Service](#x-users-service) +- [Bulk Data Service](#bulk-data-service) + +--- + +## AI Service + +Chat completions across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first. + +Requires Messari AI credits. + +| Endpoint | Method | Description | +|---|---|---| +| `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | +| `/ai/openai/chat/completions` | POST | OpenAI-compatible chat completion endpoint | +| `/ai/v2/chat/completions` | POST | v2 chat completion with inline citations, verbosity control, related questions | +| `/ai/v1/questions/trending` | GET | Suggested questions based on trending crypto topics | + +**POST body:** +- `messages` — array of `{role, content}` message objects +- `stream` — boolean, enable streaming responses + +**Additional v2 parameters:** +- `verbosity` — `succinct`, `balanced`, or `verbose` +- `inline_citations` — boolean, include citation references in metadata +- `generate_related_questions` — integer, number of follow-up suggestions +- `response_format` — `markdown` or `plaintext` + +**Trending questions parameters (GET):** +- `limit` — number of trending questions to return (default: 5) + +```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?"}]}' +``` + +--- + +## Deep Research + +Asynchronous long-form research reports with citations. Each report costs 500 AI credits and takes 5-10 minutes. + +| Endpoint | Method | Description | +|---|---|---| +| `/ai/v1/deep-research` | POST | Create a new deep research job | +| `/ai/v1/deep-research` | GET | List deep research jobs | +| `/ai/v1/deep-research/{id}` | GET | Get job status; includes report when completed | +| `/ai/v1/deep-research/{id}/cancel` | POST | Cancel a queued or in-progress job | + +**POST body:** +- `query` — research topic or question (required) +- `instructions` — optional system instructions to guide research style +- `job_id` — optional, pass existing job ID for follow-up refinement + +**GET list parameters:** +- `limit` — max results (default 20, max 100) +- `offset` — pagination offset +- `status` — filter: `queued`, `in_progress`, `completed`, `failed`, `cancelled` + +**Job lifecycle:** `queued` → `in_progress` → `completed` | `failed` | `cancelled` + +**Completed job response includes:** +- `output.report` — full report in markdown +- `output.sources` — list of cited sources + +```bash +curl -X POST "https://api.messari.io/ai/v1/deep-research" \ + -H "x-messari-api-key: $MESSARI_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{"query": "What is the current state of liquid staking on Ethereum?"}' +``` + +--- + +## Metrics Service + +Price, volume, market cap, and fundamental metrics for 34,000+ assets across 210+ exchanges. + +| Endpoint | Method | Description | +|---|---|---| +| `/metrics/v2/assets` | GET | List assets with market metrics | +| `/metrics/v2/assets/{assetId}` | GET | Detailed metrics for a specific asset | +| `/metrics/v2/assets/{assetId}/roi` | GET | ROI data for an asset | +| `/metrics/v2/assets/{assetId}/ath` | GET | All-time high data for an asset | +| `/metrics/v2/assets/{assetId}/timeseries` | GET | Historical 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" +``` + +--- + +## Markets Service + +Exchange-level trading pair data and metrics. + +| Endpoint | Method | Description | +|---|---|---| +| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | +| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | +| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | + +**Query parameters:** +- `marketIdentifier` — market pair ID +- `metrics` — specific market metrics to return +- `limit`, `page` — pagination + +--- + +## Signal Service + +Real-time social intelligence — sentiment scoring, mindshare tracking, trending narratives. + +| Endpoint | Method | Description | +|---|---|---| +| `/signal/v1/assets` | GET | List assets with signal metrics | +| `/signal/v1/assets/{assetId}` | GET | Signal metrics for a specific asset | +| `/signal/v1/assets/{assetId}/timeseries` | GET | Historical signal timeseries | +| `/signal/v1/assets/gainers-losers` | GET | Top mindshare gainers and losers | +| `/signal/v1/assets/mindshare-gainers-24h` | GET | Assets with biggest mindshare gains (24h) | +| `/signal/v1/assets/mindshare-gainers-7d` | GET | Assets with biggest mindshare gains (7d) | +| `/signal/v1/assets/mindshare-losers-24h` | GET | Assets with biggest mindshare losses (24h) | +| `/signal/v1/assets/mindshare-losers-7d` | GET | Assets with biggest mindshare losses (7d) | + +**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 from 500+ sources. + +| Endpoint | Method | Description | +|---|---|---| +| `/news/v1/news/feed` | GET | Aggregated crypto news feed | +| `/news/v1/news/sources` | GET | List 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/research/v1/reports` | GET | List research reports | +| `/research/v1/reports/{reportId}` | GET | Get a specific report | +| `/research/v1/reports/tags` | GET | List available report tags | + +**Query parameters:** +- `tags` — filter by report tags +- `assetSlugs` — filter by related assets +- `limit`, `page` — pagination + +--- + +## Stablecoins Service + +On-chain metrics and per-chain breakdowns for 25+ stablecoins. + +| Endpoint | Method | Description | +|---|---|---| +| `/stablecoins/v2/stablecoins` | GET | List stablecoins with metrics | +| `/stablecoins/v2/stablecoins/{stablecoinId}` | GET | Detailed metrics for a stablecoin | +| `/stablecoins/v2/stablecoins/{stablecoinId}/timeseries` | GET | Historical 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/exchanges/v2/exchanges` | GET | List exchanges with metrics | +| `/exchanges/v2/exchanges/{exchangeId}` | GET | Detailed metrics for an exchange | +| `/exchanges/v2/exchanges/{exchangeId}/timeseries` | GET | Historical 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/networks/v2/networks` | GET | List networks with metrics | +| `/networks/v2/networks/{networkId}` | GET | Detailed metrics for a network | +| `/networks/v2/networks/{networkId}/timeseries` | GET | Historical 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/protocols/v2/protocols` | GET | List protocols with metrics | +| `/protocols/v2/protocols/{protocolId}` | GET | Detailed metrics for a protocol | +| `/protocols/v2/protocols/dex` | GET | DEX-specific metrics | +| `/protocols/v2/protocols/lending` | GET | Lending protocol metrics | +| `/protocols/v2/protocols/interop` | GET | Bridge/interoperability metrics | +| `/protocols/v2/protocols/liquid-staking` | GET | Liquid 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/token-unlocks/v1/assets` | GET | List assets with unlock data | +| `/token-unlocks/v1/assets/{assetId}` | GET | Unlock details for an asset | +| `/token-unlocks/v1/assets/{assetId}/events` | GET | Upcoming unlock events | +| `/token-unlocks/v1/assets/{assetId}/vesting` | GET | Full vesting schedule | +| `/token-unlocks/v1/allocations` | GET | Token allocation data across assets | +| `/token-unlocks/v1/assets/{assetId}/unlocks` | GET | Interval-based unlock timeseries data | + +**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. + +| Endpoint | Method | Description | +|---|---|---| +| `/fundraising/v1/rounds` | GET | List fundraising rounds | +| `/fundraising/v1/organizations` | GET | List organizations | +| `/fundraising/v1/projects` | GET | List projects that raised funding | +| `/fundraising/v1/investors` | GET | List investors and activity | +| `/fundraising/v1/funds` | GET | List investment funds | +| `/fundraising/v1/mergers-acquisitions` | GET | List M&A transactions | +| `/fundraising/v1/rounds/investors` | GET | Investors that participated in filtered rounds | +| `/fundraising/v1/funds/managers` | GET | Managers of filtered funds | + +**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. + +| Endpoint | Method | Description | +|---|---|---| +| `/intel/v1/events` | GET | List intel events | +| `/intel/v1/events/{eventId}` | GET | Details for a specific event | +| `/intel/v1/assets` | GET | List 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/topics/v1/classes` | GET | List topic classes/categories | +| `/topics/v1/current` | GET | Currently trending topics | +| `/topics/v1/timeseries` | GET | Daily 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. + +| Endpoint | Method | Description | +|---|---|---| +| `/signal/v1/x-users` | GET | List crypto X users with metrics | +| `/signal/v1/x-users/{userId}` | GET | Metrics for a specific X user | +| `/signal/v1/x-users/{userId}/timeseries` | GET | Historical metrics for an X user | + +**Query parameters:** +- `limit`, `page` — pagination +- `start`, `end` — date range (ISO 8601) + +--- + +## Bulk Data Service + +High-performance bulk data download in CSV or JSONL format for large historical datasets. + +Requires an appropriate subscription tier for the requested dataset. + +| Endpoint | Method | Description | +|---|---|---| +| `/bulk/v1/datasets` | GET | List available bulk datasets for subscription tier | +| `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset in CSV or JSONL format | + +**Query parameters:** +- `format` — `csv` or `jsonl` +- `start`, `end` — date range (ISO 8601) +- Granularities: `5m`, `15m`, `30m`, `1h`, `1d` From 998f652d6de0b3906ab4e5620fed024e8a05b4e3 Mon Sep 17 00:00:00 2001 From: Ryan Sanna Date: Mon, 9 Mar 2026 13:40:44 -0700 Subject: [PATCH 3/3] update --- claude/messari-api/SKILL.md | 8 +--- claude/messari-api/references/endpoints.md | 48 +++----------------- openclaw/messari-api/SKILL.md | 8 +--- openclaw/messari-api/references/endpoints.md | 48 +++----------------- 4 files changed, 16 insertions(+), 96 deletions(-) diff --git a/claude/messari-api/SKILL.md b/claude/messari-api/SKILL.md index 4592e4a..a2d880c 100644 --- a/claude/messari-api/SKILL.md +++ b/claude/messari-api/SKILL.md @@ -30,9 +30,8 @@ All endpoints accept and return JSON. Use `Content-Type: application/json` for P | User is asking about... | Route to | Base path | |---|---|---| | General crypto question, synthesis, "what do you think about X" | **AI** | `/ai/` | -| In-depth research report with citations (async, 5-10 min) | **Deep Research** | `/ai/v1/deep-research` | +| In-depth research report with citations (async, 5-10 min) | **AI** (Deep Research) | `/ai/v1/deep-research` | | Price, volume, market cap, ROI, ATH, performance comparison | **Metrics** | `/metrics/v2/` | -| Trading pair data, market-specific price and volume | **Markets** | `/metrics/v1/markets` | | Sentiment, mindshare, trending tokens, social buzz | **Signal** | `/signal/v1/` | | Headlines, recent events, breaking news | **News** | `/news/v1/` | | Analyst reports, deep dives, sector overviews | **Research** | `/research/v1/` | @@ -45,8 +44,6 @@ All endpoints accept and return JSON. Use `Content-Type: application/json` for P | Governance events, protocol upgrades | **Intel** | `/intel/v1/` | | Trending narratives, topic momentum | **Topics** | `/topics/v1/` | | Crypto influencers, X/Twitter accounts | **X-Users** | `/signal/v1/x-users/` | -| Bulk data download, large historical datasets, CSV/JSONL export | **Bulk Data** | `/bulk/v1/` | -| Trending questions the community is asking | **Trending Questions** | `/ai/v1/questions/` | For full endpoint details, parameters, and examples, see [references/endpoints.md](references/endpoints.md). @@ -116,6 +113,5 @@ curl "https://api.messari.io/news/v1/news/feed?limit=20" \ ## Notes -- The **AI** and **Deep Research** endpoints require Messari AI credits (a paid usage quota managed at [messari.io/account](https://messari.io/account)). All other endpoints work with just the API key. +- The **AI** service endpoints (chat completions and deep research) require Messari AI credits (a paid usage quota managed at [messari.io/account](https://messari.io/account)). All other endpoints work with just the API key. - Deep Research jobs are asynchronous — submit a query, then poll for results (5-10 min). Each report costs 500 credits. -- The **Bulk Data** service requires an appropriate subscription tier for the requested dataset. diff --git a/claude/messari-api/references/endpoints.md b/claude/messari-api/references/endpoints.md index 056c4d8..5e4e8c7 100644 --- a/claude/messari-api/references/endpoints.md +++ b/claude/messari-api/references/endpoints.md @@ -6,9 +6,7 @@ ## Contents - [AI Service](#ai-service) -- [Deep Research](#deep-research) - [Metrics Service](#metrics-service) -- [Markets Service](#markets-service) - [Signal Service](#signal-service) - [News Service](#news-service) - [Research Service](#research-service) @@ -21,16 +19,17 @@ - [Intel Service](#intel-service) - [Topics Service](#topics-service) - [X-Users Service](#x-users-service) -- [Bulk Data Service](#bulk-data-service) --- ## AI Service -Chat completions across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first. +Chat completions and deep research reports across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first. Requires Messari AI credits. +### Chat Completions + | Endpoint | Method | Description | |---|---|---| | `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | @@ -51,16 +50,14 @@ Requires Messari AI credits. **Trending questions parameters (GET):** - `limit` — number of trending questions to return (default: 5) -```bash -curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ + ```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?"}]}' ``` ---- - -## Deep Research +### Deep Research Asynchronous long-form research reports with citations. Each report costs 500 AI credits and takes 5-10 minutes. @@ -123,22 +120,6 @@ curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \ --- -## Markets Service - -Exchange-level trading pair data and metrics. - -| Endpoint | Method | Description | -|---|---|---| -| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | -| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | -| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | - -**Query parameters:** -- `marketIdentifier` — market pair ID -- `metrics` — specific market metrics to return -- `limit`, `page` — pagination - ---- ## Signal Service @@ -375,20 +356,3 @@ Crypto X/Twitter user metrics and influence tracking. - `limit`, `page` — pagination - `start`, `end` — date range (ISO 8601) ---- - -## Bulk Data Service - -High-performance bulk data download in CSV or JSONL format for large historical datasets. - -Requires an appropriate subscription tier for the requested dataset. - -| Endpoint | Method | Description | -|---|---|---| -| `/bulk/v1/datasets` | GET | List available bulk datasets for subscription tier | -| `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset in CSV or JSONL format | - -**Query parameters:** -- `format` — `csv` or `jsonl` -- `start`, `end` — date range (ISO 8601) -- Granularities: `5m`, `15m`, `30m`, `1h`, `1d` diff --git a/openclaw/messari-api/SKILL.md b/openclaw/messari-api/SKILL.md index 5884c8b..2a49b3c 100644 --- a/openclaw/messari-api/SKILL.md +++ b/openclaw/messari-api/SKILL.md @@ -42,9 +42,8 @@ All endpoints accept and return JSON. Use `Content-Type: application/json` for P | User is asking about... | Route to | Base path | |---|---|---| | General crypto question, synthesis, "what do you think about X" | **AI** | `/ai/` | -| In-depth research report with citations (async, 5-10 min) | **Deep Research** | `/ai/v1/deep-research` | +| In-depth research report with citations (async, 5-10 min) | **AI** (Deep Research) | `/ai/v1/deep-research` | | Price, volume, market cap, ROI, ATH, performance comparison | **Metrics** | `/metrics/v2/` | -| Trading pair data, market-specific price and volume | **Markets** | `/metrics/v1/markets` | | Sentiment, mindshare, trending tokens, social buzz | **Signal** | `/signal/v1/` | | Headlines, recent events, breaking news | **News** | `/news/v1/` | | Analyst reports, deep dives, sector overviews | **Research** | `/research/v1/` | @@ -57,8 +56,6 @@ All endpoints accept and return JSON. Use `Content-Type: application/json` for P | Governance events, protocol upgrades | **Intel** | `/intel/v1/` | | Trending narratives, topic momentum | **Topics** | `/topics/v1/` | | Crypto influencers, X/Twitter accounts | **X-Users** | `/signal/v1/x-users/` | -| Bulk data download, large historical datasets, CSV/JSONL export | **Bulk Data** | `/bulk/v1/` | -| Trending questions the community is asking | **Trending Questions** | `/ai/v1/questions/` | For full endpoint details, parameters, and examples, see [references/endpoints.md](references/endpoints.md). @@ -128,6 +125,5 @@ curl "https://api.messari.io/news/v1/news/feed?limit=20" \ ## Notes -- The **AI** and **Deep Research** endpoints require Messari AI credits (a paid usage quota managed at [messari.io/account](https://messari.io/account)). All other endpoints work with just the API key. +- The **AI** service endpoints (chat completions and deep research) require Messari AI credits (a paid usage quota managed at [messari.io/account](https://messari.io/account)). All other endpoints work with just the API key. - Deep Research jobs are asynchronous — submit a query, then poll for results (5-10 min). Each report costs 500 credits. -- The **Bulk Data** service requires an appropriate subscription tier for the requested dataset. diff --git a/openclaw/messari-api/references/endpoints.md b/openclaw/messari-api/references/endpoints.md index 056c4d8..5e4e8c7 100644 --- a/openclaw/messari-api/references/endpoints.md +++ b/openclaw/messari-api/references/endpoints.md @@ -6,9 +6,7 @@ ## Contents - [AI Service](#ai-service) -- [Deep Research](#deep-research) - [Metrics Service](#metrics-service) -- [Markets Service](#markets-service) - [Signal Service](#signal-service) - [News Service](#news-service) - [Research Service](#research-service) @@ -21,16 +19,17 @@ - [Intel Service](#intel-service) - [Topics Service](#topics-service) - [X-Users Service](#x-users-service) -- [Bulk Data Service](#bulk-data-service) --- ## AI Service -Chat completions across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first. +Chat completions and deep research reports across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first. Requires Messari AI credits. +### Chat Completions + | Endpoint | Method | Description | |---|---|---| | `/ai/v1/chat/completions` | POST | Chat completion against Messari's crypto data warehouse | @@ -51,16 +50,14 @@ Requires Messari AI credits. **Trending questions parameters (GET):** - `limit` — number of trending questions to return (default: 5) -```bash -curl -X POST "https://api.messari.io/ai/v1/chat/completions" \ + ```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?"}]}' ``` ---- - -## Deep Research +### Deep Research Asynchronous long-form research reports with citations. Each report costs 500 AI credits and takes 5-10 minutes. @@ -123,22 +120,6 @@ curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \ --- -## Markets Service - -Exchange-level trading pair data and metrics. - -| Endpoint | Method | Description | -|---|---|---| -| `/metrics/v1/markets` | GET | List exchange market pairs with metrics | -| `/metrics/v1/markets/{marketIdentifier}` | GET | Detailed metrics for a specific market pair | -| `/metrics/v1/markets/metrics` | GET | List available market-level metrics | - -**Query parameters:** -- `marketIdentifier` — market pair ID -- `metrics` — specific market metrics to return -- `limit`, `page` — pagination - ---- ## Signal Service @@ -375,20 +356,3 @@ Crypto X/Twitter user metrics and influence tracking. - `limit`, `page` — pagination - `start`, `end` — date range (ISO 8601) ---- - -## Bulk Data Service - -High-performance bulk data download in CSV or JSONL format for large historical datasets. - -Requires an appropriate subscription tier for the requested dataset. - -| Endpoint | Method | Description | -|---|---|---| -| `/bulk/v1/datasets` | GET | List available bulk datasets for subscription tier | -| `/bulk/v1/datasets/{datasetSlug}/{granularity}/data` | GET | Download dataset in CSV or JSONL format | - -**Query parameters:** -- `format` — `csv` or `jsonl` -- `start`, `end` — date range (ISO 8601) -- Granularities: `5m`, `15m`, `30m`, `1h`, `1d`