Entities

Active Entities

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":219887}]

Entities Net Growth

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.

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

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2861}]

Entities Supply Distribution

GET 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

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"o":{"0001_001":0.002007468115350108,"001_01":0.013197614768194418,"01_1":0.05426840844980909,"100_1k":0.1873979835698317,"10_100":0.16316409204535623,"10k_100k":0.08192642791784087,"1_10":0.10712049554257286,"1k_10k":0.17227156103412472,"above_100k":0.21839503581765682,"less_0001":0.00025091273926318496}}]

New Entities

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.

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

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":77776}]

Number of Whales

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1661}]

Percent Entities in Profit

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":0.9122182371009923}]

Receiving Entities

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":168757}]

Sending Entities

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":120213}]

Supply Held by Entities with Balance < 0.001

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":4957.22240548}]

Supply Held by Entities with Balance > 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":4314777.99006973}]

Supply Held by Entities with Balance 0.001 - 0.01

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":39661.062841700004}]

Supply Held by Entities with Balance 0.01 - 0.1

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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":260742.08834476}]

Supply Held by Entities with Balance 0.1 - 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1072167.84236274}]

Supply Held by Entities with 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":2116353.76565225}]

Supply Held by Entities with 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":3223593.56974952}]

Supply Held by Entities with 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":3702376.7132036}]

Supply Held by Entities with 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":1618600.65482475}]

Supply Held by Entities with 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.

View in Studio

Query Parameters

Name
Type
Description

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 24h, 1h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1726790400,"v":3403527.6355164303}]

Last updated