Breakdowns

Market Cap by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/marketcap_usd_by_age

Market Capitalization (Market Cap) is a fundamental metric that calculates the total market value of a digital asset at a given time. It is computed by multiplying the current market price by the total supply of the asset. The Market Cap by Age metric further refines this by categorizing digital assets into different age cohorts, providing a detailed view of the total market value of supply of varying ages. This metric is beneficial for understanding value distribution across different age cohorts, from hot supply (newly acquired coins) to cold supply (older, dormant coins). For example, it can help answer questions like, 'Is the majority of the market value held in older or newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":7100635070.746604,"1m_3m":26355339492.04911,"1w_1m":13039335505.503368,"1y_2y":69032569653.75183,"24h":1730834044.2148147,"2y_3y":57874118524.75218,"3m_6m":36916274969.72848,"3y_5y":50216954337.31201,"5y_7y":36426980285.94399,"6m_12m":46529178446.62636,"7y_10y":27067987440.97667,"aggregated":431700497844.703,"more_10y":59410290073.09757}}]

400 Bad Request

unsupported asset

Market Cap by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/marketcap_usd_by_wallet_size

Market Capitalization (Market Cap) is a fundamental metric that calculates the total market value of a digital asset at a given time. It is computed by multiplying the current market price by the total supply of the asset. The Market Cap by Wallet Size metric takes this a step further by categorizing digital assets according to the size of their wallets, providing a granular view of the total market value held by different investor classes, from whales to retail investors. This metric is particularly useful for identifying potential discrepancies in the investment base and understanding the behavior of different investor classes. For instance, it can help answer questions like, 'Are larger wallets (whales) holding a greater proportion of the market value compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":870932195.5990841,"001_01":5522692926.505756,"01_1":22662509831.83227,"100_1k":87609558216.77469,"10_100":98928883635.52878,"10k_100k":53199680087.372536,"1_10":46262488715.39022,"1k_10k":101709959727.92792,"above_100k":14830998139.24016,"aggregated":431700497844.703,"less_0001":102794368.53160167}}]

400 Bad Request

unsupported asset

MVRV by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/mvrv_by_age

The MVRV by Age metric is a nuanced version of the Market Value to Realized Value (MVRV) ratio, which compares the market capitalization (the current market value) to the realized capitalization (the value when the coins last moved). The MVRV by Age metric categorizes digital assets into different age cohorts, providing an aggregate assessment of the Unrealized Profit or Loss held across varying age groups. This metric is particularly useful for differentiating the behavior of investors who hold assets for an extended period of time versus those who trade frequently in the short term. For example, it can help answer questions like, 'Are older coins being held at a higher relative valuation than coins that recently changed hands?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":0.9545917482469006,"1m_3m":1.1671999830300188,"1w_1m":0.9583124657092619,"1y_2y":0.4819089229397759,"24h":0.9959198489000117,"2y_3y":0.8513770360498769,"3m_6m":1.210120860339111,"3y_5y":3.052943357800031,"5y_7y":3.649241793689629,"6m_12m":0.7662808054558926,"7y_10y":53.704586112177395,"aggregated":1.151945747487555,"more_10y":7694.111524264469}}]

400 Bad Request

unsupported asset

MVRV by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/mvrv_by_wallet_size

The MVRV by Wallet Size metric is a more detailed version of the Market Value to Realized Value (MVRV) ratio. The MVRV ratio is a key indicator that compares the market capitalization (the current market value) to the realized capitalization (the value when the coins last moved). By categorizing digital assets according to the size of their wallets, the MVRV by Wallet Size metric provides a granular assessment of the Unrealized Profit or Loss held across different investor classes, from whales to retail investors alike. This metric is particularly useful for identifying potential discrepancies in the investment base and understanding the behavior of different investor classes. For instance, it can help answer questions like, 'Are larger wallets (whales) holding their assets at a higher value compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":1.0594582939043042,"001_01":1.0102699463828142,"01_1":1.0071203025953492,"100_1k":0.9882082537989043,"10_100":1.8914911146398798,"10k_100k":1.0582470951255771,"1_10":1.0450470153392823,"1k_10k":1.12561312504499,"above_100k":0.7408459883690758,"aggregated":1.1519457474875399,"less_0001":1.1258665147843614}}]

