Entities
Active Entities
GET https://api.glassnode.com/v1/metrics/entities/active_count
GET https://api.glassnode.com/v1/metrics/entities/active_countThe number of unique entities that were active either as a sender or receiver. 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 see this article.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/active_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 216252
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":216460}]Entities Net Growth
GET https://api.glassnode.com/v1/metrics/entities/net_growth_count
GET https://api.glassnode.com/v1/metrics/entities/net_growth_countThe 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 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 see this article.\nThe computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/net_growth_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 4755
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":4897}]Entities Supply Distribution
GET https://api.glassnode.com/v1/metrics/entities/supply_distribution_relative
GET https://api.glassnode.com/v1/metrics/entities/supply_distribution_relativeRelative distribution of the circulating supply held by entities with specific balance bands.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_distribution_relative HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"o": {
"0001_001": 0.0017695040474313489,
"001_01": 0.012058865073373816,
"01_1": 0.052203763259140744,
"100_1k": 0.15780850700532884,
"10_100": 0.1625143635013139,
"10k_100k": 0.09139251855578538,
"1_10": 0.10679422317411438,
"1k_10k": 0.1583182146176554,
"above_100k": 0.2569243215993806,
"less_0001": 0.0002157191664755583
}
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"o":{"0001_001":0.0017662568542724118,"001_01":0.012033682465184445,"01_1":0.05214941098266453,"100_1k":0.15784144419375418,"10_100":0.16256170383447335,"10k_100k":0.09139332897510764,"1_10":0.10676570656781191,"1k_10k":0.15834860028129824,"above_100k":0.2569245489328321,"less_0001":0.00021531691260117351}}]New Entities
GET https://api.glassnode.com/v1/metrics/entities/new_count
GET https://api.glassnode.com/v1/metrics/entities/new_countThe number of unique entities that appeared for the first time in a transaction of the native coin in the network. 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 see this article.\nThe computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/new_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 76833
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":76974}]Number of Whales
GET https://api.glassnode.com/v1/metrics/entities/min_1k_count
GET https://api.glassnode.com/v1/metrics/entities/min_1k_countThe number of unique entities holding at least 1k coins.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 see this article.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/min_1k_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 1517
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":1510}]Percent Entities in Profit
GET https://api.glassnode.com/v1/metrics/entities/profit_relative
GET https://api.glassnode.com/v1/metrics/entities/profit_relativeThe 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.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/profit_relative HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 0.9263878389058795
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":0.92654616993546}]Receiving Entities
GET https://api.glassnode.com/v1/metrics/entities/receiving_count
GET https://api.glassnode.com/v1/metrics/entities/receiving_countThe number of unique entities that were active as a receiver. 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 see this article.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/receiving_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 164780
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":164979}]Sending Entities
GET https://api.glassnode.com/v1/metrics/entities/sending_count
GET https://api.glassnode.com/v1/metrics/entities/sending_countThe number of unique entities that were active as a sender. 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 see this article.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/sending_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 116784
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h
f
string
format - csv, json
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":116750}]Supply Held by Entities with Balance < 0.001
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_less_0001
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_less_0001The total circulating supply held by entities with balance lower than 0.001 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_less_0001 HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 4261.91148558
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":4253.96425291}]Supply Held by Entities with Balance > 100k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_more_100k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_more_100kThe total circulating supply held by entities with balance of at least 100,000 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 24h, 1h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_more_100k HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 5075991.78616943
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":5075996.277541541}]Supply Held by Entities with Balance 0.001 - 0.01
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_0001_001
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_0001_001The total circulating supply held by entities with balance between 0.001 and 0.01 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_0001_001 HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 34959.66420945
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":34895.51019826}]Supply Held by Entities with Balance 0.01 - 0.1
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_001_01
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_001_01The total circulating supply held by entities with balance between 0.01 and 0.1 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_001_01 HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 238244.08558103
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":237746.55887150002}]Supply Held by Entities with Balance 0.1 - 1
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_01_1
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_01_1The total circulating supply held by entities with balance between 0.1 and 1 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_01_1 HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 1031377.14584967
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":1030303.3210469601}]Supply Held by Entities with Balance 1 - 10
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_1_10
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_1_10The total circulating supply held by entities with balance between 1 and 10 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_1_10 HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 2109907.6812487203
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":2109344.28554348}]Supply Held by Entities with Balance 10 - 100
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_10_100
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_10_100The total circulating supply held by entities with balance between 10 and 100 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_10_100 HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 3210757.0397851
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":3211692.33131677}]Supply Held by Entities with Balance 100 - 1k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_100_1k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_100_1kThe total circulating supply held by entities with balance between 100 and 1,000 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_100_1k HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 3117784.56924664
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":3118435.3013255103}]Supply Held by Entities with Balance 10k - 100k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_10k_100k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_10k_100kThe total circulating supply held by entities with balance between 10,000 and 100,000 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_10k_100k HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 1805619.92192343
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":1805635.9331823}]Supply Held by Entities with Balance 1k - 10k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_1k_10k
GET https://api.glassnode.com/v1/metrics/entities/supply_balance_1k_10kThe total circulating supply held by entities with balance between 1,000 and 10,000 coins.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h, 1h, 10m
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: GET /v1/metrics/entities/supply_balance_1k_10k HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 3127854.73947191
}
]Query Parameters
a*
string
asset id - BTC
s
integer
since, unix timestamp
u
integer
until, unix timestamp
i
string
frequency interval - 24h, 1h, 10m
f
string
format - csv, json
c
string
currency - native, usd
timestamp_format
string
timestamp format - unix or humanized (RFC 3339)
[{"t":1726790400,"v":3128455.0616917303}]Last updated