Supply

Adjusted Supply

GET https://api.glassnode.com/v1/metrics/supply/current_adjusted

The circulating supply adjusted by accounting for lost coins. The amount of lost coins is estimated by all those that have not moved in over 7 years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":14854008.6037544}]

Asia Year-over-Year Supply Change

GET https://api.glassnode.com/v1/metrics/supply/apac_1y_supply_change

This metric aims at giving an estimate for the year-over-year change in the share of the Bitcoin supply to be held/traded in Asia.

Geolocation of Bitcoin supply is performed probabilistically at the entity level. The timestamps of all transactions created by an entity are correlated with the working hours of different geographical regions to determine the probabilities for each entity being located in the US, Europe, or Asia. Working hours are defined as:

  • US: 8am to 8pm Eastern Time (13:00-01:00 UTC)

  • EU: 8am to 8pm Central European Time (07:00-19:00 UTC)

  • Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)

An entity's balance will only contribute to the supply in the respective region if the location can be determined with a high certainty. Supply held on exchanges wallets are excluded.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"v":0.008997432572259212}]

Burn Rate (Base Fee)

GET https://api.glassnode.com/v1/metrics/supply/burn_rate

This metric represents the ongoing pace at which ETH is being burned, following the introduction of the London Hard Fork and the implementation of EIP-1559. The Ethereum Improvement Proposal (EIP-1559) established a base fee for each transaction, which is subsequently incinerated, reducing the overall ETH supply. By tracking the ETH burn rate, users can gain insights into the deflationary pressure on Ethereum and its potential impact on the network's long-term economic dynamics.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h, 1w, 1month

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":3110.629469183}]

Burned Supply

GET https://api.glassnode.com/v1/metrics/supply/burned

This metric represents the cumulative sum of ETH incinerated since the implementation of the London Hard Fork, which introduced EIP-1559. The Ethereum Improvement Proposal (EIP-1559) established a base fee for transactions, which is burned to reduce the overall ETH supply. As a result, this metric indicates the deflationary pressure on Ethereum.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h, 1w, 1month

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2984416.8331969}]

Circulating Supply

GET https://api.glassnode.com/v1/metrics/supply/current

The total amount of all coins ever created/issued, i.e. the circulating supply.

ETH: The total amount of coins created or issued - the total amount of coins burned. This includes issuance via the Beacon chain since Beacon Chain genesis and ETH burned since the London upgrade (EIP-1559).

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol (see list below for more details)

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m, 1w, 1month

f

string

format: JSON, CSV

c

string

currency: USD, NATIVE

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":19307525}]

Supported asset symbols: BTC, ETH, LTC, 1INCH, AAVE, ABT, AMP, AMPL, ANT, APE, BADGER, BAL, BAND, BAT, BNT, BOBA, BOND, BRD, BUSD, CAKE, CELR, CHSB, COMP, CREAM, CRO, CRV, CVC, CVP, CVX, CVXCRV, DAI, DDX, DENT, DHT, DODO, DPI, DRGN, DYDX, ELF, ENG, ENJ, EURS, FET, FLX, FRAX, FTM, FTT, FUN, FXS, GNO, GUSD, HEGIC, HOT, HT, HUSD, IMX, INDEX, KCS, LAMB, LBA, LDO, LEO, LINK, LOOM, LRC, MANA, MATIC, MCB, METIS, MIR, MKR, MLN, MTA, MTL, NDX, NEXO, NFTX, NMR, Nsure, OCEAN, OKB, OMG, PAY, PERP, PICKLE, PNK, PNT, POLY, POWR, PPT, PYUSD, QASH, QKC, QNT, RAI, RDN, REN, REP, rETH, RLC, ROOK, RPL, RSR, SAND, SFRXETH, SHIB, SNT, SNX, SSV, STAKE, stETH, STORJ, sUSD, SUSHI, TEL, TUSD, UBT, UMA, UNI, USDC, USDD, USDK, USDP, USDT, UTK, VERI, WaBi, WBTC, wNXM, YAM, YFI, ZRX

EU Year-over-Year Supply Change

GET https://api.glassnode.com/v1/metrics/supply/emea_1y_supply_change

This metric aims at giving an estimate for the year-over-year change in the share of the Bitcoin supply to be held/traded in Europe.

Geolocation of Bitcoin supply is performed probabilistically at the entity level. The timestamps of all transactions created by an entity are correlated with the working hours of different geographical regions to determine the probabilities for each entity being located in the US, Europe, or Asia. Working hours are defined as:

  • US: 8am to 8pm Eastern Time (13:00-01:00 UTC)

  • EU: 8am to 8pm Central European Time (07:00-19:00 UTC)

  • Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)

