Add the MCP server in one line — then your agent answers crypto questions by calling the API for you. No endpoints to wire up, no keys to juggle. Just ask.
setup cryptodataapi-mcp
One API key, 180+ endpoints, 12 data sources. Everything an autonomous trading or research agent needs to read the market, pick a strategy, size risk, and backtest — with a one-line MCP install and gasless on-chain payments.
Developers, vibe coders, autonomous agents, researchers — pick the surface that fits how you work.
190+ endpoints across 20+ data groups — prices, regimes, derivatives, on-chain, sentiment.
Explore API Docs ›Connect Claude, Cursor and any MCP client directly to live market data — one line.
Explore MCP ›Installable SKILL package that teaches coding agents our endpoints, workflows and gotchas.
Explore Agent Skill ›Machine-readable API map built for LLM context windows — curated and full versions.
Read llms.txt ›Copy-paste prompts for market analysis, agents, backtesting and trading bots.
Explore Prompts ›Agents subscribe themselves with gasless USDC — no dashboard, no human in the loop.
See the flow ›A terminal interface for real-time & historical data, built agent-friendly.
Coming soonPersistent connection to stream real-time data for live dashboards.
Coming soonEvent-driven notifications for price alerts and regime changes.
Coming soonStep-by-step guides — install the agent skill, connect the MCP server, start asking. Two minutes per agent.
Setup guide →
Setup guide →
Setup guide →
Setup guide →
Setup guide →
Setup guide →
Setup guide →
Setup guide →
No sign-up form, no dashboard, no wallet required. An agent can do this itself.
One keyless POST returns a cdk_live_ key (shown once).
# no auth needed curl -X POST https://cryptodataapi.com/api/v1/auth/keys \ -H "Content-Type: application/json" \ -d '{"email":"[email protected]"}'
Pass the key on every request via the X-API-Key header.
curl https://cryptodataapi.com/api/v1/health \
-H "X-API-Key: cdk_live_yourkey"/daily bundles health, derivatives, sentiment, macro, ETF flows & more.
curl https://cryptodataapi.com/api/v1/daily \
-H "X-API-Key: cdk_live_yourkey"GET /api/v1/daily — it replaces ~10 calls. Append ?format=markdown to most endpoints for LLM-friendly output, and read /llms.txt for the full machine-readable map.Our MCP server exposes the core endpoints as native tools. Add it with a one-click browser sign-in — no key, no Node:
# Claude Code — remote, browser login (recommended; no key pasted)
claude mcp add --transport http cryptodataapi https://cryptodataapi.com/mcpThe first tool call opens a browser to sign in & authorize — a free account is created automatically. Advanced — pin a key, kept in your shell env (never pasted into an AI chat):
# Advanced — bring your own key (env var) export CRYPTODATA_API_KEY="cdk_live_yourkey" claude mcp add --transport http cryptodataapi https://cryptodataapi.com/mcp \ --header 'X-API-Key: ${CRYPTODATA_API_KEY}'
Prefer a local stdio server (or a client without remote HTTP)? Use the npm package:
# Claude Code — stdio via npx export CRYPTODATA_API_KEY="cdk_live_yourkey" claude mcp add cryptodataapi -- npx -y cryptodataapi-mcp
Claude Desktop / Cursor — add to your MCP config:
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": { "CRYPTODATA_API_KEY": "cdk_live_yourkey" }
}
}
}The MCP server gives your agent the tools; the skill gives it the playbook — the regime → strategy → risk → backtest workflow, the full endpoint reference and the tier gotchas. One command installs it into Claude Code, Cursor, Codex, Gemini CLI and any skills.sh-compatible agent:
npx skills add Crypto-Data-API/cryptodataapi-skills -g -y
Prefer manual? curl -fsSL https://cryptodataapi.com/skill -o ~/.claude/skills/cryptodataapi/SKILL.md still works (single-file version). Full install options — including the claude.ai zip upload — on the Agent Skill page.
Read the regime → pick the strategies that fit it → size by per-coin risk → validate against history. Every step is one endpoint.
Long-horizon cycle state + the HMM market regime with calibrated probabilities.
GET /regimes/current
GET /quant/market
50 meta-baskets across 6 groups, each pre-mapped to the conditions it was built for.
GET /trading-strategy-baskets
GET /regimes
One bulk call: per-coin regime, probability buckets & vol-target multiplier for the whole universe.
GET /quant/coins/risk
GET /volatility/regime
Replay frozen daily snapshots — the full /daily payload, point-in-time, per date.
GET /backtesting/daily-snapshots
.../daily-snapshots/{date}
The whole loop in a few lines of Python (any language with HTTP works the same).
import requests BASE = "https://cryptodataapi.com/api/v1" H = {"X-API-Key": "cdk_live_yourkey"} # 1. One call for the whole market daily = requests.get(f"{BASE}/daily", headers=H).json() # 2. What regime are we in? regime = requests.get(f"{BASE}/regimes/current", headers=H).json() # 3. Which strategy baskets fit this regime? baskets = requests.get(f"{BASE}/trading-strategy-baskets", headers=H).json() # 4. Per-coin risk model for sizing (Pro) — one call, ~180 coins risk = requests.get(f"{BASE}/quant/coins/risk?horizon=24h", headers=H).json() for coin in risk["items"]: if coin["meta"]["status"] == "ok": size = base_size * coin["vol_target_multiplier"] # vol-targeted # 5. Backtest: replay historical regime states dates = requests.get(f"{BASE}/backtesting/daily-snapshots", headers=H).json() snap = requests.get(f"{BASE}/backtesting/daily-snapshots/2026-05-28", headers=H).json()
Agents can buy a Pro / Pro Plus subscription autonomously with USDC over the x402 protocol — no ETH for gas, no dashboard, no human in the loop. One endpoint handles the whole HTTP 402 → sign → settle → key flow.
POST with no payment header → receive a 402 with payment requirements (price, networks, facilitator).
Sign the USDC payment off-chain (EIP-712, zero gas) on Base, Ethereum, or Solana.
Re-POST with the x-payment header → the facilitator settles and you receive a Pro/Pro Plus API key.
# Step 1 — discover the 402 (price + networks) curl -X POST https://cryptodataapi.com/api/v1/payments/agent-subscribe \ -H "Content-Type: application/json" -d '{"plan":"monthly"}' # Step 2 — re-POST with the signed x-payment header to settle + receive the key
monthly = Pro, monthly_plus = Pro Plus. Current pricing is on the pricing page; settlement is instant.The free tier is a complete product — market health, regimes, sentiment, macro and full-universe funding/OI. Upgrade for full-universe quant signals, the regime engine & backtesting data.
| Tier | Rate limit | What agents get |
|---|---|---|
| Free | 5/min · 50/day | Coin profiles, market health, derivatives, Hyperliquid perps, sentiment, macro, /daily |
| Pro | 30/min · 10k/day | + the full-universe quant regime & forward-looking engines, /quant/coins/risk, all trading indicators, gamma exposure, whale activity, order-book depth, liquidation heatmaps, cycle indicators, ETF flows, options & on-chain analytics |
| Pro Plus | 60/min · 50k/day | + the historical & bulk-data layer — the 2020→now regime archive, market-health & whale-positioning history, deep klines/funding history & Parquet/CSV backtesting downloads |
/daily — one cached call replaces ~10; poll it hourly, not per-tick./quant/coins/risk and /quant/coins for the whole universe in one call instead of per-symbol loops.Cache-Control + X-Cache; data refreshes on fixed cadences (1–30 min), so polling faster wastes quota.insufficient_history / new_listing flags — quant/risk items carry data-quality meta so you can mark coins ineligible rather than guess.?format=markdown on supported endpoints for cleaner LLM context.Machine-readable API map for LLMs
Every endpoint, params & examples
3.0 spec for codegen & tools
Tiers + crypto / x402 payment
50 meta-baskets across 6 groups
HMM regime probabilities
14-overlay regime suite
MCP, Claude Code & backtesting
Missing an agent, a config that changed, or a step that didn't work? Tell us and we'll fix it.