Distribution

Estimated Bitwise Bitcoin ETF Balance (BITB)

GET https://api.glassnode.com/v1/metrics/distribution/balance_bitwise

The BITB Balance metric aims to monitor and delineate the estimated Bitcoin balances held within the Bitwise Bitcoin ETF (BITB). This balance estimate is derived from a combination of on-chain analysis and Glassnode's clustering heuristics.

Disclaimer: The presented balance is an estimate based on on-chain data and clustering methods, and as such may not precisely match the actual BITB balance. For the most accurate and current balance information, and for a comprehensive understanding of BITB's historical evolution, it is advised to explore the official Bitwise BITB ETF website (https://bitbetf.com).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1706227200,"v":12840.05066248}]

Estimated BlackRock Bitcoin ETF Balance (IBIT)

GET https://api.glassnode.com/v1/metrics/distribution/balance_blackrock

The IBIT Balance metric is designed to dynamically track the estimated Bitcoin balances associated with the BlackRock Bitcoin ETF (IBIT) through on-chain data and Glassnode’s clustering heuristics. It’s important to note that, due to the inherent characteristics of on-chain analysis, this metric may not always precisely align with the officially reported numbers from the ETF issuer shown on the US Bitcoin Spot ETF Balances metric.

Disclaimer: For the most accurate balance information and a comprehensive understanding of IBIT’s historical evolution, we recommend exploring the official BlackRock IBIT ETF website (https://www.ishares.com/us/products/333011/ishares-bitcoin-trust).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1706227200,"v":49952.32576715}]

Estimated Franklin Templeton Bitcoin ETF Balance (EZBC)

GET https://api.glassnode.com/v1/metrics/distribution/balance_franklin_templeton

The EZBC Balance metric aims to monitor and delineate the estimated Bitcoin balances held within the Franklin Templeton Bitcoin ETF (EZBC). This balance estimate is derived from a combination of on-chain analysis and Glassnode's clustering heuristics.

Disclaimer: The presented balance is an estimate based on on-chain data and clustering methods, and as such may not precisely match the actual EZBC balance. For the most accurate and current balance information, and for a comprehensive understanding of EZBC's historical evolution, it is advised to explore the official Franklin Templeton EZBC ETF website (https://www.franklintempleton.com/investments/options/exchange-traded-funds/products/39639/SINGLCLASS/franklin-bitcoin-etf/EZBC).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1706227200,"v":1333.9999198}]

Estimated Grayscale Bitcoin ETF Balance (GBTC)

GET https://api.glassnode.com/v1/metrics/distribution/balance_grayscale_trust

The GBTC Balance metric aims to monitor and delineate the estimated Bitcoin balances held within the Grayscale Bitcoin ETF (GBTC) under Coinbase Custody. This balance estimate is derived from a combination of on-chain analysis and Glassnode's clustering heuristics.

Grayscale initially operated as a closed end fund, which allowed for both cash or in-kind share creation. The closed end fund had an annual fee of 2, and enabling NAV arbitrage via both share creation and redemption (cash only, not in-kind).

Disclaimer: The presented balance is an estimate based on on-chain data and clustering methods, and as such may not precisely match the actual GBTC balance. For the most accurate and current balance information, and for a comprehensive understanding of GBTC's historical evolution, it is advised to explore the official Grayscale GBTC ETF website (https://etfs.grayscale.com/gbtc).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":634140.25568613}]

Estimated VanEck Bitcoin ETF Balance (HODL)

GET https://api.glassnode.com/v1/metrics/distribution/balance_vaneck

The HODL Balance metric aims to monitor and delineate the estimated Bitcoin balances held within the VanEck Bitcoin ETF (HODL). This balance estimate is derived from a combination of on-chain analysis and Glassnode's clustering heuristics.

Disclaimer: The presented balance is an estimate based on on-chain data and clustering methods, and as such may not precisely match the actual HODL balance. For the most accurate and current balance information, and for a comprehensive understanding of HODL's historical evolution, it is advised to explore the official VanEck HODL ETF website (https://www.vaneck.com/us/en/investments/bitcoin-trust-hodl/overview/).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1706227200,"v":2885.70261729}]

Estimated WisdomTree Bitcoin ETF Balance (BTCW)

GET https://api.glassnode.com/v1/metrics/distribution/balance_wisdomtree

The BTCW Balance metric aims to monitor and delineate the estimated Bitcoin balances held within the WisdomTree Bitcoin ETF (BTCW). This balance estimate is derived from a combination of on-chain analysis and Glassnode's clustering heuristics.

Disclaimer: The presented balance is an estimate based on on-chain data and clustering methods, and as such may not precisely match the actual BTCW balance. For the most accurate and current balance information, and for a comprehensive understanding of BTCW's historical evolution, it is advised to explore the official WisdomTree BTCW ETF website (https://www.wisdomtree.com/investments/etfs/crypto/btcw).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1706227200,"v":201.80029614}]

Exchange Balance (Percent)

GET https://api.glassnode.com/v1/metrics/distribution/balance_exchanges_relative

The percent supply held on exchange addresses. Note that exchange metrics are based on our labeled data of exchange addresses that we constantly keep updating, as well as data science techniques and statistical information that changes over time. Therefore these metrics are mutable – the data is stable, but especially most recent data points are subject to slight fluctuations as time progresses.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

e

string

exchange name: aggregated, bibox, bigone, binance, bitfinex, bitget, bithumb, bitmex, bitstamp, bittrex, bybit, checksig.com, cobinhood, coinbase, coincheck, coinex, crypto.com, deribit, ftx, gate.io, gemini, hitbtc, huobi, korbit, kraken, kucoin, luno, nexo, okex, poloniex, swissborg, zb.com

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.1284068465323339}]

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YFI, ZRX