400 Bad Request

unsupported asset

Realized Cap by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/marketcap_realized_usd_by_age

Realized Capitalization (Realized Cap) is a key metric that calculates the total value of a digital asset based on the price at the time each unit last moved. In other words, it reflects the total acquisition cost of all coins in circulation. The Realized Cap by Age metric provides an additional layer of detail by categorizing digital assets into different age cohorts, offering a comprehensive view of the acquisition cost of supply portions of varying ages. This metric is particularly useful for understanding the distribution of network wealth across different age cohorts, from hot supply (coins that recently moved) to cold supply (older, dormant coins). For example, it can help answer questions like, 'Is the majority of the acquisition cost concentrated in older or newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":7438399801.576808,"1m_3m":22579969050.060627,"1w_1m":13606559417.812391,"1y_2y":143248166546.9781,"24h":1737925040.9824765,"2y_3y":67977072523.907845,"3m_6m":30506271050.796913,"3y_5y":16448701614.136282,"5y_7y":9982068151.508774,"6m_12m":60720793363.660194,"7y_10y":504016312.20911807,"aggregated":374757664400.65515,"more_10y":7721527.025666161}}]

400 Bad Request

unsupported asset

Realized Cap by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/marketcap_realized_usd_by_wallet_size

The Realized Capitalization (Realized Cap) is a significant metric that calculates the total acquisition cost of all coins in circulation, based on the price at the time each unit last moved. The Realized Cap by Wallet Size metric further refines this by categorizing digital assets according to the size of their wallets, providing a granular view of the network wealth held by different investor classes, from whales to retail investors. This metric is particularly useful for identifying potential discrepancies in the investment base and understanding the behavior of different investor classes. For instance, it can help answer questions like, 'Are larger wallets (whales) holding a greater proportion of the acquisition cost compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":822054252.2627618,"001_01":5466551733.305824,"01_1":22502286741.14798,"100_1k":88654954944.95518,"10_100":52302060987.66887,"10k_100k":50271510625.84262,"1_10":44268332463.84686,"1k_10k":90359607102.00731,"above_100k":20019003101.966763,"aggregated":374757664400.6601,"less_0001":91302447.65409866}}]

400 Bad Request

unsupported asset

Realized Loss by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/realized_loss_by_age

Realized Loss is a metric that calculates the total loss of a digital asset based on the difference between the acquisition price and the sale price of all spent coins where the sale price was lower than the acquisition price. The Realized Loss by Age metric further categorizes these losses into different age cohorts, providing a detailed view of the total loss experienced by holders of supply portions of varying ages. This metric is particularly useful for understanding the distribution of losses across different age cohorts, from hot supply (newly acquired coins) to cold supply (older, dormant coins). For example, it can help answer questions like, 'Is the total realized loss greater for hot or cold supply?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 1h, 10m, 24h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":51602628.54859111,"1m_3m":513291.8379399575,"1w_1m":20171060.124893006,"1y_2y":38850084.72691272,"24h":28284974.882683706,"2y_3y":2459933.0451148204,"3m_6m":29053.354229881646,"3y_5y":625.9266313494969,"5y_7y":0,"6m_12m":19341808.39987623,"7y_10y":0,"aggregated":161253460.8468728,"more_10y":0}}]

400 Bad Request

unsupported asset

Realized Loss by LTH/STH

GET https://api.glassnode.com/v1/metrics/breakdowns/realized_loss_by_lth_sth

Realized Loss is a metric that quantifies the total loss of a digital asset, calculated by the difference between the acquisition price and the sale price for all spent coins where the sale price was lower than the acquisition price. The Realized Loss by LTH/STH (Long-Term Holders/Short-Term Holders) metric further enhances this by categorizing digital assets into two cohorts based on the duration of holding. LTH/STH supply is defined with respect to the entity's average purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days. This provides a more nuanced view of the total loss experienced by both long-term and short-term holders. This metric is particularly useful for understanding the distribution of losses across these two characteristic market participants. For example, it can help answer questions like, 'Are long-term holders experiencing more losses compared to short-term holders?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"aggregated":161253460.8468728,"lth":60656924.0500152,"sth":100596536.79685761}}]

