Glassnode Docs
Glassnode Docs
Home
Studio
Insights
Intro
Changelog
General Info
On-Chain Data
Derivatives Data
FAQ
API
Overview
API Key
Metrics List
Assets List
API Endpoints
Addresses
Blockchain
Derivatives
Distribution
Entities
ETH 2.0
Fees
Indicators
Institutions
Market
Mining
Protocols
DeFi
Supply
Transactions
Powered by GitBook

Supply

get
Liquid and Illiquid Supply

https://api.glassnode.com/v1/metrics/supply/liquid_illiquid_sum
The total supply held by illiquid, liquid, and highly liquid entities. The liquidity of an entity is defined as the ratio of cumulative outflows and cumulative inflows over the entity's lifespan. An entity is considered to be illiquid / liquid / highly liquid if its liquidity L is ≲ 0.25 / 0.25 ≲ L ≲ 0.75 / 0.75 ≲ L, respectively. For more information see our introductory article on Bitcoin liquidity (https://insights.glassnode.com/bitcoin-liquid-supply). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LiquidIlliquidSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"o":{"highly_liquid":3211979.45434195,"illiquid":14286155.5444539,"liquid":1144073.54617509}}]
400: Bad Request
unsupported asset

get
Liquid Supply Change

https://api.glassnode.com/v1/metrics/supply/liquid_change
The monthly (30d) net change of supply held by liquid and highly liquid entities. For more information see our introductory article on Bitcoin liquidity (https://insights.glassnode.com/bitcoin-liquid-supply). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LiquidChange
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":-36286.8907613509}]
400: Bad Request
unsupported asset

get
Illiquid Supply Change

https://api.glassnode.com/v1/metrics/supply/illiquid_change
The monthly (30d) net change of supply held by illiquid entities. For more information see our introductory article on Bitcoin liquidity (https://insights.glassnode.com/bitcoin-liquid-supply). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.IlliquidChange
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":63499.39076135}]
400: Bad Request
unsupported asset

get
Circulating Supply

https://api.glassnode.com/v1/metrics/supply/current
The total amount of all coins ever created/issued, i.e. the circulating supply. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Current
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h, 10m, 1w, 1month
f
optional
string
format: JSON, CSV
c
optional
string
currency: USD, NATIVE
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":18642237.5}]
400: Bad Request
unsupported asset

get
Issuance

https://api.glassnode.com/v1/metrics/supply/issued
The total amount of new coins added to the current supply, i.e. minted coins or new coins released to the network. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Issued
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h, 10m
f
optional
string
format: JSON, CSV
c
optional
string
currency: USD, NATIVE
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":812.5}]
400: Bad Request
unsupported asset

get
Inflation Rate

https://api.glassnode.com/v1/metrics/supply/inflation_rate
The yearly inflation rate, i.e. the percentage of new coins issued, divided by the current supply (annualized). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.InflationRate
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":0.01603495098272356}]
400: Bad Request
unsupported asset

get
Supply Last Active < 24h

https://api.glassnode.com/v1/metrics/supply/active_24h
The amount of circulating supply last moved in the last 24 hours. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active24H
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":233939.129930867}]
400: Bad Request
unsupported asset

get
Supply Last Active 1d-1w

https://api.glassnode.com/v1/metrics/supply/active_1d_1w
The amount of circulating supply last moved between 1 day and 1 week ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active1D1W
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":789358.463747983}]
400: Bad Request
unsupported asset

get
Supply Last Active 1w-1m

https://api.glassnode.com/v1/metrics/supply/active_1w_1m
The amount of circulating supply last moved between 1 week and 1 month ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active1W1M
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1562687.4585108}]
400: Bad Request
unsupported asset

get
Supply Last Active 1m-3m

https://api.glassnode.com/v1/metrics/supply/active_1m_3m
The amount of circulating supply last moved between 1 month and 3 months ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active1M3M
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":2779665.1789717}]
400: Bad Request
unsupported asset

get
Supply Last Active 3m-6m

https://api.glassnode.com/v1/metrics/supply/active_3m_6m
The amount of circulating supply last moved between 3 months and 6 months ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active3M6M
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1280272.6049434}]
400: Bad Request
unsupported asset

get
Supply Last Active 6m-12m

https://api.glassnode.com/v1/metrics/supply/active_6m_12m
The amount of circulating supply last moved between 6 months and 12 months ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active6M12M
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1555726.99288638}]
400: Bad Request
unsupported asset

get
Supply Last Active 1y-2y

https://api.glassnode.com/v1/metrics/supply/active_1y_2y
The amount of circulating supply last moved between 1 year and 2 years ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active1Y2Y
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1867493.27412408}]
400: Bad Request
unsupported asset

get
Supply Last Active 2y-3y

https://api.glassnode.com/v1/metrics/supply/active_2y_3y
The amount of circulating supply last moved between 2 years and 3 years ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active2Y3Y
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1986381.86580901}]
400: Bad Request
unsupported asset

