Supply
Definition. Adjusted Circulating Supply is the circulating supply with an estimate of lost coins removed.\n\nTechnical. The amount of lost coins is estimated as all coins that have not moved in over seven years.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/current_adjusted?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The estimated year-over-year change in the share of Bitcoin supply held or traded in Asia.\n\nTechnical. Geolocation of 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 probability that each entity is located in the US, Europe, or Asia. Working hours are defined as:\n* US: 8am to 8pm Eastern Time (13:00-01:00 UTC)\n* EU: 8am to 8pm Central European Time (07:00-19:00 UTC)\n* Asia: 8am to 8pm China Standard Time (00:00-12:00 UTC)\nAn entity's balance contributes to a region's supply only when its location can be determined with high certainty. Supply held on exchange wallets is excluded.\n\nInterpretation. Positive values mean Asia's attributed share of supply is expanding relative to a year ago, negative values that it is contracting.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/apac_1y_supply_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Burn Rate (Base Fee) is the ongoing pace at which ETH is destroyed by the EIP-1559 base-fee mechanism introduced by the London Hard Fork.\n\nTechnical. EIP-1559 established a per-transaction base fee that is sent to a burn address rather than to the block producer, reducing the overall ETH supply at a rate set by blockspace demand and per-block fullness.\n\nInterpretation. Tracks the deflationary pressure on the ETH supply base.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h, 1w, 1month
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/burn_rate?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Burned Supply is the cumulative sum of ETH destroyed by the EIP-1559 base-fee mechanism since the London Hard Fork activated it.\n\nTechnical. EIP-1559 established a per-transaction base fee that is sent to a burn address rather than to the block producer, reducing the overall ETH supply.\n\nInterpretation. Indicates the cumulative deflationary pressure on Ethereum.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h, 1w, 1month
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/burned?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of all coins ever created or issued, i.e. the circulating supply.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h, 1w, 1month
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/current?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. EU Year-over-Year Supply Change is an estimate of the year-over-year change in the share of Bitcoin supply held or traded in Europe.\n\nTechnical. Geolocation 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), and Asia 8am to 8pm China Standard Time (00:00-12:00 UTC). An entity's balance contributes to a region's supply only when its location can be determined with high certainty. Supply held on exchange wallets is excluded.\n\nInterpretation. Positive readings mean the EU-attributed share of supply is expanding versus a year ago, negative readings that it is contracting.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/emea_1y_supply_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total supply held by entities classified as highly liquid.\n\nTechnical. The liquidity of an entity is defined as the ratio of cumulative outflows to cumulative inflows over the entity's lifespan. An entity is considered illiquid, liquid, or highly liquid when its liquidity L sits at ≲ 0.25, between 0.25 and 0.75, or ≳ 0.75 respectively.\n\nNotes. For more information, see the introductory article on Bitcoin liquidity.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/highly_liquid_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. A bundle of all active supply age bands. Each colored band shows the percentage of in existence that was last moved within the time period denoted in the legend, so every vertical slice sums to 100%.\n\nNotes. The concept of HODL Waves was first described in the post on HODL Waves by Unchained Capital.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/hodl_waves?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total supply held by entities classified as illiquid.\n\nTechnical. The liquidity of an entity is defined as the ratio of cumulative outflows to cumulative inflows over the entity's lifespan. An entity is considered illiquid, liquid, or highly liquid when its liquidity L sits at ≲ 0.25, between 0.25 and 0.75, or ≳ 0.75 respectively.\n\nNotes. For more information, see the introductory article on Bitcoin liquidity.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/illiquid_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The monthly (30d) net change of supply held by illiquid entities.\n\nInterpretation. Positive prints record net migration into illiquid wallets, negative prints record the inverse.\n\nNotes. For more information, see the introductory article on Bitcoin liquidity.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/illiquid_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Inflation Rate is the percentage of newly issued coins divided by the current supply.\n\nTechnical. Reported as an annualised percent.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/inflation_rate?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of new coins added to the current supply, i.e. minted coins or new coins released to the network.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/issued?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total supply held by illiquid, liquid, and highly liquid entities, stacked into a single composite view. The three legs are mutually exclusive and sum to circulating supply by construction.\n\nTechnical. The liquidity of an entity is defined as the ratio of cumulative outflows to cumulative inflows over the entity's lifespan. An entity is considered illiquid, liquid, or highly liquid when its liquidity L sits at ≲ 0.25, between 0.25 and 0.75, or ≳ 0.75 respectively.\n\nNotes. For more information, see the introductory article on Bitcoin liquidity.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/liquid_illiquid_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total supply held by entities classified as liquid.\n\nTechnical. The liquidity of an entity is defined as the ratio of cumulative outflows to cumulative inflows over the entity's lifespan. An entity is considered illiquid, liquid, or highly liquid when its liquidity L sits at ≲ 0.25, between 0.25 and 0.75, or ≳ 0.75 respectively.\n\nNotes. For more information, see the introductory article on Bitcoin liquidity.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/liquid_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The monthly (30d) net change of supply held by liquid and highly liquid entities combined.\n\nInterpretation. Positive prints record net migration into liquid and highly liquid wallets, negative prints record the inverse.\n\nNotes. For more information, see the introductory article on Bitcoin liquidity.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/liquid_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Long-Term Holder Net Position Change is the monthly net position change of long-term holders, i.e. the 30-day change in supply held by long-term holders.\n\nTechnical. 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.\n\nInterpretation. Positive prints mean coin maturation into the long-term-holder cohort exceeds spending out of it, negative prints mean the cohort is net-distributing.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/lth_net_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of circulating supply held by long-term holders.\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/lth_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of circulating supply currently in loss and held by long-term holders.\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/lth_loss_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of circulating supply currently in profit and held by long-term holders.\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/lth_profit_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of issued ETH. Reported as the cumulative gross mint, before any EIP-1559 burn.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h, 1w, 1month
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/minted?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The circulating supply held by addresses, segmented into month-over-month activity retention cohorts:\n* `New`: addresses that interacted with the asset for the first time during the last 30 days.\n* `Retained (Increase)`: addresses active in both the previous and current 30-day period that increased their activity.\n* `Retained (Equal)`: addresses active in both the previous and current 30-day period with the same activity.\n* `Retained (Decrease)`: addresses active in both the previous and current 30-day period that reduced their activity.\n* `Resurrected`: addresses active in the current 30-day period but inactive in the previous one.\n* `Churned`: addresses active in the previous 30-day period but inactive in the current one.\n* `Dead`: addresses inactive in both the current and previous 30-day periods, but active at some point before.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/activity_retention?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The supply held by addresses that currently hold the selected asset or held it previously, segmented into retention cohorts. The cohorts are defined as follows. `New`, addresses that interacted with the asset for the first time during the last 30 days and have a non-zero balance. `Retained (Increase)`, addresses that had a non-zero balance 30 days ago and have increased their holdings since then. `Retained (Equal)`, addresses that have the same non-zero balance now as 30 days ago. `Retained (Decrease)`, addresses that had a non-zero balance 30 days ago and have reduced their holdings since then but still have a positive balance. `Resurrected`, addresses with a non-zero balance that did not hold any supply 30 days ago, excluding addresses that appeared for the first time during the last 30 days (those are captured in `New`).\n\nTechnical. Addresses with a balance below a dust threshold are not considered holders, and their balance is not included in the supply shown here.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/holder_retention?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The percentage of circulating supply in profit, meaning the share of existing coins whose price at the time they last moved was lower than the current price.\n\nInterpretation. A reading of 50% marks the crossing between profit-dominated and loss-dominated supply.\n\nNotes. For more information, see Dissecting Bitcoin's Unrealised On-Chain Profit/Loss.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/profit_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The estimated supply of "zombie" BTC, coins that have been inactive since the launch of the first BTC exchange in July 2010. Patoshi-mined coins are included in this category.\n\nTechnical. Coins are labeled probably lost because there is a non-zero probability that they can still be spent. The series steadily decreases as coins from before July 2010 are spent, eventually converging to the real number of lost coins.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/probably_lost?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of BTC that is provably lost, covering coins that fall into one of three categories: unclaimed miner rewards, BTC sent to burn addresses, and BTC sent to OP_RETURN outputs.\n\nTechnical. Unclaimed miner rewards arise because the Bitcoin protocol allows the miner of a valid block to claim a reward plus transaction fees, but miners may claim less than the specified amount. A burn address is identified as an address whose private key has provably no owner, such as one virtually impossible to be randomly generated (for example, `1Anything11111111111111111125qfuN`). OP_RETURN is a script opcode primarily used to store data on the blockchain, and coins sent to OP_RETURN are provably unspendable as they do not get added to the UTXO set.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/provably_lost?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. A breakdown of Realized Cap by date bands, where each band refers to the date the underlying UTXO was created. Summing across all bands recovers the aggregate Realized Cap.\n\nTechnical. Similar in concept to Realized Cap HODL Waves, this metric uses absolute calendar date ranges instead of floating time periods.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/rcap_by_date_bands?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. HODL Waves weighted by Realized Price. Each band reports the share of USD-denominated cost basis held by coins in that age range, and the bands sum to 100% by construction.\n\nNotes. This visualization of HODL Waves was first introduced by @typerbole.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/rcap_hodl_waves?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Long- and Short-Term Holder Supply in Profit/Loss is the relative amount of circulating supply held by long- and short-term holders in profit or loss, decomposed into four shares (LTH-in-profit, LTH-in-loss, STH-in-profit, STH-in-loss).\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/lth_sth_profit_loss_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. A breakdown of the relative Realized Cap by date bands, where each band refers to the date the underlying UTXO was created and is expressed as a share of total Realized Cap.\n\nTechnical. Similar in concept to Realized Cap HODL Waves, this metric uses absolute calendar date ranges instead of floating time periods.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/rcap_by_date_bands_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. A breakdown of the relative supply by date bands, where each band refers to the date the underlying UTXO was created and is expressed as a share of total supply.\n\nTechnical. Similar in concept to HODL Waves, this metric uses absolute calendar date ranges instead of floating time periods.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/supply_by_date_bands_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/revived_more_1y_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/revived_more_2y_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/revived_more_3y_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/revived_more_5y_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Short-Term Holder (STH) Profit/Loss Ratio is the ratio of Short-Term Holder Supply in Profit to Short-Term Holder Supply in Loss.\n\nInterpretation. Similar to SOPR, the STH Profit/Loss Ratio surfaces local bottoms in bull markets and local tops in bear markets via the short-term holder cohort. A reading of 1.0 marks the boundary between aggregate profit and aggregate loss across the short-term holder cohort.\n\nNotes. First put forward by ARK Invest.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/sth_profit_loss_ratio?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total circulating supply held by short-term holders.\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/sth_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total circulating supply currently at a loss and held by short-term holders.\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/sth_loss_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total circulating supply currently in profit and held by short-term holders.\n\nTechnical. 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.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/sth_profit_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Short to Long-Term Realized Value (SLRV) Ratio is the ratio of the 24h realized HODL wave to the 6m-1y realized HODL wave, used as a measurement for comparing short-term and long-term velocity for bear market detection.\n\nNotes. First put forward by ARK Invest.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/sth_lth_realized_value_ratio?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. A breakdown of total supply by date bands, where each band refers to the date the underlying UTXO was created. Summing across all bands recovers the aggregate circulating supply.\n\nTechnical. Similar in concept to HODL Waves, this metric uses absolute calendar date ranges instead of floating time periods.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/supply_by_date_bands?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. A breakdown of total Bitcoin supply by transaction output type. Transaction output types, or txout types for short, are determined by the type of Bitcoin script conditions used to lock Bitcoin in the output. The most common transaction output types are:\n\n- 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.\n- P2WPKH (Pay to Witness Public Key Hash): The SegWit version of P2PKH.\n- P2WSH (Pay to Witness Script Hash): The SegWit version of P2SH. This type comes in two variants.\n- P2SH (Pay to Script Hash): Funds are locked using arbitrary Bitcoin script instructions.\n- P2PKH (Pay to Public Key Hash): The successor of P2PK, locking funds using the hash of a public key.\n- P2PK (Pay to Public Key): The first available type, locking funds using a public key.\n- Other: Serves as catch-all for all outputs whose script instructions do not match any of the most commonly used output types listed above.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/supply_by_txout_type?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. 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.\n\nNotes. For more information, see our article on dissecting Bitcoin's unrealised on-chain profit/loss.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/loss_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. 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.\n\nNotes. For more information, see our article on dissecting Bitcoin's unrealised on-chain profit/loss.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/profit_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved in the last 24 hours.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_24h?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of circulating supply last moved more than 10 years ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_more_10y?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The percent of circulating supply that has not moved in at least 1 year.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_more_1y_percent?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 1 day and 1 week ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_1d_1w?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 1 month and 3 months ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_1m_3m?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 1 week and 1 month ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_1w_1m?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 1 year and 2 years ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_1y_2y?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The percent of circulating supply that has not moved in at least 2 years.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_more_2y_percent?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 2 years and 3 years ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_2y_3y?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The percent of circulating supply that has not moved in at least 3 years.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_more_3y_percent?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 3 months and 6 months ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_3m_6m?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 3 years and 5 years ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_3y_5y?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The percent of circulating supply that has not moved in at least 5 years.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_more_5y_percent?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 5 years and 7 years ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_5y_7y?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 6 months and 12 months ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt, sol, ton, trx. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_6m_12m?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The amount of circulating supply last moved between 7 years and 10 years ago.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/active_7y_10y?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. Tips, also known as priority fees, are fees paid by users on Ethereum to expedite their transactions, rewarding validators for prioritizing them. This metric captures the supplementary income received by validators beyond the base fee for ensuring timely transaction processing.\n\nTechnical. Priority fees were introduced as part of the London Hard Fork via the Ethereum Improvement Proposal (EIP-1559). Before the Paris upgrade, miners received these tips, but with the transition to Proof-of-Stake, validators now benefit from these additional fees.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h, 1w, 1month
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/tips?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. The total amount of tokens that have been minted and exist on-chain across supported networks. Unlike circulating supply metrics, this metric captures the complete on-chain supply without excluding locked, vested, or otherwise restricted tokens, providing a view of all tokens that have been created on the blockchain regardless of their current accessibility or transferability status.\n\nTechnical. Available for all supported tokens, including both per-network breakdowns and an aggregated cross-chain total.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 10m, 1h, 24h
format - csv, json
jsonPossible values: currency - native, usd
timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/total_minted_supply?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Definition. US Year-over-Year Supply Change is an estimate of the year-over-year change in the share of Bitcoin supply held or traded in the US.\n\nTechnical. Geolocation 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), and Asia 8am to 8pm China Standard Time (00:00-12:00 UTC). An entity's balance contributes to a region's supply only when its location can be determined with high certainty. Supply held on exchange wallets is excluded.\n\nInterpretation. Positive readings mean the US-attributed share of supply is expanding versus a year ago, negative readings that it is contracting.\n
Your Glassnode API key
asset id - (see metadata (metadata/metric) page for more details)
since, unix timestamp
until, unix timestamp
frequency interval - 24h
format - csv, json
jsonPossible values: timestamp format - unix or humanized (RFC 3339)
unixPossible values: Successful response
Unix timestamp
1726790400Metric value (can be number, object, or array depending on the metric)
822077Bad Request - Invalid parameters or unsupported asset
Unauthorized - Invalid or missing API key
Too Many Requests - Rate limit exceeded
GET /v1/metrics/supply/amer_1y_supply_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
{
"t": 1726790400,
"v": 822077
}
]Last updated