400 Bad Request

unsupported asset

Realized Loss by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/realized_loss_by_wallet_size

Realized Loss is a key metric that calculates the total loss of a digital asset based on the difference between the acquisition price and the sale price for all spent coins where the sale price was lower than the acquisition price. The Realized Loss by Wallet Size metric further refines this by categorizing digital assets according to the size of their wallets. This offers a granular view of the total loss experienced by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of losses across different wallet sizes and identifying potential risk concentrations. For example, it can help answer questions like, 'Are larger wallets (whales) experiencing more losses compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":824568.8700269226,"001_01":3013714.5599227636,"01_1":8581444.708051423,"100_1k":42065651.537648015,"10_100":46215013.087193355,"10k_100k":18124226.038835093,"1_10":19086333.06801573,"1k_10k":23298185.76051606,"above_100k":0,"aggregated":161253460.84687278,"less_0001":44323.21666342743}}]

400 Bad Request

unsupported asset

Realized Price by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/price_realized_usd_by_age

Realized Price is a metric that calculates the average acquisition cost of a digital asset based on the price at the time each unit last moved. The Realized Price by Age metric further categorizes digital assets into different age cohorts, providing a detailed view of the average acquisition cost of supply portions of varying ages. This metric is particularly useful for understanding the distribution of acquisition costs across different age cohorts, from hot supply (newly bought coins) to cold supply (older, dormant coins). For example, it can help answer questions like, 'Is the average acquisition cost higher for older or newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":23422.805875653943,"1m_3m":19156.2864417153,"1w_1m":23331.865137682285,"1y_2y":46397.18449969955,"24h":22450.819947392265,"2y_3y":26262.415196712434,"3m_6m":18476.846356836268,"3y_5y":7323.823140236856,"5y_7y":6127.085699926067,"6m_12m":29178.88201099574,"7y_10y":416.33720373497806,"aggregated":19409.9568130311,"more_10y":2.9060167816875695}}]

400 Bad Request

unsupported asset

Realized Price by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/price_realized_usd_by_wallet_size

Realized Price is a key metric that calculates the average acquisition cost of a digital asset based on the price at the time each unit last moved. The Realized Price by Wallet Size metric provides an additional layer of detail by categorizing digital assets according to the size of their wallets. This offers a granular view of the average acquisition cost held by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of acquisition costs across different wallet sizes. For example, it can help answer questions like, 'Is the average acquisition cost higher for larger wallets (whales) compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":21104.386400421983,"001_01":22131.92354156783,"01_1":22201.138386415772,"100_1k":22626.017465179226,"10_100":11820.947524749665,"10k_100k":21128.541068222836,"1_10":21395.417508971295,"1k_10k":19864.033842706474,"above_100k":30180.6550358876,"aggregated":19409.956813031356,"less_0001":19859.563204054222}}]

400 Bad Request

unsupported asset

Realized Profit by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/realized_profit_by_age

Realized Profit is a metric that calculates the total profit of a digital asset based on the difference between the acquisition price and the sale price of all spent coins where the sale price was higher than the acquisition price. The Realized Profit by Age metric further categorizes these profits into different age cohorts, providing a detailed view of the total profit experienced by holders of supply portions of varying ages. This metric is particularly useful for understanding the distribution of profits across different age cohorts, from hot supply (recently acquired coins) to cold supply (older coins). For example, it can help answer questions like, 'Is the total realized profit greater for older or newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":191845.7069618378,"1m_3m":17027715.063747562,"1w_1m":1180208.0135330185,"1y_2y":4224.704125696184,"24h":1974267.0774926636,"2y_3y":6597442.193170626,"3m_6m":8463911.768708665,"3y_5y":6538790.346134689,"5y_7y":8425686.733960144,"6m_12m":2607756.454514844,"7y_10y":211934.80371612925,"aggregated":53226478.28575722,"more_10y":2695.4196913298288}}]

400 Bad Request