get
Supply Last Active 3y-5y

https://api.glassnode.com/v1/metrics/supply/active_3y_5y
The amount of circulating supply last moved between 3 years and 5 years ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active3Y5Y
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":2521489.65220627}]
400: Bad Request
unsupported asset

get
Supply Last Active 5y-7y

https://api.glassnode.com/v1/metrics/supply/active_5y_7y
The amount of circulating supply last moved between 5 years and 7 years ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active5Y7Y
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":733391.561829753}]
400: Bad Request
unsupported asset

get
Supply Last Active Supply 7y-10y

https://api.glassnode.com/v1/metrics/supply/active_7y_10y
The amount of circulating supply last moved between 7 years and 10 years ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.Active7Y10Y
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1340814.66965948}]
400: Bad Request
unsupported asset

get
Supply Last Active >10y

https://api.glassnode.com/v1/metrics/supply/active_more_10y
The amount of circulating supply last moved more than 10 years ago. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ActiveMore10Y
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":1990987.69235172}]
400: Bad Request
unsupported asset

get
HODL Waves

https://api.glassnode.com/v1/metrics/supply/hodl_waves
Bundle of all active supply age bands, aka HODL waves. Each colored band shows the percentage of Bitcoin in existence that was last moved within the time period denoted in the legend. The concept of HODL waves was first described in this post (https://www.unchained-capital.com/blog/hodl-waves-1/) by Unchained Capital (https://twitter.com/unchainedcap). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.HodlWaves
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"o":{"1d_1w":0.0423424743809847,"1m_3m":0.149105770107891,"1w_1m":0.0838251019230284,"1y_2y":0.100175382602227,"24h":0.0125488761706242,"2y_3y":0.106552760408133,"3m_6m":0.0686759089376152,"3y_5y":0.135256814113985,"5y_7y":0.0393403185550958,"6m_12m":0.0834517312037454,"7y_10y":0.0719234839519387,"more_10y":0.106799824449813}}]
400: Bad Request
unsupported asset

get
Supply Last Active 1+ Years Ago

https://api.glassnode.com/v1/metrics/supply/active_more_1y_percent
The percent of circulating supply that has not moved in at least 1 year. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ActiveMore1YPercent
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":0.560048584081162}]
400: Bad Request
unsupported asset

get
Supply Last Active 2+ Years Ago

https://api.glassnode.com/v1/metrics/supply/active_more_2y_percent
The percent of circulating supply that has not moved in at least 2 years. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ActiveMore2YPercent
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":0.459873201478951}]
400: Bad Request
unsupported asset

get
Supply Last Active 3+ Years Ago

https://api.glassnode.com/v1/metrics/supply/active_more_3y_percent
The percent of circulating supply that has not moved in at least 3 years. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ActiveMore3YPercent
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":0.353320441070827}]
400: Bad Request
unsupported asset

get
Supply Last Active 5+ Years Ago

https://api.glassnode.com/v1/metrics/supply/active_more_5y_percent
The percent of circulating supply that has not moved in at least 5 years. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ActiveMore5YPercent
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":0.21806362695684}]
400: Bad Request
unsupported asset

get
Realized Cap HODL Waves

https://api.glassnode.com/v1/metrics/supply/rcap_hodl_waves
HODL Waves (https://studio.glassnode.com/metrics?a=BTC&m=supply.HodlWaves) weighted by Realized Price (https://studio.glassnode.com/metrics?a=BTC&m=market.PriceRealizedUsd), The idea for this visualization of HODL waves was first introduced by @typerbole (https://twitter.com/typerbole). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.RcapHodlWaves
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"o":{"1d_1w":0.134582222871136,"1m_3m":0.297292774958315,"1w_1m":0.262816514753678,"1y_2y":0.0573075556214338,"24h":0.0401194237139548,"2y_3y":0.0377140693031249,"3m_6m":0.0629451050772347,"3y_5y":0.0541506524192211,"5y_7y":0.00116650500732619,"6m_12m":0.0510635207384371,"7y_10y":0.000840854910735465,"more_10y":8.0062545896271e-7}}]
400: Bad Request
unsupported asset

get
Adjusted Supply

https://api.glassnode.com/v1/metrics/supply/current_adjusted
The circulating supply adjusted by accounting for lost coins. The amount of lost coins is estimated by all those that have not moved in over 7 years. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.CurrentAdjusted
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":15265060.6430131}]
400: Bad Request
unsupported asset

get
Supply in Profit

