Addresses_by_BTC_sumBTC
Tech spec
| Field | Value |
|---|---|
| API name (slug) | addresses_by_btc_sumbtc |
| Group | address statistics |
| Unit / Valuetype | btc / other |
| Shape | binned |
| Resolutions | d1 |
| Endpoints | /v2/address_statistics |
| Tier | 0 |
| Last updated | 2026-01-05 21:56 UTC |
| Docs | Open in Swagger |
Brief Description: Addresses_by_BTC_sumBTC buckets addresses into balance cohorts based on the total BTC in their unspent outputs (UTXOs) at a given block height.
Advanced Explanation
On the Bitcoin blockchain, an address is not the same as an unspent transaction output (UTXO).
- A UTXO is a specific, spendable output defined by exactly one locking script (scriptPubKey).
- For most standard output types, that locking script can be encoded as a single address (e.g., P2PKH, P2WPKH, P2TR; and script-hash forms such as P2SH/P2WSH).
- A single address can be associated with multiple UTXOs, because multiple transactions can create distinct outputs that pay to the same address/locking script. The “balance” of an address is therefore the sum of the values of its UTXOs.
A precision note: while every UTXO has exactly one locking script, not every locking script has a standard address representation (e.g., certain non-standard or provably unspendable scripts). In typical wallet-driven activity, however, the vast majority of spendable outputs map cleanly to standard address formats.
What Addresses_by_BTC_sumBTC measures Addresses_by_BTC_sumBTC aggregates BTC across all addresses and reports the distribution by address balance cohort (i.e., by how much BTC is locked to each address), producing cohort-level counts and BTC totals.
Metric variants The family of metrics consist of:
_N: Number of addresses in each BTC balance cohort._sumBTC: Total BTC held by addresses in each cohort (sum of address balances)._avgBTC: Mean address balance within each cohort._medianBTC: Median address balance within each cohort.