Skip to main content
GET
List pegged-token supply flows (mint/burn velocity)

Authorizations

x-api-key
string
header
required

Query Parameters

chain
enum<string>

Filter to tokens with any supply on this chain. Whole-row counts — a multi-chain token contributes its full supply to the returned totals under every chain it appears on.

Available options:
eth,
arb,
opt,
pol,
base,
bsc,
sol,
tron
tokenType
enum<string>

Filter by backing mechanism Backing mechanism derived by the pipeline from the upstream peg mechanism.

Available options:
fiat,
crypto,
synthetic,
other
tier
enum<string>

Filter by risk tier denormalized at the supply pipeline's generated_at (not live). Rows with a null tier are excluded. Risk tier denormalized from the risk-monitor pipeline at the supply snapshot's generated_at (not live).

Available options:
critical,
warning,
watch,
ok
q
string

Case-insensitive substring match on symbol or name

Maximum string length: 100
address
string

Exact contract address (requires chain). Filters to the row whose per-chain address map carries this (chain, address), so a same-ticker token can never be returned. EVM addresses match case-insensitively.

sort
enum<string>
default:abs_net_24h

Default abs_net_24h surfaces the largest mint-or-burn moves first

Available options:
abs_net_24h,
pressure_vs_30d,
net_24h,
net_30d,
supply
order
enum<string>
default:desc
Available options:
asc,
desc
page
integer
default:1
Required range: x >= 1
pageSize
integer
default:50
Required range: 1 <= x <= 500

Response

Paginated supply-flow rows with aggregates over the filtered set

items
object[]
required
pagination
object
required
aggregates
object
required
generated_at
string<date-time> | null
required
stale
boolean
required

true when the snapshot is older than 25h or served from the fallback cache during an upstream data outage.

degraded
boolean
required

true only during a total supply-pipeline outage (stale snapshot AND zero tokens — the upstream data store is unavailable and the fallback cache is empty). Distinguishes "empty because the dataset is unavailable" from "genuinely empty": a fresh empty snapshot is stale: false, degraded: false. Same field on SupplyTokenResponse.