Stablecoin supply
Query circulating stablecoin supply and its per-chain distribution.
Available data
- Returns
- Query circulating stablecoin supply and its per-chain distribution.
- What each request returns
- One snapshot per stablecoin asset
Authentication
Query Parameters
Query a stablecoin asset; circulating supply is token quantity, not USD value
asset_idstringqueryExampleasset_token_tetheroptionalStablecoin asset ID, for example asset_token_tether
chainstringqueryoptionalChain slug, for example ethereum
Response
dataobject[]Business data; shape is specific to this endpoint
data_statusDataStatusBusiness status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage
errornull | string | objectNull on success; otherwise an error string or object
empty_reasonstringReason for an empty or unavailable result; may be absent
missing_fieldsstring[]Fields not supplied by the source
coverage_fromstringFirst date actually returned, not the requested start
coverage_tostringLast date actually returned, not a guarantee of continuous coverage
coverage_notestringCoverage and methodology notes
request_idstringRequest trace identifier
operation_idstringOperation identifier
route_codestringResponse route identifier
observed_atstringResponse observation time; not the business snapshot date
Response metadata
updated_atstringMetadata update time; not the business data time
object_refsobject[]Matched object references
limitationsstring[]Coverage or source limitations
asset_idstringCanonical asset identifier
symbolstringAsset or pool token symbol
namestringDisplay name
stablecoin_idstringSource stablecoin identifier; not a public asset_id
descriptionstringSource description
peg_typestringPeg type, for example peggedUSD
peg_mechanismstringPeg mechanism, for example fiat-backed
mint_redeem_descriptionstringIssuance and redemption description, when supplied
circulatingstringCirculating token quantity as a decimal string; not USD market value
Supply details
circulatingstringCirculating token quantity as a decimal string; not USD market value
peg_typestringPeg type, for example peggedUSD
mint_redeem_descriptionstringIssuance and redemption description, when supplied
chain_distributionobject[]Per-chain distribution
chain_idstringCanonical chain identifier
chainstringChain name
chain_namestringChain display name
circulatingstringCirculating token quantity as a decimal string; not USD market value
circulating_prev_daystringCirculating token quantity approximately one day earlier
circulating_prev_weekstringCirculating token quantity approximately one week earlier
circulating_prev_monthstringCirculating token quantity approximately one month earlier; not an exact 30-day change