Distribution

get
Exchange Balance (Total)

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. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceExchanges
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h, 10m
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
e
optional
string
exchange name (see endpoints for a full list)
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":2582443.1577076004}]
400: Bad Request
unsupported asset

get
Exchange Balance (Percent)

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: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceExchangesRelative
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h, 10m
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":0.1393423534312515}]
400: Bad Request
unsupported asset

get
Exchange Balance (Stacked)

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: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceExchangesAll
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"o":{"binance":292136.24988915,"bitfinex":66471.26393123,"bitmex":102258.37507591,"bitstamp":119084.32256057,"bittrex":96961.77811651,"coinbase":1016245.24704058,"coincheck":33503.10809714,"gate.io":18834.92493329,"gemini":182729.46606801,"hitbtc":65689.67819234,"huobi":204089.6699911,"kraken":158118.9946432,"luno":16644.61363684,"okex":160857.1198489,"poloniex":48818.34568283}}]
400: Bad Request
unsupported asset

get
Miner Balance (Stacked)

https://api.glassnode.com/v1/metrics/distribution/balance_miners_all
The total supply held in miner addresses . View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceMinersAll
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"balances":{"1THash&58COIN":112.17574168,"AntPool":327.68811519,"BTC.TOP":66.4230058899995,"BTC.com":254.81413283,"BinancePool":4388.38069988,"BitFury":0.0353880900019305,"BitMinter":0.000074969999987672,"Bitcoin.com":0.636732029999978,"BitcoinRussia":0,"Bixin":69.2300885299999,"BytePool":0.0013742199999871,"DPool":2.66453525910038e-14,"Eobot":5.6843418860808e-14,"F2Pool":9416.47780725,"Genesis":68.35354006,"HuobiPool":197.39069915,"KanoPool":0.0399221600000637,"Lubian.com":11836.55932432,"MiningCity":2.1316282072803e-14,"NovaBlock":-1.4210854715202e-14,"OKExPool":171.08273367,"Patoshi":1096202.41546181,"Polmine.pl":0.000789800000007105,"Poolin":4865.57903618,"SigmaPool":1.02827961000001,"SlushPool":41.6754786700013,"SpiderPool":8.04335535,"Tigerpool":1.22180404,"UKRPool":26.14818543,"ViaBTC":85.6169056599997,"other":700093.347468135,"solo.ckpool.org":7.90049441999992,"taal.com":4.90718576884319e-14}}]
400: Bad Request
unsupported asset

get
Miner Net Position Change

https://api.glassnode.com/v1/metrics/distribution/balance_miners_change
The 30d change of the supply held in miner addresses. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceMinersChange
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":802.259993599961}]
400: Bad Request
unsupported asset

get
OTC Desks Holdings

https://api.glassnode.com/v1/metrics/distribution/balance_otc_desks
The total amount of coins held on OTC desk addresses. This data is based on three different OTC desks. Note that OTC metrics are based on our labeled data 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: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceOtcDesks
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":9682.26591339979}]
400: Bad Request
unsupported asset

get
Supply of Top 1% Addresses

https://api.glassnode.com/v1/metrics/distribution/balance_1pct_holders
The percentage of supply held by the top 1% addresses. For Bitcoin we use entities (cluster of addresses controlled by the same network entity) rather than addresses. Exchange addresses/entities, smart contract addresses, and other special asset-specific addresses (e.g. team fund addresses) are excluded. View in Studio: https://studio.glassnode.com/metrics?a=ETH&m=distribution.Balance1PctHolders
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":0.97088678206754}]
400: Bad Request
unsupported asset

get
Gini Coefficient

https://api.glassnode.com/v1/metrics/distribution/gini
The gini coefficient for the distribution of coins over addresses. For Bitcoin we use entities (cluster of addresses controlled by the same network entity) rather than addresses for the computation of this metric. Exchange addresses/entities, 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: https://studio.glassnode.com/metrics?a=ETH&m=distribution.Gini
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":0.996618963172237}]
400: Bad Request
unsupported asset

get
Herfindahl Index

https://api.glassnode.com/v1/metrics/distribution/herfindahl
Originally used as a measure of competition (https://en.wikipedia.org/wiki/Herfindahl–Hirschman_Index), 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. For Bitcoin we use entities (cluster of addresses controlled by the same network entity) rather than addresses. Exchange addresses/entities, smart contract addresses and other special asset-specific addresses (e.g. team fund addresses) are excluded. View in Studio: https://studio.glassnode.com/metrics?a=ETH&m=distribution.Herfindahl
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":0.000787162372716807}]
400: Bad Request
unsupported asset

get
Supply in Smart Contracts

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: https://studio.glassnode.com/metrics?a=ETH&m=distribution.SupplyContracts
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":0.165576685793455}]
400: Bad Request
unsupported asset

get
Miner Balance

https://api.glassnode.com/v1/metrics/distribution/balance_miners_sum
The total supply held in miner addresses . View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=distribution.BalanceMinersSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
miner
optional
string
miner name (see /v1/metrics/distribution/balance_miners_sum/miners for a full list)
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1604361600,"v":1828242.2666390252}]
400: Bad Request
unsupported asset