Distribution

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=MKR&m=distribution.Balance1PctHolders
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see /endpoints)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval (only 24h)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595894400,
"v": 0.973287193289504
},
...
]
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=BAT&m=distribution.Gini
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see /endpoints)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval (only 24h)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595894400,
"v": 0.997019969881091
},
...
]
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=DAI&m=distribution.Herfindahl
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see /endpoints)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval (only 24h)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595894400,
"v": 0.000779761257081465
},
...
]
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=LINK&m=distribution.SupplyContracts
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see /endpoints)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval (only 24h)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595894400,
"v": 0.1218270686783
},
...
]
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
c
optional
string
currency usd or native (default)
a
required
string
asset symbol (see /endpoints)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval (10m, 1h, 24h)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595894400,
"v": 1818989.1895435925
},
...
]
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
c
optional
string
currency usd or native (default)
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval (only 24h)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595808000,
"o": {
"1THash&58COIN": 112.60482377,
"AntPool": 556.690282480001,
"BTC.TOP": 43.2448870099995,
"BTC.com": 332.5145992,
...
}
}
...
]
400: Bad Request
unsupported asset