Exchange Balance (Stacked)

GET https://api.glassnode.com/v1/metrics/distribution/balance_exchanges_all

The total amount of coins held on exchange addresses. Note that exchange metrics are based on our labeled data of exchange addresses that we constantly keep updating, as well as data science techniques and statistical information that changes over time. Therefore these metrics are mutable – the data is stable, but especially most recent data points are subject to slight fluctuations as time progresses.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

e

string

exchange name: aggregated, bibox, bigone, binance, bitfinex, bitget, bithumb, bitmex, bitstamp, bittrex, bybit, checksig.com, cobinhood, coinbase, coincheck, coinex, crypto.com, deribit, ftx, gate.io, gemini, hitbtc, huobi, korbit, kraken, kucoin, luno, nexo, okex, poloniex, swissborg, zb.com

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"o":{"binance":641592.21663404,"bitfinex":301800.66523429,"bitget":9265.25319907,"bithumb":18213.87247473,"bitmex":64363.00146956,"bitstamp":43957.85492122,"bittrex":147187.68646248,"bybit":27974.69456272,"coinbase":486345.2170093,"coincheck":40471.38772284,"coinex":443.55379006,"crypto.com":45200.15842489,"deribit":43141.14883438,"ftx":38.01186916,"gate.io":13019.80271117,"gemini":129263.09343641,"hitbtc":52381.10027839,"huobi":47425.63727836,"korbit":7134.56866122,"kraken":171468.08802094,"kucoin":19481.42835416,"luno":6633.02520903,"okex":138405.16177085,"poloniex":20668.80205273,"swissborg":3342.9692122}}]

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YFI, ZRX

Exchange Balance (Total)

GET https://api.glassnode.com/v1/metrics/distribution/balance_exchanges

The total amount of coins held on exchange addresses. Note that exchange metrics are based on our labeled data of exchange addresses that we constantly keep updating, as well as data science techniques and statistical information that changes over time. Therefore these metrics are mutable – the data is stable, but especially most recent data points are subject to slight fluctuations as time progresses.

STBL: The total amount of coins held on exchange addresses. Note that exchange metrics are based on our labeled data of exchange addresses that we constantly keep updating, as well as data science techniques and statistical information that changes over time. Therefore these metrics are mutable – the data is stable, but especially most recent data points are subject to slight fluctuations as time progresses.

STBL is a virtual asset that aggregates the data of all ERC20 stablecoins supported on Glassnode, thereby creating a metric that sums up all exchange balances across stablecoins. Stablecoins included are: BUSD, GUSD, HSUD, DAI, USDP, EURS, SAI, sUSD, USDT, USDC.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

e

string