An entity's balance will only contribute to the supply in the respective region if the location can be determined with a high certainty. Supply held on exchanges wallets are excluded.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"v":0.00906790346550456}]

Highly Liquid Supply

GET https://api.glassnode.com/v1/metrics/supply/highly_liquid_sum

The total supply held by "highly liquid" entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is ≲ 0.25 / 0.25 ≲ L ≲ 0.75 / 0.75 ≲ L, respectively. For more information see our introductory article on Bitcoin liquidity.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":3153517.56855626}]

HODL Waves

GET https://api.glassnode.com/v1/metrics/supply/hodl_waves

Bundle of all active supply age bands, aka HODL waves. Each colored band shows the percentage of in existence that was last moved within the time period denoted in the legend. The concept of HODL waves was first described in this post by Unchained Capital.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

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":1677801600,"o":{"1d_1w":0.0184642179829768,"1m_3m":0.0746382240220777,"1w_1m":0.0355486854234296,"1y_2y":0.165747064587533,"24h":0.00899639602045903,"2y_3y":0.119266129693267,"3m_6m":0.0878391146626283,"3y_5y":0.109263457173456,"5y_7y":0.0845260992046084,"6m_12m":0.0969410075852798,"7y_10y":0.0616053858559942,"more_10y":0.137162718112464}}]

Illiquid Supply

GET https://api.glassnode.com/v1/metrics/supply/illiquid_sum

The total supply held by illiquid entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is ≲ 0.25 / 0.25 ≲ L ≲ 0.75 / 0.75 ≲ L, respectively. For more information see our introductory article on Bitcoin liquidity.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":14695107.876931}]

Illiquid Supply Change

GET https://api.glassnode.com/v1/metrics/supply/illiquid_change

The monthly (30d) net change of supply held by illiquid entities. For more information see our introductory article on Bitcoin liquidity.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"v":-15575.2025971075}]

Inflation Rate

GET https://api.glassnode.com/v1/metrics/supply/inflation_rate

The percentage of new coins issued, divided by the current supply.

ETH: The net supply change (issuance - burn) divided by the current supply.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.020047539816870463}]

Issuance

GET https://api.glassnode.com/v1/metrics/supply/issued

The total amount of new coins added to the current supply, i.e. minted coins or new coins released to the network.

ETH: The total amount of new coins added to the current supply, i.e. minted coins or new coins released to the network. Beacon Chain issuance since the genesis on 2020-12-01 is included. This is computed as (Base Reward Factor * Max Balance at Stake / sqrt(Max Balance at Stake)) per epoch on the Beacon Chain.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

c

string

currency: USD, NATIVE

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1050}]

Liquid and Illiquid Supply

GET https://api.glassnode.com/v1/metrics/supply/liquid_illiquid_sum

The total supply held by illiquid, liquid, and highly liquid entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is ≲ 0.25 / 0.25 ≲ L ≲ 0.75 / 0.75 ≲ L, respectively. For more information see our introductory article on Bitcoin liquidity.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"o":{"highly_liquid":3153517.56855626,"illiquid":14695107.876931,"liquid":1458870.59948366}}]

Liquid Supply

GET https://api.glassnode.com/v1/metrics/supply/liquid_sum

The total supply held by "liquid" entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is ≲ 0.25 / 0.25 ≲ L ≲ 0.75 / 0.75 ≲ L, respectively. For more information see our introductory article on Bitcoin liquidity.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1458870.59948366}]

Liquid Supply Change

GET https://api.glassnode.com/v1/metrics/supply/liquid_change

The monthly (30d) net change of supply held by liquid and highly liquid entities. For more information see our introductory article on Bitcoin liquidity.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"v":44037.7025971084}]

Long-Term Holder Position Change

GET https://api.glassnode.com/v1/metrics/supply/lth_net_change

The monthly net position change of long term holders, i.e. the 30 day change in supply held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"v":5222.26400353946}]

Long-Term Holder Supply

GET https://api.glassnode.com/v1/metrics/supply/lth_sum

The total amount of circulating supply held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":14065336.5354053}]

Long-Term Holder Supply in Loss

GET https://api.glassnode.com/v1/metrics/supply/lth_loss_sum

The total amount of circulating supply that is currently at loss and held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":5310652.54748482}]

Long-Term Holder Supply in Profit

GET https://api.glassnode.com/v1/metrics/supply/lth_profit_sum

