The on-chain data API for crypto.
Leading digital asset data provider. Comprehensive market, on-chain and sentiment data — 8,000+ endpoints through one REST API.
{ "status": { "code": 200 }, "result": { "window": "day", "data": [ { "date": "YYYY-MM-DD", "reserve": 2711284.83, "reserve_usd": 220332223136.24 } ] }}Illustrative example — figures shown are not live data.
- #1
- Most cited on-chain data provider
- 250+
- Institutional clients
- 261K
- API requests per day
- 10M+
- Analyst KOL followers
What is the CryptoQuant Data API?
The CryptoQuant Data API is a REST API that returns crypto market data and on-chain data — exchange flows, miner flows, network and market indicators, derivatives and price data — as JSON time series across 200+ on-chain metrics. It starts on a free plan, scales by credits, and the same data is reachable from AI assistants through the CryptoQuant MCP server.
- Base URL
- https://api.cryptoquant.com/v1
- Authentication
- API key sent as a Bearer token in the Authorization header
- Response format
- JSON time series; every endpoint takes a window parameter
- Coverage
- 200+ on-chain metrics across 490+ assets: market data on every plan, on-chain data from Professional
- Free tier
- Basic (free): 10,000 credits per month, 10/min, 30 days of history
- AI access
- Remote MCP server at https://mcp.cryptoquant.com/mcp, same plan rules as the API
- Machine-readable
- OpenAPI v1 specification and a JSON metric catalog on the docs site
What you can pull
200+ on-chain metrics across 490+ assets — Bitcoin, Ethereum, XRP, TRON, stablecoins and ERC-20 tokens — from daily down to per-block resolution.
Market data
Price, OHLCV, funding rates, open interest, liquidations, and premium indices. No asset or endpoint is withheld — only the resolution changes by plan.
On-chain data
Exchange flows, miner flows, entity and inter-entity flows, network and flow indicators, mempool, Lightning, ETH2, and DeFi metrics.
Assets
- Bitcoin
- Ethereum
- XRP
- TRON
- Stablecoins
- ERC-20 tokens
- Alts
Endpoints are grouped by family — ERC-20 tokens, stablecoins, and alts each share one endpoint set.
Metric categories
- Exchange flows
- Miner flows
- Market indicators
- Network indicators
- Flow indicators
- Fund & ETF data
- Inter-entity flows
- Mempool
- Lightning
- ETH2 staking
- DEX & AMM
Want the exact endpoints, parameters, and response fields? They're all in the catalog, along with the assets each endpoint family covers.
Browse the metric catalogGet started in three steps
- 01
Create an API key
Generate a key from your account settings. The Basic plan is free to start on.
- 02
Make your first call
Send the key as a Bearer token. Every response is JSON, and every endpoint takes a window parameter for resolution.
- 03
Find the metric you need
The catalog lists every endpoint by asset and category, with parameters and response fields.
Your first call
curl -H "Authorization: Bearer $CQ_API_KEY" \
"https://api.cryptoquant.com/v1/btc/exchange-flows/reserve?exchange=all_exchange&window=day"Plans and credits
Every call draws down credits. Plan credits reset monthly on your billing date and do not roll over. Top-up credits are bought separately and expire 12 months after your most recent top-up. Plan credits are spent first.
| Plan | Monthly credits | Rate limit | History | On-chain data |
|---|---|---|---|---|
| Basic (free) | 10,000 | 10/min | 30 days | Not included |
| Advanced | 300,000 | 60/min | 1 year | Not included |
| Professional | 500,000 | 120/min | 1 year | Included |
| Premium | Unlimited | 800/min | Full history | Included |
Rate limits are a separate axis from credits — credits cap your monthly volume, rate limits cap how fast you can call. Running out of credits returns 402, not an authentication error.
Use it from AI agents and LLMs
CryptoQuant data reaches AI assistants two ways: the CryptoQuant MCP server for MCP-capable clients, and the REST Data API called as a tool from any agent framework. The AI Assistant in the app is the no-setup option. All three read the same live dataset.
Connect via MCP
A standard remote MCP server over Streamable HTTP with OAuth 2.0 (PKCE). Point any MCP-capable client at the server URL and ask about the market in plain language.
Call the Data API as a tool
Give your agent the REST endpoints directly: Bearer-token auth, JSON responses, and a machine-readable catalog of every endpoint, parameter and response field.
Try the AI Assistant
Ask on-chain questions inside the CryptoQuant app and explore cited sources. No setup, no key management.
MCP server URL
https://mcp.cryptoquant.com/mcpIt's a standard remote MCP server over Streamable HTTP, so any MCP-capable client can connect. Sign-in uses OAuth 2.0 with PKCE — choose your API key for a dedicated rate limit, or go keyless on a shared pool. Client-specific setup steps are in the guide for AI agents.
Tools the MCP server exposes
- discover_endpoints
- query_data
- get_endpoint_info
- describe_metric
- list_assets
- query_research
- query_quicktake
- recent_research
- recent_quicktake
Five for the data, four for the research. Your AI picks the right one on its own — you just ask the question. The catalog behind both the API and MCP is also published as JSON at https://docs.cryptoquant.com/catalog/catalog.json.
Why CryptoQuant vs. Dune / Nansen / Glassnode / Messari / Blockworks Research
CryptoQuant is on-chain first: exchange, miner, stablecoin and derivatives metrics come as ready-made REST endpoints and an MCP server, starting on a free plan. The table compares what each vendor documents on its official docs and pricing pages; empty cells mean we could not confirm the item there.
| Axis | CryptoQuant | Dune | Nansen | Glassnode | Messari | Blockworks Research |
|---|---|---|---|---|---|---|
| Exchange flows (on-chain) | Yes: inflow, outflow, netflow, reserve per exchange | Yes: curated "CEX Flows" dataset with entity identification | Yes: per-token CEX inflows and outflows (exchange label) | Yes: exchange inflow and outflow volumes | — | — |
| Miner flows | Yes: miner flows and miner reserves | — | — | Yes: miner balance and net position change | — | — |
| Stablecoin metrics | Yes: stablecoin endpoint family (USDT, USDC and more) | Yes: stablecoin transfers, balances and activity (gated collection) | — | Yes: for example Stablecoin Supply Ratio | Yes: stablecoin supply, usage and cross-network flows | Partial: per-chain stablecoin supply |
| Derivatives (funding, open interest) | Yes: funding rates, open interest, liquidations, taker buy/sell | Partial: Hyperliquid perpetuals tables (funding, hourly open interest) | Partial: Hyperliquid positions, trades and leaderboards | Yes: futures funding rate, open interest, volume | Yes: open interest and funding rate metrics | Partial: Polymarket open interest, Hyperliquid perps fees |
| How the data is produced | Proprietary exchange and miner address labeling; 200+ on-chain metrics across 490+ assets served from one catalog | Raw, decoded and curated tables indexed from nodes; you write the SQL | Proprietary wallet and entity labeling (500M+ labeled wallets) | Proprietary entity clustering heuristics and labels | Aggregated market and news data with human-curated research and events | Long-form research reports plus a curated protocol-metrics warehouse |
| API | REST API returning metric time series as JSON; machine-readable catalog and OpenAPI spec | REST API to execute SQL and fetch query results (query execution on Plus and Enterprise) | REST API returning analytics such as smart money, token flows and profiler data | REST API returning metric time series; API is a Professional add-on (Advanced has a limited daily-only Light API) | REST API returning asset metrics, exchange data, news and research; tiered by subscription | REST Data API (api.blockworks.com/v1) returning curated metrics and chart datasets |
| MCP / AI agents | Yes: remote MCP server (https://mcp.cryptoquant.com/mcp), nine tools, any MCP-capable client | Yes: official remote MCP server (api.dune.com/mcp/v1) | Yes: remote MCP server (mcp.nansen.ai) | Yes: MCP server (mcp.glassnode.com) | Yes: hosted MCP server (mcp.messari.io), Enterprise with AI Toolkit | — |
| Update frequency | Day, hour and minute (market) and block-level (on-chain) windows; resolution by plan | Raw data within minutes of finality; curated datasets refresh hourly | Near real time: typically seconds to a couple of minutes | 10-minute, 1-hour and 24-hour resolution by plan tier | 5-minute, 1-hour, 1-day and 1-week granularities | Daily |
| Free tier and entry price | Free Basic plan (10,000 credits/month, 30 days of history); paid plans on /pricing | Free (2,500 credits/month); Analyst $75/month; Plus $399/month | Free (100 one-time credits); Pro $49/month billed annually or $69/month | Free Standard plan (24-hour resolution); Advanced $49/month billed annually; Professional custom | — | No free tier; $1,350 per seat per quarter or $4,500 per seat per year |
| Built for | Traders, institutions and developers | "Every team operating in digital asset markets" | "Trade everything onchain with AI" | "Built for investing, trading, and research" | Enterprise and institutional teams | "Crypto executives, investors, builders" |
- CryptoQuant vs. Dune
- Dune indexes raw chain data into SQL tables and lets you write your own queries; curated datasets such as CEX flows refresh hourly and an official MCP server exists. CryptoQuant serves exchange, miner and derivatives metrics as ready-made time series, so you call an endpoint instead of writing and maintaining SQL.
- CryptoQuant vs. Nansen
- Nansen is built around wallet labeling and smart-money tracking, exposed through its API and MCP server. CryptoQuant focuses on exchange and miner entity flows, network and derivatives indicators for Bitcoin, Ethereum, stablecoins and alts, with block-level resolution on Premium.
- CryptoQuant vs. Glassnode
- Glassnode covers the same on-chain families (exchange, miner, stablecoin, derivatives) with 10-minute to daily resolution and has an MCP server; full API access is a Professional add-on. The CryptoQuant REST API starts on the free Basic plan, and MCP follows the same plan rules as the API.
- CryptoQuant vs. Messari
- Messari combines market data with human-curated research, news and events; its hosted MCP server requires an Enterprise subscription with the AI Toolkit. CryptoQuant is on-chain first: exchange and miner flows are native endpoints, and the MCP server is available under the same plan rules as the API.
- CryptoQuant vs. Blockworks Research
- Blockworks Research pairs long-form reports with a curated, daily-resolution protocol metrics API and no free tier. The CryptoQuant API updates at hour and block level for on-chain flows and has a free tier to start.
Last verified: 2026-09. Competitor facts are taken from each vendor's official documentation and pricing pages on that date; — marks items we could not confirm there. CryptoQuant facts come from cryptoquant.com and docs.cryptoquant.com.
Frequently Asked Questions
What data does the CryptoQuant API provide?
CryptoQuant covers two families of data. Market data — price, OHLCV, funding rates, open interest, liquidations, and premium indices — and on-chain data, including exchange flows, miner flows, entity and inter-entity flows, network indicators, flow indicators, mempool, Lightning, ETH2, and DeFi metrics. Together that's 200+ on-chain metrics across 490+ assets — Bitcoin, Ethereum, XRP, TRON, stablecoins, and ERC-20 tokens. Endpoints are grouped by family, so ERC-20 tokens, stablecoins, and alts each share one endpoint set.
Is there a free tier?
Yes. The Basic plan is free and includes 10,000 credits per month, market data at daily resolution, and 30 days of history. On-chain endpoints require a Professional plan or above.
What's the difference between market data and on-chain data access?
They are gated differently. Market data is available on every plan — no asset or endpoint is withheld, only the resolution changes: Basic gets daily, Advanced hourly or coarser, Professional and Premium down to the minute. On-chain data starts at Professional. Basic and Advanced do not have access. Professional gets daily resolution; Premium gets everything the endpoint supports, including hourly and per-block.
Why do exchange-flows, miner-flows, network-data or reserve endpoints return 403 on my plan?
Those are on-chain endpoints, and on-chain data starts at the Professional plan. Basic and Advanced include market data only (OHLCV, funding, open interest, liquidations, premium indices). A 403 means your plan does not include that endpoint; a 401 means the key is missing or wrong, and a 402 means you are out of credits. Professional serves on-chain data at daily resolution; Premium adds hourly and per-block.
How does the credit model work?
Every API call draws down credits. Plan credits are granted monthly by your subscription and reset every month on your billing date, regardless of whether you pay monthly or annually — unused plan credits do not roll over. Top-up credits are bought separately, are not part of the monthly reset, and expire 12 months after your most recent top-up; buying more extends the expiry on your whole remaining balance. Plan credits are spent first, then top-up credits.
What are the rate limits?
Rate limits are a separate axis from credits — credits cap your monthly volume, rate limits cap how fast you can call. Basic allows 10 requests per minute, Advanced 60, Professional 120, and Premium 800.
How far back does the history go?
Basic reaches back 30 days, Advanced and Professional 1 year, and Premium has full history. Professional is capped at one year; full history requires Premium, or a one-time bulk delivery arranged through sales.
What happens when I run out of credits?
The API returns 402 Payment Required — not an authentication error. A 401 means something is wrong with your key itself, not your balance. You can top up at any time and keep calling.
Can I use CryptoQuant data with AI assistants?
Yes — that's what the CryptoQuant MCP server is for. It connects the same dataset to Claude, Cursor, and other MCP-capable clients, so you can ask about exchange flows or miner activity in plain language instead of writing API calls yourself. Use the REST API when you are building something; use MCP when you are asking questions.
How do I authenticate and make a first request?
Create an API key in your account settings, then send it as a Bearer token in the Authorization header to https://api.cryptoquant.com/v1. Every response is JSON and every endpoint takes a window parameter (day, hour, minute or block, depending on the endpoint and your plan). The quickstart on the docs site walks through the first call.
My API key was exposed. How do I revoke it and get a new one?
Open Settings, then API, and click the refresh icon next to your key; a new key is issued and replaces the old one. Update every client that uses the key, and send keys in the Authorization header rather than the api_key query parameter so they do not end up in logs.
Is there an OpenAPI specification or a machine-readable catalog?
Yes. The docs site publishes an OpenAPI v1 specification and a JSON metric catalog that lists every endpoint, its parameters and the assets it covers, plus a docs llms.txt index for AI agents. Links to all three are on this page under "What is the CryptoQuant Data API?".
How often is the data updated?
Market data is served in day, hour and minute windows and on-chain data down to block level, with the available resolution set by your plan. Update timing differs by metric — the data latency guide on the docs site lists it per endpoint.
How does CryptoQuant compare with Glassnode, Dune, Nansen, Messari or Blockworks?
CryptoQuant is on-chain first: exchange flows, miner flows, stablecoin and derivatives metrics are ready-made REST endpoints, an MCP server exposes the same data to AI agents, and the API starts on a free plan. The comparison table on this page lists what each vendor documents on its official pages, with the date it was last verified.
Everything else is in the docs
Endpoint reference, the full metric catalog, formulas behind each indicator, and machine-readable exports for agents.