Glassnode Docs
WebsiteStudioInsightsTwitter
  • Welcome to Glassnode
    • Introduction
      • Studio
  • 📊Data
    • General Information
      • Timestamps and Resolutions
      • Data Availability
      • Data Finalization
    • Metric Catalog
    • Supported Blockchains
    • Supported Assets
      • Market Metrics Coverage
      • On-chain Metrics Coverage
    • Point-in-Time Metrics
  • 📖Guides & Tutorials
    • Getting Started
      • Use-Case Tutorials
        • Tutorial 1 - Navigating Market Tops and Bottoms
        • Tutorial 2 - Introduction to On-chain Activity
        • Tutorial 3 - Fundamentals of Proof-of-Work Mining
        • Tutorial 4 - Introduction to Supply Dynamics
      • Get started with Glassnode Metrics
      • Granular Cohorts for Key On-Chain Metrics
    • Metric Guides
      • Market Capitalization
      • Realized Capitalization
      • MVRV
        • LTH-MVRV
        • MVRV Ratio
        • MVRV-Z Score
        • STH-MVRV
      • SOPR
        • SOPR (Spent Output Profit Ratio)
        • aSOPR (Adjusted SOPR)
        • LTH-SOPR
        • STH-SOPR
      • Unrealized Profit/Loss
        • NUPL (Net Unrealized Profit/Loss)
        • Unrealized Profit
        • Unrealized Loss
        • LTH-NUPL
        • STH-NUPL
      • Realized Profit/Loss
        • Net Realized Profit/Loss
        • Realized Profit
        • Realized Loss
      • Coin Issuance
        • Puell Multiple
      • Stablecoin
        • SSR (Stablecoin Supply Ratio)
      • Coin Days Destroyed
        • CDD (Coin Days Destroyed)
        • Supply-Adjusted CDD
        • Binary CDD
        • CYD (Coin Years Destroyed)
        • Supply-Adjusted CYD
        • Reserve Risk
      • Liveliness
      • Dormancy
        • Average Coin Dormancy
        • Supply-Adjusted Dormancy
      • Lifespan
        • Spent Output Age Bands (SOAB)
        • Average Spent Output Lifespan (ASOL)
        • Median Spent Output Lifespan (MSOL)
      • NVT
        • NVT Ratio
        • NVT Signal
        • Velocity
      • Stock to Flow
        • Stock to Flow Ratio
        • Stock to Flow Deflection
      • Price Distribution
        • URPD (UTXO Realized Price Distribution)
        • SOPD (Spent Output Price Distribution)
      • Accumulation Trend Score
      • Long and Short-Term Holder Supply
        • Supply Held by Long and Short-Term Holders
      • Profit/Loss (Supply)
        • Percent Supply in Profit
        • Supply in Profit
        • Supply in Loss
      • Age Distribution
        • HODL Waves
        • Realized Cap HODL Waves
      • Profit/Loss (UTXO)
        • Percent UTXOs in Profit
        • UTXOs in Profit
        • UTXOs in Loss
    • On-Chain Concepts
      • Entity-Adjusted Metrics
      • On-chain Glossary
      • Understanding UTXOs - The Gold Coin Analogy
      • UTXO vs. Account-Based Chains
    • Workbench Guide
  • ⚙️API
    • Introduction
    • API Key
    • API Credits
    • Metadata
    • Bulk metrics (beta)
    • Endpoints
      • Addresses
      • Bridges
      • Blockchain
      • Breakdowns
      • DeFi
      • Derivatives
      • Distribution
      • Entities
      • ETH 2.0
      • Fees
      • Indicators
      • Institutions
      • Lightning
      • Market
      • Mempool
      • Mining
      • Point-In-Time
      • Protocols
      • Signals
      • Supply
      • Transactions
  • ℹ️Further Information
    • Changelog
      • 2025
      • 2024
      • 2023
      • 2022
      • 2021
      • 2020
    • Support FAQ
    • Affiliate FAQs
    • Exchange Data: Transparency Notice
Powered by GitBook
On this page
  • Active Entities
  • Entities Net Growth
  • Entities Supply Distribution
  • New Entities
  • Number of Whales
  • Percent Entities in Profit
  • Receiving Entities
  • Sending Entities
  • Supply Held by Entities with Balance < 0.001
  • Supply Held by Entities with Balance > 100k
  • Supply Held by Entities with Balance 0.001 - 0.01
  • Supply Held by Entities with Balance 0.01 - 0.1
  • Supply Held by Entities with Balance 0.1 - 1
  • Supply Held by Entities with Balance 1 - 10
  • Supply Held by Entities with Balance 10 - 100
  • Supply Held by Entities with Balance 100 - 1k
  • Supply Held by Entities with Balance 10k - 100k
  • Supply Held by Entities with Balance 1k - 10k
  1. API
  2. Endpoints

Entities

PreviousDistributionNextETH 2.0

Last updated 1 month ago

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 .

Query Parameters

Name
Type
Description

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":216035}]
unsupported asset

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 .

The computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week.

Query Parameters

Name
Type
Description

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":4194}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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.0018069978728078077,"001_01":0.01226472931234207,"01_1":0.052606450131472096,"100_1k":0.17835485628461475,"10_100":0.16286225191019155,"10k_100k":0.09018715657381837,"1_10":0.10702657306090634,"1k_10k":0.1726420656662777,"above_100k":0.2220280782845113,"less_0001":0.0002208409030579876}}]
unsupported asset

New Entities

GET https://api.glassnode.com/v1/metrics/entities/new_count

The computation of this metric requires statistical information from several days, and is therefore only available with a lag of one week.

Query Parameters

Name
Type
Description

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":76401}]
unsupported asset

Number of Whales

GET https://api.glassnode.com/v1/metrics/entities/min_1k_count

Query Parameters

Name
Type
Description

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":1669}]
unsupported asset

Percent Entities in Profit

GET https://api.glassnode.com/v1/metrics/entities/profit_relative

Query Parameters

Name
Type
Description

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.9244690091252443}]
unsupported asset

Receiving Entities

GET https://api.glassnode.com/v1/metrics/entities/receiving_count

Query Parameters

Name
Type
Description

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":164611}]
unsupported asset

Sending Entities

GET https://api.glassnode.com/v1/metrics/entities/sending_count

Query Parameters

Name
Type
Description

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":117310}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":4363.10039857}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":4386555.132871}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":35700.42066434}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":242311.29564337002}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":1039332.93315555}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":2114498.16186002}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":3217630.18707989}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":3523713.83093813}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":1781805.87628642}]
unsupported asset

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.

Query Parameters

Name
Type
Description

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":3410847.60607367}]
unsupported asset

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 .

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 .

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 .

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 .

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
this article
View in Studio
View in Studio
this article
View in Studio
this article
View in Studio
article
View in Studio
this article
View in Studio
this article
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio