API v2 is in preview — this guide will be finalized alongside the v2 GA release.
v2 does not replace v1 — it adds a curated indicator layer on top of it.
| API v1 | API v2 |
|---|
| Scope | 242 endpoints of raw on-chain, market, and flow data across BTC/ETH/XRP/TRX/Stablecoin/ERC20 | Curated research-grade indicators (demand, valuation, price models, P&L, risk) |
| Path scheme | /v1/{asset}/{category}/{metric} | /v2/{domain}/{category}/{metric} |
| Best for | Building your own models from raw data | Consuming battle-tested signals with documented thresholds |
What you don’t need to change
- Authentication (Bearer token or
api_key query parameter)
- The
status / result response envelope
window, from, to, limit parameters
Example
# v1: raw exchange reserve
curl "https://api.cryptoquant.com/v1/btc/exchange-flows/reserve?exchange=binance&window=day" \
-H "Authorization: Bearer $ACCESS_TOKEN"
# v2: curated valuation indicator
curl "https://api.cryptoquant.com/v2/indicator/valuation/mvrv-z-score?window=day" \
-H "Authorization: Bearer $ACCESS_TOKEN"
Deprecation
v1 remains fully supported. Any future deprecation will be announced in the
changelog well in advance.