Exchange reserves

Query the all-exchange BTC reserve total or reserves for one exchange and asset.

GET/api/v1/onchain/exchange-reserves
Domain
Network & Protocol
Level
An all-exchange aggregate, or one exchange split by asset and chain
MCP tool
exchange_reserves

Available data

Returns
Query the all-exchange BTC reserve total or reserves for one exchange and asset.
What each request returns
An all-exchange aggregate, or one exchange split by asset and chain

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Query example
Reserve query

Choose aggregate BTC reserves or one exchange. Aggregated and individual reserves must not be added together

exchange_idstringqueryExampleexchange_aggregatedoptional

Use exchange_aggregated for the all-exchange BTC total, or an exchange_* ID for per-exchange records. Omitting it can return both; do not sum them together

asset_idstringqueryExampleasset_btcoptional

Canonical asset ID

Response

asset_idstring

Asset identifier

coverage_notestring

Coverage and methodology notes

data[]object[]

Business data; shape is specific to this endpoint

amountstring

amount

amount_usdstring

amount_usd

assetstring

Asset symbol or scope

asset_idstring

Asset identifier

currency_symbolstring

currency_symbol

exchange_btc_reserve_totalstring

exchange_btc_reserve_total

exchange_idstring

exchange_id

exchange_namestring

exchange_name

exchange_reserve_snapshot_timedatetime

exchange_reserve_snapshot_time

reserveobject

reserve

amountstring

amount

amount_usdstring

amount_usd

snapshot_timedatetime

Observation time

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

errorunknown | null

Null on success; otherwise an error string or object

exchange_idstring

exchange_id

metadataobject

Response metadata

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

entitlementsobject

entitlements

endpointstring

endpoint

evidence_fanout_levelstring

evidence_fanout_level

field_levelstring

field_level

object_resolution_levelstring

object_resolution_level

limitations[]unknown[]

Additional information

object_refs[]unknown[]

object_refs

updated_atdatetime

Data update time

observed_atdatetime

Response observation time; not the business snapshot date

operation_idstring

Operation identifier

route_codestring

Response route identifier

Errors & fallback

200
No covered records for these filters. Empty arrays do not mean a measured zero.
400
Invalid parameter format, time range, scope, sorting or limit. Use the endpoint-specific rules above.
401
Check the API key.
403
Check data-domain permissions for the key.