Get supply-flow detail for a single token by symbol

Case-insensitive symbol lookup. For symbols that collide across tokens, supply canonicalId to pin a deterministic row, or tokenType as a soft disambiguator; otherwise the largest-supply token wins (and the collision is logged server-side). Returns 404 when the symbol is absent from a resolved snapshot, or when canonicalId is supplied but no row matches that {symbol, canonicalId} pair. During partial outage (stale cache, known symbol) the response carries stale: true; during total outage (fallback cache also empty) returns 503 so clients can distinguish a retryable outage from a permanent 404.

CU cost: 1 CU per request (rwa-supply-detail).

Path Params
string
required

Token symbol (case-insensitive, e.g. USDT)

Query Params
string

Canonical override — pins the response to the row with this canonical id. Use for stable URLs on long-tail symbols that may collide later.

string
enum

Soft disambiguator when canonicalId is not supplied

Allowed:
Responses

400

Invalid tokenType

404

Symbol not found in supply dataset (or {symbol, canonicalId} pair mismatch)

503

Supply dataset temporarily unavailable (S3 outage AND fallback cache empty)

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json