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..a2d880c
--- /dev/null
+++ b/claude/messari-api/SKILL.md
@@ -0,0 +1,117 @@
+---
+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: <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) | **AI** (Deep Research) | `/ai/v1/deep-research` |
+| Price, volume, market cap, ROI, ATH, performance comparison | **Metrics** | `/metrics/v2/` |
+| 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/` |
+
+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** 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.
diff --git a/SKILL.md b/claude/messari-api/references/endpoints.md
similarity index 59%
rename from SKILL.md
rename to claude/messari-api/references/endpoints.md
index 0ff6d9b..5e4e8c7 100644
--- a/SKILL.md
+++ b/claude/messari-api/references/endpoints.md
@@ -1,68 +1,101 @@
-# Messari — Crypto Market Intelligence for AI Agents
+# Messari REST API — Endpoint Reference
 
-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.
+**Base URL:** `https://api.messari.io`
+**Auth Header:** `x-messari-api-key: <API_KEY>`
+
+## Contents
+
+- [AI Service](#ai-service)
+- [Metrics Service](#metrics-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)
 
-## Integration Paths
+---
 
-### Option A: MCP Server (Preferred)
+## AI Service
 
-If your client supports the Model Context Protocol, connect to Messari's hosted MCP server.
+Chat completions and deep research reports across Messari's full crypto data warehouse. Route general or open-ended crypto questions here first.
 
-**Server URL:** `https://mcp.messari.io/mcp`
+Requires Messari AI credits.
 
-Requires a Messari API key. Get one at [messari.io/api](https://messari.io/api).
+### Chat Completions
 
-### Option B: REST API (Direct HTTP)
+| 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 |
 
-If your client does not support MCP, call Messari's REST API directly.
+**POST body:**
+- `messages` — array of `{role, content}` message objects
+- `stream` — boolean, enable streaming responses
 
-**Base URL:** `https://api.messari.io`
+**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`
 
-**Authentication:** Include the API key in every request:
+**Trending questions parameters (GET):**
+- `limit` — number of trending questions to return (default: 5)
 
-```
-x-messari-api-key: <API_KEY>
+  ```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?"}]}'
 ```
 
-All endpoints accept and return JSON. Use `Content-Type: application/json` for POST requests.
+### Deep Research
 
-**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.
-
----
-
-## Services and Endpoints
-
-### AI Service
-
-Chat completions trained on 30TB+ of structured and unstructured crypto data — market data, fundraising rounds, network metrics, research reports, newsletters, podcasts, and curated news.
-
-Route general or open-ended crypto questions here first. This service synthesizes across all other data sources.
-
-Requires Messari AI credits.
+Asynchronous long-form research reports with citations. Each report costs 500 AI credits and takes 5-10 minutes.
 
 | 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/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:**
-- `messages` — array of `{role, content}` message objects
-- `stream` — boolean, enable streaming responses
+- `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/chat/completions" \
+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 '{"messages": [{"role": "user", "content": "What is the bull case for ETH right now?"}]}'
+  -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. 175+ filterable metrics.
+## Metrics Service
 
-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 |
 |---|---|---|
@@ -87,11 +120,10 @@ curl "https://api.messari.io/metrics/v2/assets?assetSlugs=bitcoin,ethereum" \
 
 ---
 
-### Signal Service
 
-Real-time social intelligence — sentiment scoring, mindshare tracking, trending narratives.
+## Signal Service
 
-Route questions about market sentiment, social buzz, what's trending, mindshare gainers/losers here.
+Real-time social intelligence — sentiment scoring, mindshare tracking, trending narratives.
 
 | Endpoint | Method | Description |
 |---|---|---|
@@ -99,6 +131,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`)
@@ -112,11 +148,9 @@ curl "https://api.messari.io/signal/v1/assets/gainers-losers?type=mindshare&limi
 
 ---
 
-### News Service
+## News Service
 
-Real-time crypto news aggregation — breaking events, project updates, regulatory developments.
-
-Route questions about recent headlines, current events, or "what happened with X" here.
+Real-time crypto news aggregation from 500+ sources.
 
 | Endpoint | Method | Description |
 |---|---|---|
@@ -135,11 +169,9 @@ curl "https://api.messari.io/news/v1/news/feed?limit=20" \
 
 ---
 
-### Research Service
-
-Institutional-grade reports — sector deep dives, protocol diligence, quarterly reviews, governance analysis.
+## Research Service
 
-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 |
 |---|---|---|
@@ -154,11 +186,9 @@ Route questions about fundamental research, due diligence, analyst opinions, and
 
 ---
 
-### Stablecoins Service
+## Stablecoins Service
 
-On-chain metrics, historical timeseries, and per-chain breakdowns for 25+ stablecoins.
-
-Route stablecoin-specific questions here — supply, flows, chain-level breakdowns, market share.
+On-chain metrics and per-chain breakdowns for 25+ stablecoins.
 
 | Endpoint | Method | Description |
 |---|---|---|
@@ -175,12 +205,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 |
@@ -196,12 +224,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 |
@@ -217,12 +243,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 |
@@ -239,18 +263,18 @@ 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 | Token allocation data across assets |
+| `/token-unlocks/v1/assets/{assetId}/unlocks` | GET | Interval-based unlock timeseries data |
 
 **Query parameters:**
 - `assetSlugs` — comma-separated asset slugs
@@ -259,12 +283,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 |
@@ -273,6 +295,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
@@ -283,12 +307,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 |
@@ -303,12 +325,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 |
@@ -322,12 +342,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 |
@@ -338,53 +356,3 @@ Route questions about crypto influencers, social account metrics, or X/Twitter a
 - `limit`, `page` — pagination
 - `start`, `end` — date range (ISO 8601)
 
----
-
-## Routing Guide
-
-Use this logic to pick the right service for a query:
-
-| User is asking about... | Route to |
-|---|---|
-| General crypto question, synthesis, "what do you think about X" | **AI** |
-| Price, volume, market cap, ROI, ATH, performance 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** |
-
-### 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."
-```
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 924bf37..0000000
--- a/openclaw-skill/messari-crypto/SKILL.md
+++ /dev/null
@@ -1,129 +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: <YOUR_API_KEY>
-```
-
-All endpoints accept and return JSON. Use `Content-Type: application/json` for POST requests.
-
-## Service Routing Table
-
-| Service | Base Path | Use When |
-|---|---|---|
-| **AI** | `/ai/` | General crypto questions, synthesis across data sources |
-| **Signal** | `/signal/v1/` | Sentiment, mindshare, trending narratives |
-| **Metrics** | `/metrics/v2/` | Price, volume, market cap, fundamentals |
-| **News** | `/news/v1/` | Real-time crypto news, breaking events |
-| **Research** | `/research/v1/` | Institutional reports, protocol deep dives |
-| **Stablecoins** | `/stablecoins/v2/` | Stablecoin supply, per-chain breakdowns |
-| **Exchanges** | `/exchanges/v2/` | Exchange volume, metrics, timeseries |
-| **Networks** | `/networks/v2/` | L1/L2 network metrics, timeseries |
-| **Protocols** | `/protocols/v2/` | DeFi protocol metrics (DEX, lending, staking) |
-| **Token Unlocks** | `/token-unlocks/v1/` | Vesting schedules, unlock events |
-| **Fundraising** | `/fundraising/v1/` | Funding rounds, investors, M&A |
-| **Intel** | `/intel/v1/` | Governance events, protocol updates |
-| **Topics** | `/topics/v1/` | Trending topic classes, daily timeseries |
-| **X-Users** | `/signal/v1/x-users/` | Crypto X/Twitter user metrics |
-
-For detailed endpoint documentation, see [references/api_services.md](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?"}
-    ]
-  }'
-```
-
-### 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.
-
-### Research, news, and events
-**Research** for deep dives and reports. **News** for real-time events. **Intel** for governance and protocol updates. **Fundraising** for funding rounds and M&A.
-
-### Multi-service queries
-Combine services for richer answers. Example — "Is SOL overvalued?":
-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
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 0005bd4..0000000
--- a/openclaw-skill/messari-crypto/references/api_services.md
+++ /dev/null
@@ -1,300 +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: <YOUR_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 |
-
-**Key parameters (POST body):**
-- `messages` — array of `{role, content}` message objects
-- `stream` — boolean, enable streaming responses
-
----
-
-## 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 |
-
-**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 |
-
-**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 |
-
-**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 |
-
-**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)
diff --git a/openclaw/messari-api/SKILL.md b/openclaw/messari-api/SKILL.md
new file mode 100644
index 0000000..2a49b3c
--- /dev/null
+++ b/openclaw/messari-api/SKILL.md
@@ -0,0 +1,129 @@
+---
+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: <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) | **AI** (Deep Research) | `/ai/v1/deep-research` |
+| Price, volume, market cap, ROI, ATH, performance comparison | **Metrics** | `/metrics/v2/` |
+| 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/` |
+
+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** 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.
diff --git a/openclaw/messari-api/references/endpoints.md b/openclaw/messari-api/references/endpoints.md
new file mode 100644
index 0000000..5e4e8c7
--- /dev/null
+++ b/openclaw/messari-api/references/endpoints.md
@@ -0,0 +1,358 @@
+# Messari REST API — Endpoint Reference
+
+**Base URL:** `https://api.messari.io`
+**Auth Header:** `x-messari-api-key: <API_KEY>`
+
+## Contents
+
+- [AI Service](#ai-service)
+- [Metrics Service](#metrics-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)
+
+---
+
+## AI Service
+
+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 |
+| `/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"
+```
+
+---
+
+
+## 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)
+