Entities
Active Entities
GET
https://api.glassnode.com/v1/metrics/entities/active_count
GET
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 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":216312}]
Entities Net Growth
GET
https://api.glassnode.com/v1/metrics/entities/net_growth_count
GET
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 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":4797}]
Entities Supply Distribution
GET
https://api.glassnode.com/v1/metrics/entities/supply_distribution_relative
GET
https://api.glassnode.com/v1/metrics/entities/supply_distribution_relative
Relative 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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.0017690734595350278,"001_01":0.012055289635997325,"01_1":0.05219634364396367,"100_1k":0.15780860303053285,"10_100":0.1625244603359422,"10k_100k":0.0913925570588454,"1_10":0.10679529221841848,"1k_10k":0.15831832182362118,"above_100k":0.25692437152599373,"less_0001":0.00021568726715014188}}]
New Entities
GET
https://api.glassnode.com/v1/metrics/entities/new_count
GET
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 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":76872}]
Number of Whales
GET
https://api.glassnode.com/v1/metrics/entities/min_1k_count
GET
https://api.glassnode.com/v1/metrics/entities/min_1k_count
The 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":1517}]
Percent Entities in Profit
GET
https://api.glassnode.com/v1/metrics/entities/profit_relative
GET
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.
asset id - BTC
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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.9264060550625857}]
Receiving Entities
GET
https://api.glassnode.com/v1/metrics/entities/receiving_count
GET
https://api.glassnode.com/v1/metrics/entities/receiving_count
The 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":164838}]
Sending Entities
GET
https://api.glassnode.com/v1/metrics/entities/sending_count
GET
https://api.glassnode.com/v1/metrics/entities/sending_count
The 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
json
Possible values: timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":116777}]
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_0001
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":4261.28125831}]
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_100k
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":5075992.77255747}]
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_001
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":34951.15718835}]
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_01
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":238173.44652809002}]
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_1
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":1031230.55830412}]
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_10
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":2109928.80209891}]
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_100
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":3210956.52050892}]
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_1k
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":3117786.46639341}]
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_100k
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":1805620.68261909}]
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_10k
The 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
json
Possible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unix
Possible 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":3127856.85751429}]
Last updated