Stablecoin supply

Query circulating stablecoin supply and its per-chain distribution.

GET/api/v1/onchain/stablecoins
Domain
Network & Protocol
Level
One snapshot per stablecoin asset
MCP tool
stablecoin_supply

Available data

Returns
Query circulating stablecoin supply and its per-chain distribution.
What each request returns
One snapshot per stablecoin asset

Authentication

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

Query Parameters

Stablecoin identification

Query a stablecoin asset; circulating supply is token quantity, not USD value

asset_idstringqueryExampleasset_token_tetheroptional

Stablecoin asset ID, for example asset_token_tether

chainstringqueryoptional

Chain slug, for example ethereum

Response

dataobject[]

Business data; shape is specific to this endpoint

data_statusDataStatus

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

errornull | string | object

Null on success; otherwise an error string or object

empty_reasonstring

Reason for an empty or unavailable result; may be absent

missing_fieldsstring[]

Fields not supplied by the source

coverage_fromstring

First date actually returned, not the requested start

coverage_tostring

Last date actually returned, not a guarantee of continuous coverage

coverage_notestring

Coverage and methodology notes

request_idstring

Request trace identifier

operation_idstring

Operation identifier

route_codestring

Response route identifier

observed_atstring

Response observation time; not the business snapshot date

metadataobject

Response metadata

updated_atstring

Metadata update time; not the business data time

object_refsobject[]

Matched object references

limitationsstring[]

Coverage or source limitations

data[]array[object]
asset_idstring

Canonical asset identifier

symbolstring

Asset or pool token symbol

namestring

Display name

stablecoin_idstring

Source stablecoin identifier; not a public asset_id

descriptionstring

Source description

peg_typestring

Peg type, for example peggedUSD

peg_mechanismstring

Peg mechanism, for example fiat-backed

mint_redeem_descriptionstring

Issuance and redemption description, when supplied

circulatingstring

Circulating token quantity as a decimal string; not USD market value

supplyobject

Supply details

circulatingstring

Circulating token quantity as a decimal string; not USD market value

peg_typestring

Peg type, for example peggedUSD

mint_redeem_descriptionstring

Issuance and redemption description, when supplied

chain_distributionobject[]

Per-chain distribution

chain_distribution[]array[object]
chain_idstring

Canonical chain identifier

chainstring

Chain name

chain_namestring

Chain display name

circulatingstring

Circulating token quantity as a decimal string; not USD market value

circulating_prev_daystring

Circulating token quantity approximately one day earlier

circulating_prev_weekstring

Circulating token quantity approximately one week earlier

circulating_prev_monthstring

Circulating token quantity approximately one month earlier; not an exact 30-day change

Errors & fallback

200
No covered records for these filters. Empty arrays do not mean a measured zero.
400
The supplied ID belongs to another object type.
401
Check the API key.
403
Check data-domain permissions for the key.