unsupported asset

Realized Profit by LTH/STH

GET https://api.glassnode.com/v1/metrics/breakdowns/realized_profit_by_lth_sth

Realized Profit is a metric that quantifies the total profit of a digital asset, calculated by the difference between the sale price and the acquisition price for all spent coins where the sale price was higher than the acquisition price. The Realized Profit by LTH/STH (Long-Term Holders/Short-Term Holders) metric further enhances this by categorizing digital assets into two cohorts based on the duration of holding. LTH/STH supply is defined with respect to the entity's average purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days. This provides a more nuanced view of the total profit experienced by both long-term and short-term holders. This metric is particularly useful for understanding the distribution of profit-taking across these two characteristic market participants. For example, it can help answer questions like, 'Are long-term holders realizing more profits compared to short-term holders?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"aggregated":53226478.285757214,"lth":25188519.880653337,"sth":28037958.405103866}}]

400 Bad Request

unsupported asset

Realized Profit by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/realized_profit_by_wallet_size

Realized Profit is a key metric that calculates the total profit of a digital asset based on the difference between the acquisition price and the sale price for all spent coins where the sale price was higher than the acquisition price. The Realized Profit by Wallet Size metric enhances this by categorizing digital assets according to the size of their wallets. This provides a granular view of the total profit experienced by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of profits across different wallet sizes and identifying potential profit concentrations. For example, it can help answer questions like, 'Are larger wallets (whales) realizing more profits compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 10m, 24h, 1h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":87313.24998182963,"001_01":648225.4645025934,"01_1":2945388.3434351697,"100_1k":24268023.872602534,"10_100":11535459.086561825,"10k_100k":1373782.3739182274,"1_10":7322516.118467251,"1k_10k":5038390.438066989,"above_100k":0,"aggregated":53226478.285757214,"less_0001":7379.3382207913955}}]

400 Bad Request

unsupported asset

SOPR by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/sopr_by_age

The Spent Output Profit Ratio (SOPR) is a metric that calculates the profit or loss made by holders of a digital asset when they sell, based on the difference between the sale price and the acquisition price. The SOPR by Age metric further categorizes this data into different age cohorts, providing a detailed view of the profit or loss realized by holders of supply portions of varying ages. This metric is particularly useful for understanding the distribution of profit-making or loss-making sales across different age cohorts, from hot supply (freshly acquired coins) to cold supply (longer-held coins). For example, it can help answer questions like, 'Are older coins being sold at a profit more frequently compared to newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":0.958303061764237,"1m_3m":1.110891075833814,"1w_1m":0.9635687767191289,"1y_2y":0.4888603790911125,"24h":0.9943698827610964,"2y_3y":1.1508917853636782,"3m_6m":1.1862758532440547,"3y_5y":2.912849763841813,"5y_7y":5.9533187030898285,"6m_12m":0.8270878388593096,"7y_10y":90.82950737443423,"aggregated":0.9841764490189007,"more_10y":3445.1960749172035}}]

400 Bad Request

unsupported asset

SOPR by LTH/STH

GET https://api.glassnode.com/v1/metrics/breakdowns/sopr_by_lth_sth

The Spent Output Profit Ratio (SOPR) is a key metric that calculates the profit or loss made by holders of a digital asset when they sell, based on the difference between the sale price and the acquisition price. The SOPR by LTH/STH (Long-Term Holders/Short-Term Holders) metric further refines this by categorizing digital assets into two cohorts based on the duration of holding. LTH/STH supply is defined with respect to the entity's average purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days. This provides a more nuanced view of the profit or loss realized by both long-term and short-term holders. This metric is particularly useful for understanding the distribution of profit-making or loss-making sales across these two market participants. For example, it can help answer questions like, 'Are long-term holders selling their assets at a profit more frequently compared to short-term holders?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"aggregated":0.9841764490189009,"lth":0.832154787663741,"sth":0.9890322969953519}}]

400 Bad Request

unsupported asset

SOPR by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/sopr_by_wallet_size

