Skip to main content
GET
cURL

What it measures

Exchange reserve divided by total supply — how much of the asset sits on a given exchange relative to everything in existence. The response carries both inputs alongside the ratio. 📖 Data Guide: Exchange Supply Ratio — definition, interpretation, and chart examples.

Assets and windows

This endpoint serves 4 asset classes. The available windows differ by class — a window that works for one asset can return 400 for another. The default window is day. A request for a window that the asset’s class does not support returns 400 and lists the windows that asset does support.
Bitcoin has no default window on this endpoint. day is not served for btc, so a request that omits window returns 400 for btc assets. Pass window=block explicitly.

Response fields

The time key depends on the window: datetime for day and blockheight plus datetime for block.

Authorizations

Authorization
string
header
required

For each API request, include the Authorization HTTP header with Bearer {access_token}.

Query Parameters

asset
string
required

Asset to query, by its CryptoQuant alias (no chain suffix — usdt, not usdt_eth). 275 assets are available on this endpoint, across the asset classes btc, erc20, eth, stablecoin. Enumerate them with /v2/discovery/endpoints.

chain
enum<string>

Chain the asset lives on. Optional for an asset that exists on exactly one chain, required when the same alias exists on several.

Available options:
bitcoin,
ethereum
exchange
string
required

Exchange name, e.g. binance. Use all_exchange for the aggregate across every tracked exchange. Enumerate the accepted values with /v2/discovery/endpoints.

window
enum<string>
default:day

Aggregation window. Which windows are valid depends on the asset — see the endpoint page. Defaults to day. No default for Bitcoin (btc) assets — pass window explicitly (block), or the request returns 400.

Available options:
day
from
string

Inclusive start time, YYYYMMDDTHHMMSS (UTC). If window=day, YYYYMMDD is also accepted.

to
string

Inclusive end time, YYYYMMDDTHHMMSS (UTC). If window=day, YYYYMMDD is also accepted.

limit
integer
default:100

Maximum rows returned (default 100, max 10000).

Required range: x <= 10000
format
enum<string>
default:json

Response format: json (default) or csv.

Available options:
json,
csv

Response

200 - application/json

Exchange Supply Ratio time-series.

status
object
required

Returned with every response; indicates whether the request was successful.

result
object
required