Entities

get
New Entities

https://api.glassnode.com/v1/metrics/entities/new_count
The number of unique entities that appeared for the first time in a transaction of the native coin in the network. Entities are defined as cluster of addresses that are controlled by one entity and are estimated through Glassnode's internal flags database as well as proprietary clustering algorithms. Note that entity–based metrics are based on clustering and data science techniques and therefore mutable – the data is stable, but recent datapoints are subject to minor fluctuations. The computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.NewCount
Request
Response
Request
Query Parameters
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, 1h or 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1548547200,
"v": 73484
},
...
]
400: Bad Request
unsupported asset

get
Entities Net Growth

https://api.glassnode.com/v1/metrics/entities/net_growth_count
The net growth of unique entities in the network. This metric is defined as the difference between new entities and "disappearing" entities (entities with a zero balance that had a non–zero balance at the previous timestamp). Entities are defined as cluster of addresses that are controlled by one entity and are estimated through Glassnode's internal flags database as well as proprietary clustering algorithms. Note that entity–based metrics are based on clustering and data science techniques and therefore mutable – the data is stable, but recent datapoints are subject to minor fluctuations. The computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.NetGrowthCount
Request
Response
Request
Query Parameters
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, 1h or 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1548547200
"v": 5214
},
...
]
400: Bad Request
unsupported asset4

get
Number of Whales

https://api.glassnode.com/v1/metrics/entities/min_1k_count
The number of unique entities holding at least 1k coins. Entities are defined as cluster of addresses that are controlled by one entity and are estimated through Glassnode's internal flags database as well as proprietary clustering algorithms. Note that entity–based metrics are based on clustering and data science techniques and therefore mutable – the data is stable, but recent datapoints are subject to minor fluctuations. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.Min1KCount
Request
Response
Request
Query Parameters
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, 1h or 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1548547200,
"v": 1688
},
...
]
400: Bad Request
unsupported asset

get
Active Entities

https://api.glassnode.com/v1/metrics/entities/active_count
The number of unique entities that were active either as a sender or receiver. Entities are defined as cluster of addresses that are controlled by one entity and are estimated through Glassnode's internal flags database as well as proprietary clustering algorithms. Note that entity–based metrics are based on clustering and data science techniques and therefore mutable – the data is stable, but recent datapoints are subject to minor fluctuations. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.ActiveCount
Request
Response
Request
Query Parameters
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, 1h or 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1548547200,
"v": 164808
},
...
]
400: Bad Request
unsupported asset

get
Sending Entities

https://api.glassnode.com/v1/metrics/entities/sending_count
The number of unique entities that were active as a sender. Entities are defined as cluster of addresses that are controlled by one entity and are estimated through Glassnode's internal flags database as well as proprietary clustering algorithms. Note that entity–based metrics are based on clustering and data science techniques and therefore mutable – the data is stable, but recent datapoints are subject to minor fluctuations. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SendingCount
Request
Response
Request
Query Parameters
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, 1h or 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1548547200,
"v": 83746
},
...
]
400: Bad Request
unsupported asset

get
Receiving Entities

https://api.glassnode.com/v1/metrics/entities/receiving_count
The number of unique entities that were active as a receiver. Entities are defined as cluster of addresses that are controlled by one entity and are estimated through Glassnode's internal flags database as well as proprietary clustering algorithms. Note that entity–based metrics are based on clustering and data science techniques and therefore mutable – the data is stable, but recent datapoints are subject to minor fluctuations. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.ReceivingCount
Request
Response
Request
Query Parameters
a
required
string
asset symbol (only BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, 1h or 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1548547200,
"v": 127302
},
...
]
400: Bad Request
unsupported asset

get
Percent Entities in Profit

https://api.glassnode.com/v1/metrics/entities/profit_relative
The percentage of entities in the network that are currently in profit, e.g. the entities whose funds where on average bought at prices lower than the current price. "Buy price" is here defined as the price at the time coins were transferred into addresses controlled by the entity. Entities are defined as a cluster of addresses that are controlled by the same network entity and are estimated through advanced heuristics and Glassnode's proprietary clustering algorithms. Note that entity–based metrics are based on data science techniques and statistical information that changes over time and are therefore mutable – the data is stable, but most recent data points are subject to slight fluctuations as time progresses. For more information this article: https://medium.com/glassnode-insights/how-many-entities-hold-bitcoin-e945ecc5d0a1 View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.ProfitRelative
Request
Response
Request
Query Parameters
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 0.7474045316605394
},
...
]
400: Bad Request
unsupported asset

get
Entities Supply Distribution

https://api.glassnode.com/v1/metrics/entities/supply_distribution_relative
Relative distribution of the circulating supply held by entities with specific balance bands. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyDistributionRelative
Request
Response
Request
Query Parameters
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1595376000,
"o": {
"0001_001": 0.00156724463273683,
"001_01": 0.00903263854237515,
"01_1": 0.0379108730975079,
"1_10": 0.090250109582261,
"1k_10k": 0.221029011657099,
"10_100": 0.237643623961421,
"10k_100k": 0.0897183503683207,
"100_1k": 0.185773172074464,
"above_100k": 0.126927059067596,
"less_0001": 0.000147917016218971,
}
}
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance < 0.001

https://api.glassnode.com/v1/metrics/entities/supply_balance_less_0001
The total circulating supply held by entities with a balances lower than 0.001 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalanceLess0001
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 2727.23745366
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 0.001 - 0.01

https://api.glassnode.com/v1/metrics/entities/supply_balance_0001_001
The total circulating supply held by entities with a balances between 0.001 and 0.01 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance0001001
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 28896.25798779
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 0.01 - 0.1

https://api.glassnode.com/v1/metrics/entities/supply_balance_001_01
The total circulating supply held by entities with a balances between 0.01 and 0.1 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance00101
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 166540.33976504
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 0.1 - 1

https://api.glassnode.com/v1/metrics/entities/supply_balance_01_1
The total circulating supply held by entities with a balances between 0.1 and 1 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance011
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 698986.19952837
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 1 - 10

https://api.glassnode.com/v1/metrics/entities/supply_balance_1_10
The total circulating supply held by entities with a balances between 1 and 10 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance110
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 1663997.05281571
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 10 - 100

https://api.glassnode.com/v1/metrics/entities/supply_balance_10_100
The total circulating supply held by entities with a balances between 10 and 100 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance10100
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 1663997.05281571
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 100 - 1k

https://api.glassnode.com/v1/metrics/entities/supply_balance_100_1k
The total circulating supply held by entities with a balances between 100 and 1,000 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance1001K
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 3425214.79757731
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 1k - 10k

https://api.glassnode.com/v1/metrics/entities/supply_balance_1k_10k
The total circulating supply held by entities with a balances between 1,000 and 10,000 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance1K10K
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 4075248.50314943
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance 10k - 100k

https://api.glassnode.com/v1/metrics/entities/supply_balance_10k_100k
The total circulating supply held by entities with a balances between 10,000 and 100,000 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalance10K100K
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 1654192.67951467
},
...
]
400: Bad Request
unsupported asset

get
Supply Held by Entities with Balance > 100k

https://api.glassnode.com/v1/metrics/entities/supply_balance_more_100k
The total circulating supply held by entities with a balances of at least 100,000 coins. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=entities.SupplyBalanceMore100K
Request
Response
Request
Query Parameters
c
optional
string
currency, usd or native (default)
a
required
string
asset symbol (BTC)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval, only 24h (default)
f
optional
string
format, csv or json (default)
Response
200: OK
[
{
"t": 1594598400,
"v": 2340232.64003392
},
...
]
400: Bad Request
unsupported asset