https://api.glassnode.com/v1/metrics/supply/profit_sum
The circulating supply in profit, i.e. the amount of coins whose price at the time they last moved was lower than the current price. For more information see this article (https://medium.com/glassnode-insights/dissecting-bitcoins-unrealised-on-chain-profit-loss-73e735020c8d). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ProfitSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":17793885.1168379}]
400: Bad Request
unsupported asset

get
Supply in Loss

https://api.glassnode.com/v1/metrics/supply/loss_sum
The circulating supply in loss, i.e. the amount of coins whose price at the time they last moved was higher than the current price. For more information see this article (https://medium.com/glassnode-insights/dissecting-bitcoins-unrealised-on-chain-profit-loss-73e735020c8d). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LossSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":835381.97866036}]
400: Bad Request
unsupported asset

get
Percent Supply in Profit

https://api.glassnode.com/v1/metrics/supply/profit_relative
The percentage of circulating supply in profit, i.e. the percentage of existing coins whose price at the time they last moved was lower than the current price. For more information see this article (https://medium.com/glassnode-insights/dissecting-bitcoins-unrealised-on-chain-profit-loss-73e735020c8d). View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.ProfitRelative
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 1h, 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":0.955157549978859}]
400: Bad Request
unsupported asset

get
Short-Term Holder Supply

https://api.glassnode.com/v1/metrics/supply/sth_sum
The total amount of circulating supply held by short-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.SthSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":5105123.93540608}]
400: Bad Request
unsupported asset

get
Long-Term Holder Supply

https://api.glassnode.com/v1/metrics/supply/lth_sum
The total amount of circulating supply held by long-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LthSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":10931065.646591}]
400: Bad Request
unsupported asset

get
Short-Term Holder Supply in Loss

https://api.glassnode.com/v1/metrics/supply/sth_loss_sum
The total amount of circulating supply that is currently at loss and held by short-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.SthLossSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":509797.725689634}]
400: Bad Request
unsupported asset

get
Long-Term Holder Supply in Loss

https://api.glassnode.com/v1/metrics/supply/lth_loss_sum
The total amount of circulating supply that is currently at loss and held by long-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LthLossSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":264.641770126075}]
400: Bad Request
unsupported asset

get
Short-Term Holder Supply in Profit

https://api.glassnode.com/v1/metrics/supply/sth_profit_sum
The total amount of circulating supply that is currently in profit and held by short-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.SthProfitSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":4592500.41434874}]
400: Bad Request
unsupported asset

get
Long-Term Holder Supply in Profit

https://api.glassnode.com/v1/metrics/supply/lth_profit_sum
The total amount of circulating supply that is currently in profit and held by long-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LthProfitSum
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
c
optional
string
currency: NATIVE, USD
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":10930801.0038727}]
400: Bad Request
unsupported asset

get
Relative Long/Short-Term Holder Supply

https://api.glassnode.com/v1/metrics/supply/lth_sth_profit_loss_relative
The relative amount of circulating supply of held by long- and short-term holders in profit/loss. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LthSthProfitLossRelative
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"o":{"lth_loss":0.0000165027838298427,"lth_profit":0.681633311204059,"sth_loss":0.0317904526560321,"sth_profit":0.286383519655098}}]
400: Bad Request
unsupported asset

get
Long-Term Holder Position Change

https://api.glassnode.com/v1/metrics/supply/lth_net_change
The monthly net position change of long-term holders, i.e. the 30 day change in supply held by long-term holders. View in Studio: https://studio.glassnode.com/metrics?a=BTC&m=supply.LthNetChange
Request
Response
Request
Query Parameters
a
required
string
asset symbol (see endpoints page for more details)
s
optional
integer
since, unix timestamp
u
optional
integer
until, unix timestamp
i
optional
string
frequency interval: 24h
f
optional
string
format: JSON, CSV
timestamp_format
optional
string
timestamp format: unix or humanized (RFC 3339)
Response
200: OK
[{"t":1614556800,"v":-195423.814292865}]
400: Bad Request
unsupported asset
API Endpoints - Previous
DeFi
Next - API Endpoints
Transactions
1
Last updated 3 weeks ago
Contents
get
Liquid and Illiquid Supply
get
Liquid Supply Change
get
Illiquid Supply Change
get
Circulating Supply
get
Issuance
get
Inflation Rate
get
Supply Last Active < 24h
get
Supply Last Active 1d-1w
get
Supply Last Active 1w-1m
get
Supply Last Active 1m-3m
get
Supply Last Active 3m-6m
get
Supply Last Active 6m-12m
get
Supply Last Active 1y-2y
get
Supply Last Active 2y-3y
get
Supply Last Active 3y-5y
get
Supply Last Active 5y-7y
get
Supply Last Active Supply 7y-10y
get
Supply Last Active >10y
get
HODL Waves
get
Supply Last Active 1+ Years Ago
get
Supply Last Active 2+ Years Ago
get
Supply Last Active 3+ Years Ago
get
Supply Last Active 5+ Years Ago
get
Realized Cap HODL Waves
get
Adjusted Supply
get
Supply in Profit
get
Supply in Loss
get
Percent Supply in Profit
get
Short-Term Holder Supply
get
Long-Term Holder Supply
get
Short-Term Holder Supply in Loss
get
Long-Term Holder Supply in Loss
get
Short-Term Holder Supply in Profit
get
Long-Term Holder Supply in Profit
get
Relative Long/Short-Term Holder Supply
get
Long-Term Holder Position Change