The total amount of circulating supply that is currently in profit and held by long term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":8754683.97688814}]

Minted Supply

GET https://api.glassnode.com/v1/metrics/supply/minted

The total amount of issued ETH.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h, 1w, 1month

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":123483816.31620646}]

Percent Supply in Profit

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

The percentage of circulating supply in profit, i.e. the percentage of existing coins whose price at the time they last moved was lower than the current price. For more information see this article.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.64804225142448}]

Probably Lost Supply

GET https://api.glassnode.com/v1/metrics/supply/probably_lost

Probably lost coins refer to so-called "zombie coins". Zombie coins are coins that have been inactive since the launch of the first BTC exchange in July 2010. Zombie coins are probably lost, as there is a non-zero probability that they can still be spent. Note that over time the chart steadily decreases as coins from before July 2010 are spent, eventually converging to the real number of lost coins. "Patoshi" coins are included in this category.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1456973.8188523601}]

Provably Lost Supply

GET https://api.glassnode.com/v1/metrics/supply/provably_lost

The total amount of BTC that is provably lost. Provably lost coins fall into one of the following categories:

  • Unclaimed miner rewards: The Bitcoin protocol states that the miner of a valid block can add a special transaction to claim a reward plus the transaction fees. Miners are not allowed to claim more than the specified reward, but they are allowed to claim less.

  • BTC sent to burn addresses: We identify a burn address as an address whose private key has provably no owner. We consider addresses which are virtually impossible to be randomly generated, for example: '1Anything11111111111111111125qfuN'

  • BTC sent to 'OP_RETURN': OP_RETURN is a script opcode that has been primarily used as a means of storing data on the blockchain. Coins sent to OP_RETURN opcode are provably unspendable as they do not get added to the UTXO set.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1668643200,"o":{"burn":0.0000897,"cumsum":3092.95579703,"op_return":0.00003822,"unclaimed":0}}]

Realized Cap HODL Waves

GET https://api.glassnode.com/v1/metrics/supply/rcap_hodl_waves

HODL Waves weighted by Realized Price. The idea for this visualization of HODL waves was first introduced by @typerbole.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"o":{"1d_1w":0.021797744954025013,"1m_3m":0.07210082888054282,"1w_1m":0.04195767068206397,"1y_2y":0.41272304446565117,"24h":0.010187098125516488,"2y_3y":0.1523989645311726,"3m_6m":0.0797879373557472,"3y_5y":0.03765763587494771,"5y_7y":0.026239822546742238,"6m_12m":0.14387121421500895,"7y_10y":0.0012618398621701346,"more_10y":0.00001619850641168459}}]

Relative Long/Short-Term Holder Supply

GET https://api.glassnode.com/v1/metrics/supply/lth_sth_profit_loss_relative

The relative amount of circulating supply of held by long- and short-term holders in profit/loss. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"o":{"lth_loss":0.31515954146088,"lth_profit":0.519544851243889,"sth_loss":0.051859204715912,"sth_profit":0.113418384922666}}]

Revived Supply 1+ Years

GET https://api.glassnode.com/v1/metrics/supply/revived_more_1y_sum

The total amount of coins that come back into circulation after being untouched for at least 1 year. In other words, it is the total transfer volume of coins that were previously dormant for 1+ years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, LTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2255.80203524999}]

Revived Supply 2+ Years

GET https://api.glassnode.com/v1/metrics/supply/revived_more_2y_sum

The total amount of coins that come back into circulation after being untouched for at least 2 years. In other words, it is the total transfer volume of coins that were previously dormant for 2+ years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, LTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1064.64177379}]

Revived Supply 3+ Years

GET https://api.glassnode.com/v1/metrics/supply/revived_more_3y_sum

The total amount of coins that come back into circulation after being untouched for at least 3 years. In other words, it is the total transfer volume of coins that were previously dormant for 3+ years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, LTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":623.7500922}]

Revived Supply 5+ Years

GET https://api.glassnode.com/v1/metrics/supply/revived_more_5y_sum

The total amount of coins that come back into circulation after being untouched for at least 5 years. In other words, it is the total transfer volume of coins that were previously dormant for 5+ years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, LTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h, 10m

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":471.72998156}]

Short to Long-Term Realized Value (SLRV) Ratio

GET https://api.glassnode.com/v1/metrics/supply/sth_lth_realized_value_ratio

The Short to Long-Term Realized Value (SLRV) Ratio is the ratio of the 24h realized HODL wave and the 6m-1y realized HODL wave. It serves as a measurement for comparing short-term and long-term velocity for bear market detection. This metric was first put forward by ARK Invest.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.0708070629771174}]

