Supply Metrics
Interpret on-chain supply distribution, holder cohorts, age, dormancy, liquidity, and reserve metrics.
Supply metrics describe how units are distributed, aged, held, activated, vaulted, or attributed. Common families include circulating supply, supply in profit or loss, short-term and long-term holders, HODL waves, balance cohorts, free float, dormancy, liveliness, exchange reserves, treasuries, and entity balances.
#Common Dimensions
| Dimension | Questions it answers |
|---|---|
| Age | How long has the measured supply remained unmoved? |
| Balance | How much supply belongs to addresses or entities of a given size? |
| Profit state | Is supply above or below its estimated acquisition price? |
| Liquidity | Is supply active, vaulted, free floating, or attributed to custody? |
| Entity | Is supply associated with exchanges, funds, treasuries, or other labeled groups? |
#Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://chartinspect.com/api/v1/onchain/supply-in-profit-loss?chain=bitcoin&days=365"Supply units depend on the field suffix. Native-unit and USD fields must not be mixed. Cohort thresholds and entity attribution are source-defined and can differ by network. Use metric discovery for exact fields and All Metrics for asset coverage.
Was this page helpful?