The Spent Output Profit Ratio (SOPR) is a critical metric that calculates the profit or loss made by holders of a digital asset when they sell their assets, based on the difference between the sale price and the acquisition price. The SOPR by Wallet Size metric further refines this by categorizing digital assets according to the size of their wallets. This provides a granular view of the profit or loss realized by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of profit-making or loss-making sales across different wallet sizes. For example, it can help answer questions like, 'Are larger wallets (whales) selling their assets at a profit more frequently compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":0.9713780023989513,"001_01":0.9797225599674381,"01_1":0.9831244376945582,"100_1k":0.9914905946992788,"10_100":0.9831213029596199,"10k_100k":0.9532581977827814,"1_10":0.9862839360876259,"1k_10k":0.981503670450248,"aggregated":0.9841764490189004,"less_0001":0.9687952190223835}}]

400 Bad Request

unsupported asset

Spent Volume by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_sum_by_age

Spent Volume is a metric that calculates the total volume of digital assets sold, providing an insight into the overall market activity. The Spent Volume by Age metric further categorizes this data into different age cohorts, offering a detailed view of the volume of assets sold by holders of supply portions of varying ages. This metric is particularly useful for understanding sales distribution across different age cohorts, from hot supply (newly acquired coins) to cold supply (older, dormant coins). This can help identify periods of increased selling activity among different age cohorts. For example, it can help answer questions like, 'Are older coins being sold more frequently than newer ones?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":52662.689778240005,"1m_3m":7386.604233130002,"1w_1m":22394.245811430003,"1y_2y":1653.7683467799998,"24h":207314.68935092,"2y_3y":1405.6228421800001,"3m_6m":2394.94081151,"3y_5y":444.82130438,"5y_7y":452.13398925000007,"6m_12m":3571.3586973099996,"7y_10y":9.25072068,"aggregated":299690.24643985,"more_10y":0.12055404000000002}}]

400 Bad Request

unsupported asset

Spent Volume by LTH/STH

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_sum_by_lth_sth

Spent Volume is a key metric that calculates the total volume of digital assets that have been sold, providing a comprehensive view of overall market activity. The Spent Volume by LTH/STH (Long-Term Holders/Short-Term Holders) version of this metric further refines this data by categorizing digital assets into two cohorts based on the duration of holding. LTH/STH supply is defined with respect to the entity's average purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days. This provides a more nuanced view of the volume of assets sold by both long-term and short-term holders. This metric is particularly useful for understanding sales distribution across these two market participant groups. For example, it can help answer questions like, 'Are long-term holders selling their assets more frequently compared to short-term holders?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 10m, 24h, 1h
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"aggregated":299690.2464398501,"lth":7839.156666885422,"sth":291851.0897729645}}]

400 Bad Request

unsupported asset

Spent Volume by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_sum_by_wallet_size

Spent Volume is a key metric that calculates the total volume of digital assets that have been sold, providing a comprehensive view of overall market activity. The Spent Volume by Wallet Size metric further refines this data by categorizing digital assets according to the size of their wallets. This offers a detailed view of the volume of assets sold by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of sales across different wallet sizes and identifying potential market trends. For example, it can help answer questions like, 'Are larger wallets (whales) selling their assets more frequently compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":1114.0656867999999,"001_01":5090.416273570001,"01_1":14635.816729789998,"100_1k":92449.67204154,"10_100":90100.14969789998,"10k_100k":15238.062949829999,"1_10":37715.811258500005,"1k_10k":43295.16035091001,"above_100k":0,"aggregated":299690.24643984996,"less_0001":51.091451009999986}}]

400 Bad Request

unsupported asset

Spent Volume in Loss by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_loss_sum_by_age

Spent Volume in Loss is a metric that calculates the total volume of digital assets sold at a loss, meaning the sale price was lower than the acquisition price. The Spent Volume in Loss by Age metric further categorizes these volumes into different age cohorts, providing a detailed view of the volume of assets sold at a loss by holders of supply portions of varying ages. This metric is particularly useful for understanding the distribution of loss-making sales across different age cohorts, from hot supply (newly bought coins) to cold supply (older, dormant coins). For example, it can help answer questions like, 'Is the volume of assets sold at a loss greater for older or newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 10m, 24h, 1h
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":51930.47546564,"1m_3m":849.7890798,"1w_1m":19784.235910469997,"1y_2y":1652.9766686699998,"24h":128235.10556093998,"2y_3y":180.00356702000002,"3m_6m":22.135539740000002,"3y_5y":0.04,"5y_7y":0,"6m_12m":2348.09001666,"7y_10y":0,"aggregated":205002.85180894,"more_10y":0}}]