Short-Term Holder Profit/Loss Ratio

GET https://api.glassnode.com/v1/metrics/supply/sth_profit_loss_ratio

The ratio of the Short-Term Holder Supply in Profit and the Short-Term Holder Supply in Loss. Similar to SOPR, it detects local bottoms in bull markets and local tops in bear markets. This metric was first put forward by ARK Invest.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"v":2.18704443201509}]

Short-Term Holder Supply

GET https://api.glassnode.com/v1/metrics/supply/sth_sum

The total amount of circulating supply held by short term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2785343.35474814}]

Short-Term Holder Supply in Loss

GET https://api.glassnode.com/v1/metrics/supply/sth_loss_sum

The total amount of circulating supply that is currently at loss and held by short term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":873862.858025767}]

Short-Term Holder Supply in Profit

GET https://api.glassnode.com/v1/metrics/supply/sth_profit_sum

The total amount of circulating supply that is currently in profit and held by short term holders. Long- and Short-Term Holder supply is defined with respect to the entity's averaged purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days.

View in Studio

Query Parameters

NameTypeDescription

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

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1911176.89799005}]

Supply by TxOut Type

GET https://api.glassnode.com/v1/metrics/supply/supply_by_txout_type

This metric breaks down the total Bitcoin supply by transaction output types. Transaction output types, or txout types for short, are determined by the type of Bitcoin script conditions that are used to lock Bitcoin in the output. The most common transaction output types are:

  • P2TR (Pay to Taproot): Funds are locked using a 32-byte hash that is either (1) a public key, (2) a combination of multiple public keys, or (3) a script hash.

  • P2WPKH (Pay to Witness Public Key Hash): The SegWit version of P2PKH.

  • P2WSH (Pay to Witness Script Hash): The SegWit version of P2SH. This type comes in two variants.

  • P2SH (Pay to Script Hash): Funds are locked using arbitrary Bitcoin script instructions.

  • P2PKH (Pay to Public Key Hash): The successor of P2PK, locking funds using the hash of a public key.

  • P2PK (Pay to Public Key): The first available type, locking funds using a public key.

  • Other: Serves as catch-all for all outputs whose script instructions don't match any of most commonly used output types listed above.

View in Studio

Query Parameters

NameTypeDescription

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":1677801600,"o":{"total_other":2699.59355311,"total_p2pk":1734323.76806181,"total_p2pkh":8335092.39572329,"total_p2sh":4625811.00682055,"total_p2tr":23785.87641258,"total_p2wpkh":3791517.82161271,"total_p2wsh":794265.58278691}}]

Supply in Loss

GET https://api.glassnode.com/v1/metrics/supply/loss_sum

The circulating supply in loss, i.e. the amount of coins whose price at the time they last moved was higher than the current price. For more information see this article.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":6670365.02820413}]

Supply in Profit

GET https://api.glassnode.com/v1/metrics/supply/profit_sum

The circulating supply in profit, i.e. the amount of coins whose price at the time they last moved was lower than the current price. For more information see this article.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":12286265.875373}]

Supply Last Active < 24h

GET https://api.glassnode.com/v1/metrics/supply/active_24h

The amount of circulating supply last moved in the last 24 hours.

ETH: The amount of circulating supply last moved in the last 24 hours. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":173698.141074913}]

Supply Last Active >10y

GET https://api.glassnode.com/v1/metrics/supply/active_more_10y

The amount of circulating supply last moved more than 10 years ago.

ETH: The amount of circulating supply last moved more than 10 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2648272.60902435}]

Supply Last Active 1+ Years Ago

GET https://api.glassnode.com/v1/metrics/supply/active_more_1y_percent

The percent of circulating supply that has not moved in at least 1 year.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.677570854627284}]

Supply Last Active 1d-1w

GET https://api.glassnode.com/v1/metrics/supply/active_1d_1w

The amount of circulating supply last moved between 1 day and 1 week ago.

ETH: The amount of circulating supply last moved between 1 day and 1 week ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":356498.350311774}]

Supply Last Active 1m-3m

GET https://api.glassnode.com/v1/metrics/supply/active_1m_3m

The amount of circulating supply last moved between 1 month and 3 months ago.

ETH: The amount of circulating supply last moved between 1 month and 3 months ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1441079.37626187}]

Supply Last Active 1w-1m

GET https://api.glassnode.com/v1/metrics/supply/active_1w_1m

The amount of circulating supply last moved between 1 week and 1 month ago.

