Query the chain · Supply metrics

Bitcoin supply metrics API: supply in profit, HODL waves and exchange supply

How the bitcoin supply is distributed says a lot about who holds it and at what cost. Supply in profit counts the coins whose last on-chain move happened below the current price; supply in loss counts the rest. HODL waves band the whole supply by how long each coin has sat unspent, so you can see how much is held by long-term holders versus recently moved. Supply on exchanges tracks how many coins sit at labeled exchange addresses. The Bitcoin supply metrics API computes all of these from the fully-indexed chain, valuing coins against historical market data where a metric needs price.

Pull a single current figure over REST for a dashboard, or run SQL to rebuild the full HODL waves series, split supply in profit and loss at any price, or measure the balance held by a labeled entity over time. Because UTXOs, coin ages, entity labels and the price series share one schema, every supply reading traces back to the coins behind it rather than a black-box aggregate. This is informational on-chain data and analytics for research, not a trading signal, a valuation, or investment advice.

or try it below ↓

REST API · SQL · dashboards · indexed from genesis

Query Console

BTC address or sample query

btc

try:

Hit Run to query the fully-indexed Bitcoin blockchain.

BTC

30-day trend

informational on-chain data · not financial advice

REST API · SQL · dashboards, one indexed dataset. Querying the indexed Bitcoin blockchain ...

REST API SQL DASHBOARDS WEBHOOKS CSV EXPORT

Indexed from genesis queryable in seconds

On-chain data not financial advice

Why it works

What you get with supply metrics

Supply in profit and loss

For any price, split the circulating supply into coins last moved below it (in profit) and above it (in loss), computed from every UTXO valued at its creation price, so you can see how much of the supply is above or under water at a glance.

HODL waves and coin age

Band the whole supply by how long each coin has stayed unspent, from under a day to over ten years, to measure long-term-holder supply, watch old coins wake up, or rebuild the full realized-cap-weighted HODL waves series in SQL.

Exchange and entity supply

Track how many coins sit at labeled exchange, miner or service addresses over time, so supply on exchanges, miner balances and the reserves of a specific entity are queryable series rather than one-off snapshots you have to reconstruct.

What it handles

The indexed Bitcoin chain, queryable your way

Look up an address, a transaction, a UTXO, the rich list or an on-chain metric, by REST API, SQL or dashboard. The same authoritative data, reconciled block-by-block against the canonical chain, without running a node.

Split supply in profit from supply in loss at any price
Build HODL waves by coin age band
Track supply held on labeled exchanges over time
Measure long-term-holder versus short-term-holder supply
Rebuild any supply series from UTXOs in SQL

GET /v1/address/{addr} query result

200 · JSON

{
  "address": "bc1qxy2k…l0wdv8",
  "balance_btc": 68432.10,
  "balance_usd": 4612165420,
  "tx_count": 1284,
  "unspent_outputs": 37,
  "first_seen": "2014-02-09"
}

indexed from genesis · to the satoshi ✓ reconciled block-by-block

Why BitcoinDatabase

One platform, queryable three ways

Not a raw node to sync, not an indexer to build, and not five vendors to stitch together. The fully-indexed Bitcoin blockchain, available as a REST API, as SQL, and as dashboards, on one authoritative dataset.

REST API

Typed JSON for addresses, transactions, balances, UTXOs and metrics. Drop it into apps, wallets, explorers and agents with curl, Python or our SDKs.

SQL access

Run SQL directly against the indexed Bitcoin dataset for ad-hoc analysis, cohorts and exports, the same data the API and dashboards read from.

Compliance-first

Informational on-chain data and analytics only. Entity labels and flow tracing are framed as tooling to support a regulated team's own review, not accusations.

Good questions

Questions about supply metrics

Supply in profit is the number of coins whose last on-chain move happened at a price below the current price, so they would be in profit if sold now; supply in loss is the rest. BitcoinDatabase computes it from every UTXO valued at its creation price, as informational on-chain data, not a valuation or trading signal.

HODL waves group the entire bitcoin supply into bands by how long each coin has stayed unspent, from under a day up to more than ten years. They show how much supply is held by long-term holders versus recently moved coins. BitcoinDatabase builds them from coin ages on the indexed chain and can weight them by realized value.

Read every Bitcoin API question

Explore more

See every use case See pricing Back to the Bitcoin API

Stop running a node. Just query Bitcoin.

Run your first query now and get on-chain data back by REST API, SQL or dashboard, indexed from the genesis block. Informational on-chain data only, not financial advice.

See pricing

Indexed from genesis · REST · SQL · dashboards · addresses, transactions, UTXOs, metrics