400 Bad Request

unsupported asset

Spent Volume in Loss by LTH/STH

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_loss_sum_by_lth_sth

The Spent Volume in Loss is a metric that quantifies the total volume of digital assets sold at a loss, meaning the sale price was lower than the acquisition price. The Spent Volume in Loss by LTH/STH (Long-Term Holders/Short-Term Holders) metric further enhances this by categorizing digital assets into two cohorts based on the duration of holding. LTH/STH supply is defined with respect to the entity's average purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days. This provides a more nuanced view of the volume of assets sold at a loss by both long-term and short-term holders. This metric is particularly useful for understanding the distribution of loss-making sales across these two market participants. For example, it can help answer questions like, 'Are long-term holders selling their assets at a loss more frequently compared to short-term holders?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"aggregated":205002.85180893997,"lth":4186.39058831104,"sth":200816.46122062893}}]

400 Bad Request

unsupported asset

Spent Volume in Loss by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_loss_sum_by_wallet_size

The Spent Volume in Loss is a metric that calculates the total volume of digital assets sold at a loss, meaning the sale price was lower than the acquisition price. The Spent Volume in Loss by Wallet Size metric further refines this by categorizing digital assets according to the size of their wallets. This provides a granular view of the volume of assets sold at a loss by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of loss-making sales across different wallet sizes and identifying potential risk concentrations. For example, it can help answer questions like, 'Are larger wallets (whales) selling their assets at a loss more frequently compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":855.1088542900001,"001_01":3681.51726494,"01_1":9903.928786010001,"100_1k":58989.97901711001,"10_100":57138.51774521,"10k_100k":14812.725058729997,"1_10":24445.168590120004,"1k_10k":35136.44289633999,"above_100k":0,"aggregated":205002.85180894,"less_0001":39.463596190000004}}]

400 Bad Request

unsupported asset

Spent Volume in Profit by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_profit_sum_by_age

Spent Volume in Profit is a metric that measures the total volume of digital assets sold at a profit, meaning the sale price was higher than the acquisition price. The Spent Volume in Profit by Age metric further categorizes these volumes into different age cohorts, providing a detailed view of the volume of assets sold at a profit by holders of supply portions of varying ages. This metric is particularly useful for understanding the distribution of profit-making sales across different age cohorts, from hot supply (newly bought coins) to cold supply (older, dormant coins). For example, it can help answer questions like, 'Are older coins being sold at a profit more frequently compared to newer coins?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":732.2143126000002,"1m_3m":6536.8151533300015,"1w_1m":2610.00990096,"1y_2y":0.79167811,"24h":76207.20124955001,"2y_3y":1225.61927516,"3m_6m":2372.80527177,"3y_5y":444.78130438000005,"5y_7y":452.13398925000007,"6m_12m":1223.2686806500003,"7y_10y":9.25072068,"aggregated":91815.01209048,"more_10y":0.12055404000000002}}]

400 Bad Request

unsupported asset

Spent Volume in Profit by LTH/STH

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_profit_sum_by_lth_sth

Spent Volume in Profit is a metric that quantifies the total volume of digital assets sold at a profit, meaning the sale price was higher than the acquisition price. The Spent Volume in Profit by LTH/STH (Long-Term Holders/Short-Term Holders) version of this metric further refines this data by categorizing digital assets into two cohorts based on the duration of holding. LTH/STH supply is defined with respect to the entity's average purchasing date with weights given by a logistic function centered at an age of 155 days and a transition width of 10 days. This provides a more nuanced view of the volume of assets sold at a profit by both long-term and short-term holders. This metric is particularly useful for understanding the distribution of profit-making sales across these two market participant groups. For example, it can help answer questions like, 'Are long-term holders realizing profits more frequently compared to short-term holders?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"aggregated":91815.01209048,"lth":3652.765545551796,"sth":88162.24654492822}}]

