Entities

Active Entities

get

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

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/active_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 217208
  }
]

Entities Net Growth

get

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.\n\nThe computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/net_growth_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 5558
  }
]

Entities Supply Distribution

get

Relative distribution of the circulating supply held by entities with specific balance bands.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_distribution_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "o": {
      "0001_001": 0.001740274150491752,
      "001_01": 0.011842729617655704,
      "01_1": 0.051775912506567184,
      "100_1k": 0.15795214647978617,
      "10_100": 0.1624894178316405,
      "10k_100k": 0.09142093368338804,
      "1_10": 0.10669460098805436,
      "1k_10k": 0.1588659726984214,
      "above_100k": 0.25700464466160045,
      "less_0001": 0.0002133673823944684
    }
  }
]

New Entities

get

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.\n\nThe computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/new_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 77480
  }
]

Number of Whales

get

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

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/min_1k_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 1513
  }
]

Percent Entities in Profit

get

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

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/profit_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 0.927387036041364
  }
]

Receiving Entities

get

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

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/receiving_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 165698
  }
]

Sending Entities

get

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

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/sending_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 116532
  }
]

Supply Held by Entities with Balance < 0.001

get

The total circulating supply held by entities with balance lower than 0.001 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_less_0001?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 4215.44785534
  }
]

Supply Held by Entities with Balance > 100k

get

The total circulating supply held by entities with balance of at least 100,000 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_more_100k?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 5077578.7095153
  }
]

Supply Held by Entities with Balance 0.001 - 0.01

get

The total circulating supply held by entities with balance between 0.001 and 0.01 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_0001_001?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 34382.17619332
  }
]

Supply Held by Entities with Balance 0.01 - 0.1

get

The total circulating supply held by entities with balance between 0.01 and 0.1 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_001_01?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 233973.9495694
  }
]

Supply Held by Entities with Balance 0.1 - 1

get

The total circulating supply held by entities with balance between 0.1 and 1 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_01_1?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 1022924.20183779
  }
]

Supply Held by Entities with Balance 1 - 10

get

The total circulating supply held by entities with balance between 1 and 10 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_1_10?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 2107939.46977301
  }
]

Supply Held by Entities with Balance 10 - 100

get

The total circulating supply held by entities with balance between 10 and 100 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_10_100?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 3210264.19421262
  }
]

Supply Held by Entities with Balance 100 - 1k

get

The total circulating supply held by entities with balance between 100 and 1,000 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_100_1k?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 3120622.41966102
  }
]

Supply Held by Entities with Balance 10k - 100k

get

The total circulating supply held by entities with balance between 10,000 and 100,000 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_10k_100k?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 1806181.3127385
  }
]

Supply Held by Entities with Balance 1k - 10k

get

The total circulating supply held by entities with balance between 1,000 and 10,000 coins.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
get
GET /v1/metrics/entities/supply_balance_1k_10k?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 3138676.66361466
  }
]

Last updated