exchange name: aggregated, bibox, bigone, binance, bitfinex, bitget, bithumb, bitmex, bitstamp, bittrex, bybit, checksig.com, cobinhood, coinbase, coincheck, coinex, crypto.com, deribit, ftx, gate.io, gemini, hitbtc, huobi, korbit, kraken, kucoin, luno, nexo, okex, poloniex, swissborg, zb.com

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2479218.3995942003}]

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, STBL, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YFI, ZRX

Exchange Net Position Change

GET https://api.glassnode.com/v1/metrics/distribution/exchange_net_position_change

The 30d change of the supply held in exchange wallets.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

e

string

exchange name: aggregated, bibox, bigone, binance, bitfinex, bitget, bithumb, bitmex, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, crypto.com, deribit, ftx, gate.io, gemini, hitbtc, huobi, korbit, kraken, kucoin, luno, nexo, okex, poloniex, swissborg, zb.com

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":21742.868478069548}]

Supported asset symbols: BTC, ETH, 1INCH, AAVE, ABT, AMP, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, WETH, wNXM, YAM, YFI, ZRX

Gini Coefficient

GET https://api.glassnode.com/v1/metrics/distribution/gini

The gini coefficient for the distribution of coins over addresses. Exchange addresses, smart contract addresses, and other special asset-specific addresses (e.g. team fund addresses) are excluded for the computation of the gini.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.9964417812703422}]

Supported asset symbols: ETH, AAVE, ABT, AMPL, ANT, BADGER, BAL, BAND, BAT, BNT, BOND, BRD, BUSD, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, DAI, DDX, DENT, DHT, DODO, DRGN, ELF, ENG, ENJ, EURS, FET, FTT, FUN, GNO, GUSD, HEGIC, HOT, HT, HUSD, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RDN, REN, REP, RLC, ROOK, RPL, RSR, SNT, SNX, STAKE, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, wNXM, YAM, YFI, ZRX

Herfindahl Index

GET https://api.glassnode.com/v1/metrics/distribution/herfindahl

Originally used as a measure of competition, we adapt the Herfindahl Index as a metric for decentralization. It measures the addresses' shares of the current supply, and is defined as the sum of weighted address balances in the network. A large score indicates high concentration of supply, whereas a small score is an indicator for more evenly distributed funds across addresses. Exchange addresses, smart contract addresses and other special asset-specific addresses (e.g. team fund addresses) are excluded.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.000691835491500587}]

Supported asset symbols: ETH, AAVE, ABT, AMPL, ANT, BADGER, BAL, BAND, BAT, BNT, BOND, BRD, BUSD, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, DAI, DDX, DENT, DHT, DODO, DRGN, ELF, ENG, ENJ, EURS, FET, FTT, FUN, GNO, GUSD, HEGIC, HOT, HT, HUSD, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RDN, REN, REP, RLC, ROOK, RPL, RSR, SNT, SNX, STAKE, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, wNXM, YAM, YFI, ZRX

Luna Foundation Guard Balance

GET https://api.glassnode.com/v1/metrics/distribution/balance_luna_foundation_guard

The Luna Foundation Guard Balance corresponds to the amount of BTC held in addresses of the Luna Foundation Guard (LFG), which controls the bitcoin reserve supporting the TerraUSD (UST) stablecoin.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":313.0012177}]

Miner Balance

GET https://api.glassnode.com/v1/metrics/distribution/balance_miners_sum

The total supply held in miner addresses.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

miner

string

miner name (see /v1/metrics/distribution/balance_miners_sum/miners for a full list)

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1814702.9417940201}]

Miner Balance (Stacked)

GET https://api.glassnode.com/v1/metrics/distribution/balance_miners_all

The total supply held in miner addresses.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"balances":{"1THash&58COIN":0.0001,"AntPool":167.18562188,"ArkPool":0.36335538,"BTC.TOP":5.32573193,"BTC.com":19.44769764,"BinancePool":31853.46375059,"BitFury":0.04321233,"BitMinter":0.00007497,"Bixin":69.23008853,"DPool":0,"F2Pool":10083.49129944,"FoundryUSAPool":1084.0068904,"Genesis":72.59602383,"HuobiPool":0.00220738,"KuCoinPool":0.00005888,"Lubian.com":14139.45897255,"LuxorTech":25.18883908,"MaraPool":8288.9018889,"NovaBlock":0,"OKExPool":0.01714638,"Patoshi":1096203.67303751,"PegaPool":37.84485516,"Poolin":12.81105916,"SBICrypto":142.43854559,"SigmaPool":4.70914382,"SlushPool":175.16084665,"SpiderPool":0.00974901,"TerraPool":6.89335102,"UKRPool":0.00614802,"Ultimus":19.42284773,"ViaBTC":38.52586475,"other":652252.72338551}}]

