Work directly with Glassnode engineers to solve integration and data challenges.
Request a quote from Glassnode Expert Services
Ctrlk
WebsiteStudioInsightsTwitter
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Supply

Adjusted Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/current_adjusted

Asia Year-over-Year Supply Change

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/apac_1y_supply_change

Burn Rate (Base Fee)

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

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

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/burn_rate

Burned Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

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

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/burned

Circulating Supply

get

Definition. The total amount of all coins ever created or issued, i.e. the circulating supply.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

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

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/current

EU Year-over-Year Supply Change

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/emea_1y_supply_change

Highly Liquid Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/highly_liquid_sum

HODL Waves

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/hodl_waves

Illiquid Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/illiquid_sum

Illiquid Supply Change

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/illiquid_change

Inflation Rate

get

Definition. Inflation Rate is the percentage of newly issued coins divided by the current supply.\n\nTechnical. Reported as an annualised percent.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/inflation_rate

Issuance

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/issued

Liquid and Illiquid Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/liquid_illiquid_sum

Liquid Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/liquid_sum

Liquid Supply Change

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/liquid_change

Long-Term Holder Position Change

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/lth_net_change

Long-Term Holder Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/lth_sum

Long-Term Holder Supply in Loss

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/lth_loss_sum

Long-Term Holder Supply in Profit

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/lth_profit_sum

Minted Supply

get

Definition. The total amount of issued ETH. Reported as the cumulative gross mint, before any EIP-1559 burn.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

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

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/minted

MoM Activity Retention Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/activity_retention

MoM Holder Retention Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/holder_retention

Percent Supply in Profit

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/profit_relative

Probably Lost Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/probably_lost

Provably Lost Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/provably_lost

Realized Cap by Date Bands

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/rcap_by_date_bands

Realized Cap HODL Waves

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/rcap_hodl_waves

Relative Long/Short-Term Holder Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/lth_sth_profit_loss_relative

Relative Realized Cap by Date Bands

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/rcap_by_date_bands_relative

Relative Supply by Date Bands

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/supply_by_date_bands_relative

Revived Supply 1+ Years

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/revived_more_1y_sum

Revived Supply 2+ Years

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/revived_more_2y_sum

Revived Supply 3+ Years

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/revived_more_3y_sum

Revived Supply 5+ Years

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/revived_more_5y_sum

Short-Term Holder Profit/Loss Ratio

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/sth_profit_loss_ratio

Short-Term Holder Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/sth_sum

Short-Term Holder Supply in Loss

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/sth_loss_sum

Short-Term Holder Supply in Profit

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/sth_profit_sum

SLRV Ratio

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/sth_lth_realized_value_ratio

Supply by Date Bands

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/supply_by_date_bands

Supply by TxOut Type

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/supply_by_txout_type

Supply in Loss

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/loss_sum

Supply in Profit

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/profit_sum

Supply Last Active < 24h

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_24h

Supply Last Active >10y

get

Definition. The total amount of circulating supply last moved more than 10 years ago.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_more_10y

Supply Last Active 1+ Years Ago

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_more_1y_percent

Supply Last Active 1d-1w

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_1d_1w

Supply Last Active 1m-3m

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_1m_3m

Supply Last Active 1w-1m

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_1w_1m

Supply Last Active 1y-2y

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_1y_2y

Supply Last Active 2+ Years Ago

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_more_2y_percent

Supply Last Active 2y-3y

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_2y_3y

Supply Last Active 3+ Years Ago

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_more_3y_percent

Supply Last Active 3m-6m

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_3m_6m

Supply Last Active 3y-5y

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_3y_5y

Supply Last Active 5+ Years Ago

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_more_5y_percent

Supply Last Active 5y-7y

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_5y_7y

Supply Last Active 6m-12m

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_6m_12m

Supply Last Active 7y-10y

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/active_7y_10y

Tips (Priority Fee)

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

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

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/tips

Total Minted Supply

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - NATIVE, USD

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/total_minted_supply

US Year-over-Year Supply Change

get

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

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)}

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/supply/amer_1y_supply_change
PreviousSignalsNextTransactions

Last updated