ETH: The amount of circulating supply last moved between 1 week and 1 month ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":686357.132530002}]

Supply Last Active 1y-2y

GET https://api.glassnode.com/v1/metrics/supply/active_1y_2y

The amount of circulating supply last moved between 1 year and 2 years ago.

ETH: The amount of circulating supply last moved between 1 year and 2 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":3200165.5932004}]

Supply Last Active 2+ Years Ago

GET https://api.glassnode.com/v1/metrics/supply/active_more_2y_percent

The percent of circulating supply that has not moved in at least 2 years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.511823790039774}]

Supply Last Active 2y-3y

GET https://api.glassnode.com/v1/metrics/supply/active_2y_3y

The amount of circulating supply last moved between 2 years and 3 years ago.

ETH: The amount of circulating supply last moved between 2 years and 3 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2302733.780706}]

Supply Last Active 3+ Years Ago

GET https://api.glassnode.com/v1/metrics/supply/active_more_3y_percent

The percent of circulating supply that has not moved in at least 3 years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.392557660346513}]

Supply Last Active 3m-6m

GET https://api.glassnode.com/v1/metrics/supply/active_3m_6m

The amount of circulating supply last moved between 3 months and 6 months ago.

ETH: The amount of circulating supply last moved between 3 months and 6 months ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1695955.90232656}]

Supply Last Active 3y-5y

GET https://api.glassnode.com/v1/metrics/supply/active_3y_5y

The amount of circulating supply last moved between 3 years and 5 years ago.

ETH: The amount of circulating supply last moved between 3 years and 5 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":2109606.93096293}]

Supply Last Active 5+ Years Ago

GET https://api.glassnode.com/v1/metrics/supply/active_more_5y_percent

The percent of circulating supply that has not moved in at least 5 years.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":0.283294203173059}]

Supply Last Active 5y-7y

GET https://api.glassnode.com/v1/metrics/supply/active_5y_7y

The amount of circulating supply last moved between 5 years and 7 years ago.

ETH: The amount of circulating supply last moved between 5 years and 7 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1631989.77354546}]

Supply Last Active 6m-12m

GET https://api.glassnode.com/v1/metrics/supply/active_6m_12m

The amount of circulating supply last moved between 6 months and 12 months ago.

ETH: The amount of circulating supply last moved between 6 months and 12 months ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1871690.92747798}]

Supply Last Active 7y-10y

GET https://api.glassnode.com/v1/metrics/supply/active_7y_10y

The amount of circulating supply last moved between 7 years and 10 years ago.

ETH: The amount of circulating supply last moved between 7 years and 10 years ago. Please be aware that the ETH2 deposit contract address (0x00000000219ab540356cBB839Cbe05303d7705Fa) has been excluded to prevent the misrepresentation of data, given that its balance will continually increase.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 1h, 24h

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":1189447.52754925}]

Tips (Priority Fee)

GET https://api.glassnode.com/v1/metrics/supply/tips

The Ethereum Improvement Proposal (EIP-1559), introduced as part of the London Hard Fork, established priority fees, commonly referred to as tips. These fees are paid by users to expedite their transactions, rewarding miners or validators for prioritizing them. Before the Paris upgrade, miners received these tips, but with the transition to Proof-of-Stake, validators now benefit from these additional fees. This metric provides insight into the supplementary income received by validators, beyond the base fee, for ensuring timely transaction processing on the Ethereum network.

View in Studio

Query Parameters

NameTypeDescription

a*

string

asset symbol: ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval: 10m, 1h, 24h, 1w, 1month

f

string

format: JSON, CSV

c

string

currency: NATIVE, USD

timestamp_format

string

timestamp format: unix or humanized (RFC 3339)

[{"t":1677801600,"v":617.765365729}]

US Year-over-Year Supply Change

GET https://api.glassnode.com/v1/metrics/supply/amer_1y_supply_change

This metric aims at giving an estimate for the year-over-year change in the share of the Bitcoin supply to be held/traded in the US.

Geolocation of Bitcoin supply is performed probabilistically at the entity level. The timestamps of all transactions created by an entity are correlated with the working hours of different geographical regions to determine the probabilities for each entity being located in the US, Europe, or Asia. Working hours are defined as:

  • US: 8am to 8pm Eastern Time (13:00-01:00 UTC)

  • EU: 8am to 8pm Central European Time (07:00-19:00 UTC)

  • Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)

An entity's balance will only contribute to the supply in the respective region if the location can be determined with a high certainty. Supply held on exchanges wallets are excluded.

View in Studio

Query Parameters

NameTypeDescription

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)