Miner Net Position Change

GET https://api.glassnode.com/v1/metrics/distribution/balance_miners_change

The 30d change of the supply held in miner addresses.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":-1273.36572048836}]

Mt. Gox Balance

GET https://api.glassnode.com/v1/metrics/distribution/balance_mtgox_trustee

The Mt. Gox Trustee Balance corresponds to the amount of BTC held in addresses controlled by Nobuaki Kobayashi, the trustee overseeing the Mt. Gox civil rehabilitation proceedings.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":137890.98072002}]

Mt. Gox Outflows

GET https://api.glassnode.com/v1/metrics/distribution/outflows_mtgox_trustee

This metric traces the movement of BTC from the balances held by Nobuaki Kobayashi, the trustee supervising the civil rehabilitation proceedings of Mt. Gox. It presents a comprehensive timeline of BTC transactions flowing from Mt. Gox to individual exchanges or other recognized entities, helping track the redistribution of these assets over time.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"o":{"external":64214.92495,"mtgox-trustee":137891.07452002}}]

OTC Desks Holdings

GET https://api.glassnode.com/v1/metrics/distribution/balance_otc_desks

The cumulative balance of cryptocurrencies stored in addresses associated with Over-The-Counter (OTC) desks is represented in this metric. It encompasses data from three specific OTC desks known to us, thus providing a glimpse into the broader OTC market activity, albeit not its entirety.

Please note, our OTC balance figures are derived from carefully curated datasets that are regularly updated, alongside advanced data analytics and evolving statistical methodologies. Consequently, while our data is reliable, it is important to acknowledge that the most recent figures may exhibit minor adjustments as new information becomes available and our models are refined.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":4913.32534721}]

Proof of Reserves

GET https://api.glassnode.com/v1/metrics/distribution/proof_of_reserves

Proof-of-Reserves refers to the on-chain reserves as officially disclosed by exchanges. This metric denotes the total balance on self-reported exchange addresses. Note that we only incorporate Bitcoin and Ethereum addresses, other blockchains/L1s are not included. The proof-of-reserve data differs from our exchange balance metrics as they stricly monitor the balance on officially communicated exchange addresses, which are only a subset of all addresses included in our more comprehensive exchange metrics. For more information please see our article on proof-of-reserve metrics.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

c

string

currency: USD, NATIVE

e*

string

exchange name: binance, bitfinex, bitget, bitmex, bybit, checksig.com, coinex, crypto.com, deribit, gemini, huobi, korbit, kucoin, okex, swissborg

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":64363.0014695601}]

Supported asset symbols: BTC, ETH, AAVE, ABT, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BRD, BUSD, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, DAI, DDX, DENT, DHT, DODO, DRGN, ELF, ENG, ENJ, EURS, FET, FTT, FUN, GNO, GUSD, HEGIC, HOT, HT, HUSD, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, MIR, MKR, MLN, MTA, MTL, NEXO, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PNK, PNT, POLY, POWR, PPT, QASH, QKC, QNT, RDN, REN, REP, RLC, ROOK, RSR, SAND, SHIB, SNT, SNX, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, UMA, UNI, USDC, USDK, USDP, USDT, UTK, WaBi, WBTC, WETH, wNXM, YFI, ZRX

Proof of Reserves (All assets)

GET https://api.glassnode.com/v1/metrics/distribution/proof_of_reserves_all

Proof-of-Reserves refers to the on-chain reserves as officially disclosed by exchanges. This metric denotes the total balance (in USD) of the biggest holdings on self-reported exchange addresses. We explicitly show at most the top 10 assets (by balance) and combine all others into the 'Other' category. Note that we only incorporate Bitcoin and Ethereum addresses, other blockchains/L1s are not included. Therefore 'Other' should be considered as a lower bound of additional exchange holdings. The proof-of-reserve data differs from our exchange balance metrics as they stricly monitor the balance on officially communicated exchange addresses, which are only a subset of all addresses included in our more comprehensive exchange metrics. For more information please see our article on proof-of-reserve metrics.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

e*

string

exchange name: binance, bitfinex, bitget, bitmex, bybit, checksig.com, coinex, crypto.com, deribit, gemini, huobi, korbit, kucoin, okex, swissborg

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"o":{"BTC":1439106330.12538}}]

Proof of Reserves (Current)

GET https://api.glassnode.com/v1/metrics/distribution/proof_of_reserves_all_latest

Proof-of-Reserves refers to the on-chain reserves as officially disclosed by exchanges. This metric denotes the latest balance on self-reported exchange addresses and their corresponding change over the last 24 hours. We explicitly show at most the top 10 assets (by balance) and combine all others into the 'Other' category. Note that we only incorporate Bitcoin and Ethereum addresses, other blockchains/L1s are not included. Therefore 'Other' should be considered as a lower bound of additional exchange holdings. The proof-of-reserve data differs from our exchange balance metrics as they stricly monitor the balance on officially communicated exchange addresses, which are only a subset of all addresses included in our more comprehensive exchange metrics. For more information please see our article on proof-of-reserve metrics.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

i

string

frequency interval: 24h

f

string

format: JSON

c

string

currency: USD, NATIVE

e*

string

exchange name: binance, bitfinex, bitget, bitmex, bitstamp, bybit, checksig.com, coinex, crypto.com, deribit, gemini, huobi, korbit, kucoin, okex, swissborg

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

{"balances":{"BTC":3971887346.82174},"changes":{"BTC":-33231700.4136086},"t":1712793600}

Supply in Smart Contracts

GET https://api.glassnode.com/v1/metrics/distribution/supply_contracts

The percent of total supply of the token that is held in smart contracts.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.2678673945870831}]

Supported asset symbols: ETH, AAVE, ABT, AMPL, ANT, BADGER, BAL, BAND, BAT, BNT, BOND, BRD, BUSD, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, DAI, DDX, DENT, DHT, DODO, DRGN, ELF, ENG, ENJ, EURS, FET, FTT, FUN, GNO, GUSD, HEGIC, HOT, HT, HUSD, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RDN, REN, REP, RLC, ROOK, RPL, RSR, SNT, SNX, STAKE, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, wNXM, YAM, YFI, ZRX

Supply of Top 1% Addresses

GET https://api.glassnode.com/v1/metrics/distribution/balance_1pct_holders

The percentage of supply held by the top 1% addresses. Exchange addresses, smart contract addresses, and other special asset-specific addresses (e.g. team fund addresses) are excluded.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.9660495330977973}]

Supported asset symbols: ETH, AAVE, ABT, AMPL, ANT, BADGER, BAL, BAND, BAT, BNT, BOND, BRD, BUSD, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, DAI, DDX, DENT, DHT, DODO, DRGN, ELF, ENG, ENJ, EURS, FET, FTT, FUN, GNO, GUSD, HEGIC, HOT, HT, HUSD, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RDN, REN, REP, RLC, ROOK, RPL, RSR, SNT, SNX, STAKE, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, wNXM, YAM, YFI, ZRX

US Government Balance

GET https://api.glassnode.com/v1/metrics/distribution/balance_us_government

The US Government Balance corresponds to the amount of BTC held in addresses controlled by US authorities. The metric is based on publicly available information and includes seized funds, e.g. from the 2016 Bitfinex Hack or the 2012 Silk Road Hack. We constantly keep updating the set of addresses contributing to the total balance.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":230115.88004859}]

Wrapped BTC (WBTC) Balance

GET https://api.glassnode.com/v1/metrics/distribution/balance_wbtc

Wrapped Bitcoin (WBTC) is the first ERC20 token backed 1:1 with Bitcoin and designed to act as representation of Bitcoin on the Ethereum blockchain. The WBTC supply listed here corresponds to the amount of Bitcoin held by BitGo, the custodian responsible for minting new WBTC ERC20 tokens and guaranteeing backing of new ERC20 tokens by actual BTC.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":153191.02904093}]

Last updated