400 Bad Request

unsupported asset

Spent Volume in Profit by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/spent_volume_profit_sum_by_wallet_size

Spent Volume in Profit is a metric that measures the total volume of digital assets sold at a profit, meaning the sale price was higher than the acquisition price. The Spent Volume in Profit by Wallet Size metric further refines this by categorizing digital assets according to the size of their wallets, offering a detailed view of the volume of assets sold at a profit by different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of profit-making sales across different wallet sizes and identifying potential profit concentrations. For example, it can help answer questions like, 'Are larger wallets (whales) selling their assets at a profit more frequently compared to smaller wallets (retail investors)?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
c	string	currency: NATIVE, USD
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":254.52614031000005,"001_01":1379.7067507100003,"01_1":4603.981582010001,"100_1k":32646.78199141,"10_100":31305.256231940006,"10k_100k":425.33789110000004,"1_10":13029.32086689,"1k_10k":8158.717454569998,"above_100k":0,"aggregated":91815.01209048,"less_0001":11.38318154}}]

400 Bad Request

unsupported asset

Supply by Age

GET https://api.glassnode.com/v1/metrics/breakdowns/supply_by_age

The total supply of a digital asset is a fundamental metric representing the total quantity of that asset in circulation. The Supply by Age metric further categorizes this total supply into different age cohorts, offering a detailed view of the distribution of the total supply across varying holding periods for these assets, from hot supply (recently moved coins) to cold supply (older, dormant coins). This metric is particularly useful for understanding the age distribution of the total supply, which can provide insights into the maturity and stability of a digital asset's market. For example, it can help answer questions like, 'Is the majority of the total supply held in older coins, indicating a mature market, or in newer coins, indicating a growing market?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 24h, 1h, 10m
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"1d_1w":317570.82567586,"1m_3m":1178723.71133947,"1w_1m":583174.95568912,"1y_2y":3087432.31063742,"24h":77410.31485954,"2y_3y":2588378.56361426,"3m_6m":1651053.99815753,"3y_5y":2245917.37118386,"5y_7y":1629170.64333362,"6m_12m":2080984.23170491,"7y_10y":1210596.38122072,"aggregated":19307496.04497096,"more_10y":2657082.7375546503}}]

400 Bad Request

unsupported asset

Supply by Wallet Size

GET https://api.glassnode.com/v1/metrics/breakdowns/supply_by_wallet_size

The total supply of a digital asset is a fundamental metric representing the total quantity of that asset in circulation. The Supply by Wallet Size metric further refines this by categorizing the total supply according to the size of their wallets, providing a granular view of the distribution of the total supply across different investor classes, from whales to retail investors. This metric is particularly useful for understanding the distribution of the total supply across different wallet sizes, which can provide insights into the diversity and concentration of a digital asset's market. For example, it can help answer questions like, 'Is the majority of the total supply held in larger wallets (whales), indicating a concentrated market, or is it more evenly distributed across smaller wallets (retail investors), indicating a diverse market?'

Note: The breakdown metrics utilize an address-based approach, analyzing transactions and holdings based on individual wallet addresses to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the alternative UTXO-based approach for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. As such, metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.

View in Studio

Query Parameters

Name	Type	Description
a*	string	asset symbol: BTC, ETH
s	integer	since, unix timestamp
u	integer	until, unix timestamp
i	string	frequency interval: 10m, 24h, 1h
f	string	format: JSON, CSV
timestamp_format	string	timestamp format: unix or humanized (RFC 3339)

200 OK

[{"t":1677801600,"o":{"0001_001":38951.81962013,"001_01":246998.49170537002,"01_1":1013564.54563233,"100_1k":3918274.83919309,"10_100":4424523.5737798,"10k_100k":2379317.64732448,"1_10":2069056.72419268,"1k_10k":4548905.2131868405,"above_100k":663305.7857148,"aggregated":19307496.04497096,"less_0001":4597.4046214400005}}]

400 Bad Request

unsupported asset