> For the complete documentation index, see [llms.txt](https://docs.glassnode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.glassnode.com/basic-api/endpoints/breakdowns.md).

# Breakdowns

## Addresses in Loss by Age

> \*\*Definition.\*\* The number of unique addresses currently in loss, segmented by holding-period age cohort. An address is in loss when the current price is below its average acquisition price. Cohorts span from hot addresses (coins acquired more recently) to cold addresses (older, dormant coins).\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to facilitate comparability across digital assets and to ensure consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Metrics for UTXO-based assets may show slight deviations when compared across these methods.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.AddressesLossCountByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/addresses_loss_count_by_age":{"get":{"summary":"Addresses in Loss by Age","description":"**Definition.** The number of unique addresses currently in loss, segmented by holding-period age cohort. An address is in loss when the current price is below its average acquisition price. Cohorts span from hot addresses (coins acquired more recently) to cold addresses (older, dormant coins).\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to facilitate comparability across digital assets and to ensure consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Metrics for UTXO-based assets may show slight deviations when compared across these methods.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.AddressesLossCountByAge?a=USDT)\n","operationId":"breakdowns.AddressesLossCountByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Addresses in Profit by Age

> \*\*Definition.\*\* The number of unique addresses currently in profit, segmented by holding-period age cohort. An address is in profit when the current spot price is above its average acquisition price. Cohorts span from hot (most recently acquired) to cold (long dormant).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.AddressesProfitCountByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/addresses_profit_count_by_age":{"get":{"summary":"Addresses in Profit by Age","description":"**Definition.** The number of unique addresses currently in profit, segmented by holding-period age cohort. An address is in profit when the current spot price is above its average acquisition price. Cohorts span from hot (most recently acquired) to cold (long dormant).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.AddressesProfitCountByAge?a=USDT)\n","operationId":"breakdowns.AddressesProfitCountByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Market Cap by Age

> \*\*Definition.\*\* Market Cap by Age decomposes Market Capitalization, the total market value of a digital asset computed as current market price multiplied by total supply, by the holding-period age of the underlying coins. Cohorts span from hot supply (newly acquired) to cold supply (older, dormant coins).\n\n\*\*Technical.\*\* The breakdown uses an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Surfaces how market value is distributed across hot-to-cold age cohorts. Answers questions of the form: is the majority of market value held in older or newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MarketcapUsdByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/marketcap_usd_by_age":{"get":{"summary":"Market Cap by Age","description":"**Definition.** Market Cap by Age decomposes Market Capitalization, the total market value of a digital asset computed as current market price multiplied by total supply, by the holding-period age of the underlying coins. Cohorts span from hot supply (newly acquired) to cold supply (older, dormant coins).\\n\\n**Technical.** The breakdown uses an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Surfaces how market value is distributed across hot-to-cold age cohorts. Answers questions of the form: is the majority of market value held in older or newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MarketcapUsdByAge?a=BTC)\n","operationId":"breakdowns.MarketcapUsdByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Market Cap by PnL

> \*\*Definition.\*\* Market Capitalization (Market Cap) segmented by unrealized profit and loss bands defined around Fibonacci retracement levels. Market Cap is the total market value of an asset, computed as current market price multiplied by total supply. The breakdown distributes that valuation across in-profit and in-loss bands to show how much of the market sits above or below its acquisition cost and at what depth.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level. This contrasts with the UTXO-based approach available for some chains, and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how much of the market cap is held at a profit versus a loss across PnL bands. Answers questions of the form: is the majority of market cap currently held in coins that are above or below their acquisition cost?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MarketcapUsdByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/marketcap_usd_by_pnl":{"get":{"summary":"Market Cap by PnL","description":"**Definition.** Market Capitalization (Market Cap) segmented by unrealized profit and loss bands defined around Fibonacci retracement levels. Market Cap is the total market value of an asset, computed as current market price multiplied by total supply. The breakdown distributes that valuation across in-profit and in-loss bands to show how much of the market sits above or below its acquisition cost and at what depth.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level. This contrasts with the UTXO-based approach available for some chains, and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how much of the market cap is held at a profit versus a loss across PnL bands. Answers questions of the form: is the majority of market cap currently held in coins that are above or below their acquisition cost?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MarketcapUsdByPnl?a=BTC)\n","operationId":"breakdowns.MarketcapUsdByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Market Cap by Wallet Size

> \*\*Definition.\*\* Market Capitalization (Market Cap) segmented by wallet-size cohort, from large holders (whales) down to small retail balances. Market Cap is the total market value of an asset, computed as current market price multiplied by total supply. The breakdown attributes that valuation across investor classes, showing what share of total market value each cohort carries.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\n\*\*Interpretation.\*\* Surfaces how market value is distributed across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) holding a greater proportion of market value than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MarketcapUsdByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/marketcap_usd_by_wallet_size":{"get":{"summary":"Market Cap by Wallet Size","description":"**Definition.** Market Capitalization (Market Cap) segmented by wallet-size cohort, from large holders (whales) down to small retail balances. Market Cap is the total market value of an asset, computed as current market price multiplied by total supply. The breakdown attributes that valuation across investor classes, showing what share of total market value each cohort carries.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\\n**Interpretation.** Surfaces how market value is distributed across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) holding a greater proportion of market value than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MarketcapUsdByWalletSize?a=BTC)\n","operationId":"breakdowns.MarketcapUsdByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## MVRV by Age

> \*\*Definition.\*\* Market Value to Realized Value (MVRV) ratio segmented by holding-period age cohort. MVRV compares market capitalization (current market value) to realized capitalization (the value of coins when they last moved). The by-age decomposition computes a separate ratio per cohort, exposing the aggregate unrealized profit or loss carried by short-term versus long-term holders.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\n\*\*Interpretation.\*\* A cohort reading above 1 places that age band in aggregate unrealized profit, a reading below 1 places it in aggregate unrealized loss. Surfaces how unrealized valuation differs between long-held and recently-moved coins. Answers questions of the form: are older coins being held at a higher relative valuation than coins that recently changed hands?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MvrvByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/mvrv_by_age":{"get":{"summary":"MVRV by Age","description":"**Definition.** Market Value to Realized Value (MVRV) ratio segmented by holding-period age cohort. MVRV compares market capitalization (current market value) to realized capitalization (the value of coins when they last moved). The by-age decomposition computes a separate ratio per cohort, exposing the aggregate unrealized profit or loss carried by short-term versus long-term holders.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\\n**Interpretation.** A cohort reading above 1 places that age band in aggregate unrealized profit, a reading below 1 places it in aggregate unrealized loss. Surfaces how unrealized valuation differs between long-held and recently-moved coins. Answers questions of the form: are older coins being held at a higher relative valuation than coins that recently changed hands?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MvrvByAge?a=BTC)\n","operationId":"breakdowns.MvrvByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## MVRV by PnL

> \*\*Definition.\*\* Market Value to Realized Value (MVRV) ratio segmented by unrealized profit and loss bands defined around Fibonacci retracement levels. MVRV compares market capitalization (current market value) to realized capitalization (the value of coins when they last moved). The breakdown distributes that ratio across PnL thresholds to show how much of the market sits above or below each band relative to a fair-value anchor.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the UTXO-based approach available for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces the share of supply held above versus below cost basis at each PnL band — a direct view of where the market sits relative to a fair-value anchor. Answers questions of the form: are most coins currently held at a profit or a loss relative to their acquisition cost? A band reading above 1 sits in aggregate unrealized profit, a reading below 1 sits in aggregate unrealized loss.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MvrvByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/mvrv_by_pnl":{"get":{"summary":"MVRV by PnL","description":"**Definition.** Market Value to Realized Value (MVRV) ratio segmented by unrealized profit and loss bands defined around Fibonacci retracement levels. MVRV compares market capitalization (current market value) to realized capitalization (the value of coins when they last moved). The breakdown distributes that ratio across PnL thresholds to show how much of the market sits above or below each band relative to a fair-value anchor.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to facilitate comparability across digital assets and to ensure consistent analysis across various blockchain architectures. This contrasts with the UTXO-based approach available for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces the share of supply held above versus below cost basis at each PnL band — a direct view of where the market sits relative to a fair-value anchor. Answers questions of the form: are most coins currently held at a profit or a loss relative to their acquisition cost? A band reading above 1 sits in aggregate unrealized profit, a reading below 1 sits in aggregate unrealized loss.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MvrvByPnl?a=BTC)\n","operationId":"breakdowns.MvrvByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## MVRV by Wallet Size

> \*\*Definition.\*\* Market Value to Realized Value (MVRV) ratio segmented by wallet-size cohort, from large holders down to small retail balances. MVRV compares market capitalization (current market value) to realized capitalization (the value of coins when they last moved). The breakdown decomposes the unrealized PnL stance across investor classes.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\n\*\*Interpretation.\*\* Surfaces how unrealized valuation differs across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) holding their coins at a higher relative valuation than smaller wallets (retail investors)? A cohort reading above 1 places that wallet-size band in aggregate unrealized profit, a reading below 1 places it in aggregate unrealized loss.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MvrvByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/mvrv_by_wallet_size":{"get":{"summary":"MVRV by Wallet Size","description":"**Definition.** Market Value to Realized Value (MVRV) ratio segmented by wallet-size cohort, from large holders down to small retail balances. MVRV compares market capitalization (current market value) to realized capitalization (the value of coins when they last moved). The breakdown decomposes the unrealized PnL stance across investor classes.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\\n**Interpretation.** Surfaces how unrealized valuation differs across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) holding their coins at a higher relative valuation than smaller wallets (retail investors)? A cohort reading above 1 places that wallet-size band in aggregate unrealized profit, a reading below 1 places it in aggregate unrealized loss.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MvrvByWalletSize?a=BTC)\n","operationId":"breakdowns.MvrvByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## NUPL by Age

> \*\*Definition.\*\* Net Unrealized Profit/Loss (NUPL) segmented by holding-period age cohort. NUPL is the difference between Relative Unrealized Profit and Relative Unrealized Loss. The by-age decomposition computes the difference per cohort, showing the aggregate PnL state across short-term and long-term holders.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\n\*\*Interpretation.\*\* A cohort reading above 0 places that age band in net unrealized profit, a reading below 0 places it in net unrealized loss.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.NuplByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/nupl_by_age":{"get":{"summary":"NUPL by Age","description":"**Definition.** Net Unrealized Profit/Loss (NUPL) segmented by holding-period age cohort. NUPL is the difference between Relative Unrealized Profit and Relative Unrealized Loss. The by-age decomposition computes the difference per cohort, showing the aggregate PnL state across short-term and long-term holders.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\\n**Interpretation.** A cohort reading above 0 places that age band in net unrealized profit, a reading below 0 places it in net unrealized loss.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.NuplByAge?a=USDT)\n","operationId":"breakdowns.NuplByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Cap by Age

> \*\*Definition.\*\* Realized Cap by Age decomposes Realized Capitalization, the total value of a digital asset valued at the price each unit last moved (equivalent to the cumulative acquisition cost of all circulating coins), into holding-period age cohorts. Each cohort carries the cost-basis stock attributable to coins of that vintage, spanning from hot supply (coins that recently moved) to cold supply (older, dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to facilitate comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach available for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Per-cohort share of total Realized Cap is the dominant read. Surfaces the distribution of network wealth (cost basis) across hot-to-cold age cohorts. Answers questions of the form: is the majority of the acquisition cost concentrated in older or newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MarketcapRealizedUsdByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/marketcap_realized_usd_by_age":{"get":{"summary":"Realized Cap by Age","description":"**Definition.** Realized Cap by Age decomposes Realized Capitalization, the total value of a digital asset valued at the price each unit last moved (equivalent to the cumulative acquisition cost of all circulating coins), into holding-period age cohorts. Each cohort carries the cost-basis stock attributable to coins of that vintage, spanning from hot supply (coins that recently moved) to cold supply (older, dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to facilitate comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach available for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Per-cohort share of total Realized Cap is the dominant read. Surfaces the distribution of network wealth (cost basis) across hot-to-cold age cohorts. Answers questions of the form: is the majority of the acquisition cost concentrated in older or newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MarketcapRealizedUsdByAge?a=BTC)\n","operationId":"breakdowns.MarketcapRealizedUsdByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Cap by PnL

> \*\*Definition.\*\* Realized Cap by Profit and Loss decomposes Realized Capitalization, the total acquisition cost of all coins in circulation based on the price at the time each unit last moved, by the unrealized profit or loss of each coin relative to spot. Coins are bucketed using Fibonacci retracement levels to give a depth-banded view of how much of Realized Cap is held above versus below current price.\n\n\*\*Technical.\*\* The breakdown uses an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Surfaces how much of the realized cap is held at a profit versus a loss across PnL bands. Answers questions of the form: is the majority of the realized cap currently held in coins that are above or below their acquisition cost?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MarketcapRealizedUsdByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/marketcap_realized_usd_by_pnl":{"get":{"summary":"Realized Cap by PnL","description":"**Definition.** Realized Cap by Profit and Loss decomposes Realized Capitalization, the total acquisition cost of all coins in circulation based on the price at the time each unit last moved, by the unrealized profit or loss of each coin relative to spot. Coins are bucketed using Fibonacci retracement levels to give a depth-banded view of how much of Realized Cap is held above versus below current price.\\n\\n**Technical.** The breakdown uses an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Surfaces how much of the realized cap is held at a profit versus a loss across PnL bands. Answers questions of the form: is the majority of the realized cap currently held in coins that are above or below their acquisition cost?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MarketcapRealizedUsdByPnl?a=BTC)\n","operationId":"breakdowns.MarketcapRealizedUsdByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Cap by Wallet Size

> \*\*Definition.\*\* Realized Capitalization (Realized Cap) segmented by wallet-size cohort, from large holders (whales) down to small retail balances. Realized Cap is the total acquisition cost of all coins in circulation, valued at the price each unit last moved. The breakdown attributes that cost basis across investor classes, showing what share of network wealth each cohort carries.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\n\*\*Interpretation.\*\* Surfaces how cost-basis stock is distributed across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) holding a greater proportion of the acquisition cost than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.MarketcapRealizedUsdByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/marketcap_realized_usd_by_wallet_size":{"get":{"summary":"Realized Cap by Wallet Size","description":"**Definition.** Realized Capitalization (Realized Cap) segmented by wallet-size cohort, from large holders (whales) down to small retail balances. Realized Cap is the total acquisition cost of all coins in circulation, valued at the price each unit last moved. The breakdown attributes that cost basis across investor classes, showing what share of network wealth each cohort carries.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\\n**Interpretation.** Surfaces how cost-basis stock is distributed across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) holding a greater proportion of the acquisition cost than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.MarketcapRealizedUsdByWalletSize?a=BTC)\n","operationId":"breakdowns.MarketcapRealizedUsdByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Loss by Age

> \*\*Definition.\*\* The total realized loss, segmented by holding-period age cohort. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized losses concentrate across hot-to-cold age cohorts. Answers questions of the form: is total realized loss greater for hot or cold supply?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedLossByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_loss_by_age":{"get":{"summary":"Realized Loss by Age","description":"**Definition.** The total realized loss, segmented by holding-period age cohort. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized losses concentrate across hot-to-cold age cohorts. Answers questions of the form: is total realized loss greater for hot or cold supply?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedLossByAge?a=BTC)\n","operationId":"breakdowns.RealizedLossByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Loss by Loss Margin

> \*\*Definition.\*\* The total realized loss, segmented by loss-margin band. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price. Bands are defined by Fibonacci retracement levels.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized losses concentrate across retracement levels. Answers questions of the form: are most realized losses occurring at specific retracement levels, indicating potential support or resistance zones?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedLossByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_loss_by_pnl":{"get":{"summary":"Realized Loss by Loss Margin","description":"**Definition.** The total realized loss, segmented by loss-margin band. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price. Bands are defined by Fibonacci retracement levels.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized losses concentrate across retracement levels. Answers questions of the form: are most realized losses occurring at specific retracement levels, indicating potential support or resistance zones?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedLossByPnl?a=BTC)\n","operationId":"breakdowns.RealizedLossByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Loss by LTH/STH

> \*\*Definition.\*\* The total realized loss, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price.\n\n\*\*Technical.\*\* Long-term and short-term holder supply is defined with respect to the entity\&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized losses split between long-term and short-term holders. Answers questions of the form: are long-term holders experiencing more losses than short-term holders?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedLossByLthSth?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_loss_by_lth_sth":{"get":{"summary":"Realized Loss by LTH/STH","description":"**Definition.** The total realized loss, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price.\\n\\n**Technical.** Long-term and short-term holder supply is defined with respect to the entity&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized losses split between long-term and short-term holders. Answers questions of the form: are long-term holders experiencing more losses than short-term holders?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedLossByLthSth?a=BTC)\n","operationId":"breakdowns.RealizedLossByLthSth","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Loss by Wallet Size

> \*\*Definition.\*\* The total realized loss, segmented by wallet-size cohort. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price. Cohorts span from whales to retail investors based on native-asset balance.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized losses concentrate across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) experiencing more losses than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedLossByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_loss_by_wallet_size":{"get":{"summary":"Realized Loss by Wallet Size","description":"**Definition.** The total realized loss, segmented by wallet-size cohort. Realized loss is the summed difference between acquisition price and sale price across all spent coins where the sale price was lower than the acquisition price. Cohorts span from whales to retail investors based on native-asset balance.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized losses concentrate across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) experiencing more losses than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedLossByWalletSize?a=BTC)\n","operationId":"breakdowns.RealizedLossByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Price by Age

> \*\*Definition.\*\* Realized Price segmented by holding-period age cohort, where Realized Price is the average acquisition cost of supply computed from the spot price at the time each unit last moved. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how average acquisition cost differs across hot-to-cold age cohorts. Answers questions of the form: is the average acquisition cost higher for older or newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.PriceRealizedUsdByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/price_realized_usd_by_age":{"get":{"summary":"Realized Price by Age","description":"**Definition.** Realized Price segmented by holding-period age cohort, where Realized Price is the average acquisition cost of supply computed from the spot price at the time each unit last moved. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how average acquisition cost differs across hot-to-cold age cohorts. Answers questions of the form: is the average acquisition cost higher for older or newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.PriceRealizedUsdByAge?a=BTC)\n","operationId":"breakdowns.PriceRealizedUsdByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Price by PnL

> \*\*Definition.\*\* Realized Price segmented by unrealized profit and loss band, where Realized Price is the average acquisition cost of supply computed from the spot price at the time each unit last moved. Bands are defined by Fibonacci retracement levels relative to the current market price.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Bands with a realized price above the current spot price hold supply in unrealized loss, bands with a realized price below spot hold supply in unrealized profit. Surfaces whether the average acquisition cost sits above or below the current market price across PnL bands. Answers questions of the form: is the average acquisition cost of coins currently higher or lower than the market price, indicating potential unrealized profit or loss?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.PriceRealizedUsdByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/price_realized_usd_by_pnl":{"get":{"summary":"Realized Price by PnL","description":"**Definition.** Realized Price segmented by unrealized profit and loss band, where Realized Price is the average acquisition cost of supply computed from the spot price at the time each unit last moved. Bands are defined by Fibonacci retracement levels relative to the current market price.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Bands with a realized price above the current spot price hold supply in unrealized loss, bands with a realized price below spot hold supply in unrealized profit. Surfaces whether the average acquisition cost sits above or below the current market price across PnL bands. Answers questions of the form: is the average acquisition cost of coins currently higher or lower than the market price, indicating potential unrealized profit or loss?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.PriceRealizedUsdByPnl?a=BTC)\n","operationId":"breakdowns.PriceRealizedUsdByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Price by Wallet Size

> \*\*Definition.\*\* Realized Price segmented by wallet-size cohort, where Realized Price is the average acquisition cost of supply computed from the spot price at the time each unit last moved. Cohorts span from whales to retail investors based on native-asset balance.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how average acquisition cost differs across investor classes, from whales down to retail. Answers questions of the form: is the average acquisition cost higher for larger wallets (whales) than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.PriceRealizedUsdByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/price_realized_usd_by_wallet_size":{"get":{"summary":"Realized Price by Wallet Size","description":"**Definition.** Realized Price segmented by wallet-size cohort, where Realized Price is the average acquisition cost of supply computed from the spot price at the time each unit last moved. Cohorts span from whales to retail investors based on native-asset balance.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how average acquisition cost differs across investor classes, from whales down to retail. Answers questions of the form: is the average acquisition cost higher for larger wallets (whales) than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.PriceRealizedUsdByWalletSize?a=BTC)\n","operationId":"breakdowns.PriceRealizedUsdByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Profit by Age

> \*\*Definition.\*\* The total realized profit, segmented by holding-period age cohort. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized profits concentrate across hot-to-cold age cohorts. Answers questions of the form: is total realized profit greater for older or newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedProfitByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_profit_by_age":{"get":{"summary":"Realized Profit by Age","description":"**Definition.** The total realized profit, segmented by holding-period age cohort. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized profits concentrate across hot-to-cold age cohorts. Answers questions of the form: is total realized profit greater for older or newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedProfitByAge?a=BTC)\n","operationId":"breakdowns.RealizedProfitByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Profit by LTH/STH

> \*\*Definition.\*\* The total realized profit, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price.\n\n\*\*Technical.\*\* Long-term and short-term holder supply is defined with respect to the entity\&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized profit-taking splits between long-term and short-term holders. Answers questions of the form: are long-term holders realizing more profits than short-term holders?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedProfitByLthSth?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_profit_by_lth_sth":{"get":{"summary":"Realized Profit by LTH/STH","description":"**Definition.** The total realized profit, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price.\\n\\n**Technical.** Long-term and short-term holder supply is defined with respect to the entity&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized profit-taking splits between long-term and short-term holders. Answers questions of the form: are long-term holders realizing more profits than short-term holders?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedProfitByLthSth?a=BTC)\n","operationId":"breakdowns.RealizedProfitByLthSth","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Profit by Profit Margin

> \*\*Definition.\*\* The total realized profit, segmented by profit-margin band. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized profits concentrate at different price levels. Answers questions of the form: are most realized profits occurring at specific levels, indicating potential zones of profit-taking?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedProfitByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_profit_by_pnl":{"get":{"summary":"Realized Profit by Profit Margin","description":"**Definition.** The total realized profit, segmented by profit-margin band. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized profits concentrate at different price levels. Answers questions of the form: are most realized profits occurring at specific levels, indicating potential zones of profit-taking?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedProfitByPnl?a=BTC)\n","operationId":"breakdowns.RealizedProfitByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Realized Profit by Wallet Size

> \*\*Definition.\*\* The total realized profit, segmented by wallet-size cohort. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price. Cohorts span from whales to retail investors based on native-asset balance.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how realized profits concentrate across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) realizing more profits than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.RealizedProfitByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/realized_profit_by_wallet_size":{"get":{"summary":"Realized Profit by Wallet Size","description":"**Definition.** The total realized profit, segmented by wallet-size cohort. Realized profit is the summed difference between sale price and acquisition price across all spent coins where the sale price was higher than the acquisition price. Cohorts span from whales to retail investors based on native-asset balance.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how realized profits concentrate across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) realizing more profits than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.RealizedProfitByWalletSize?a=BTC)\n","operationId":"breakdowns.RealizedProfitByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Relative Supply by PnL

> \*\*Definition.\*\* Relative version of \[Supply by Profit and Loss]\(<https://studio.glassnode.com/metrics?a\\&#x3D;BTC\\&m\\&#x3D;breakdowns.SupplyByPnl>): the share of total supply held in each unrealized profit-and-loss band, expressed as a percentage of supply rather than in native units. Bands are defined around Fibonacci retracement levels.\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* A high share of supply in profit means most of the float was acquired below the current price, a high share in loss means most of the float is held above the current price. Surfaces the share of total supply held at a profit versus a loss, exposing aggregate market sentiment and potential support / resistance levels. Answers questions of the form: is the majority of supply currently held at a profit or a loss relative to its acquisition cost?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyByPnlRelative?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_by_pnl_relative":{"get":{"summary":"Relative Supply by PnL","description":"**Definition.** Relative version of [Supply by Profit and Loss](https://studio.glassnode.com/metrics?a&#x3D;BTC&m&#x3D;breakdowns.SupplyByPnl): the share of total supply held in each unrealized profit-and-loss band, expressed as a percentage of supply rather than in native units. Bands are defined around Fibonacci retracement levels.\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** A high share of supply in profit means most of the float was acquired below the current price, a high share in loss means most of the float is held above the current price. Surfaces the share of total supply held at a profit versus a loss, exposing aggregate market sentiment and potential support / resistance levels. Answers questions of the form: is the majority of supply currently held at a profit or a loss relative to its acquisition cost?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyByPnlRelative?a=BTC)\n","operationId":"breakdowns.SupplyByPnlRelative","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## SOPR by Age

> \*\*Definition.\*\* Spent Output Profit Ratio (SOPR) by Age decomposes SOPR, the ratio of sale price to acquisition price across coins spent on a given day, into holding-period age cohorts. Each cohort reports the per-coin profit or loss realized by spent supply of that vintage, spanning from hot supply (freshly acquired coins) to cold supply (longer-held coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to facilitate comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach available for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Within each cohort, readings above 1 mean that vintage\&#x27;s spent coins were sold at a net profit. Readings below 1 mean they were sold at a net loss. Surfaces how profit-making versus loss-making sales distribute across hot-to-cold age cohorts. Answers questions of the form: are older coins being sold at a profit more frequently than newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SoprByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/sopr_by_age":{"get":{"summary":"SOPR by Age","description":"**Definition.** Spent Output Profit Ratio (SOPR) by Age decomposes SOPR, the ratio of sale price to acquisition price across coins spent on a given day, into holding-period age cohorts. Each cohort reports the per-coin profit or loss realized by spent supply of that vintage, spanning from hot supply (freshly acquired coins) to cold supply (longer-held coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to facilitate comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach available for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Within each cohort, readings above 1 mean that vintage&#x27;s spent coins were sold at a net profit. Readings below 1 mean they were sold at a net loss. Surfaces how profit-making versus loss-making sales distribute across hot-to-cold age cohorts. Answers questions of the form: are older coins being sold at a profit more frequently than newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SoprByAge?a=BTC)\n","operationId":"breakdowns.SoprByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## SOPR by LTH/STH

> \*\*Definition.\*\* Spent Output Profit Ratio (SOPR) computed separately for long-term holder (LTH) and short-term holder (STH) cohorts, where SOPR is the ratio of sale price to acquisition price across coins spent on a given day.\n\n\*\*Technical.\*\* Long-term and short-term holder supply is defined with respect to the entity\&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Cohort readings above 1 mean the average coin spent by that cohort was sold at a profit, readings below 1 mean it was sold at a loss. Surfaces how the profitability of sales splits between long-term and short-term holders. Answers questions of the form: are long-term holders selling their coins at a profit more frequently than short-term holders?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SoprByLthSth?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/sopr_by_lth_sth":{"get":{"summary":"SOPR by LTH/STH","description":"**Definition.** Spent Output Profit Ratio (SOPR) computed separately for long-term holder (LTH) and short-term holder (STH) cohorts, where SOPR is the ratio of sale price to acquisition price across coins spent on a given day.\\n\\n**Technical.** Long-term and short-term holder supply is defined with respect to the entity&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Cohort readings above 1 mean the average coin spent by that cohort was sold at a profit, readings below 1 mean it was sold at a loss. Surfaces how the profitability of sales splits between long-term and short-term holders. Answers questions of the form: are long-term holders selling their coins at a profit more frequently than short-term holders?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SoprByLthSth?a=BTC)\n","operationId":"breakdowns.SoprByLthSth","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## SOPR by PnL

> \*\*Definition.\*\* Spent Output Profit Ratio (SOPR) segmented by realized profit and loss band, where SOPR is the ratio of sale price to acquisition price across coins spent on a given day. Bands are defined by Fibonacci retracement levels.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Bands with a SOPR above 1 captured profitable sales, bands below 1 captured loss-making sales. Surfaces where realized profits and losses concentrate across retracement levels. Answers questions of the form: are most sales occurring at a profit or a loss relative to acquisition cost, and at what levels are those profits or losses concentrated?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SoprByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/sopr_by_pnl":{"get":{"summary":"SOPR by PnL","description":"**Definition.** Spent Output Profit Ratio (SOPR) segmented by realized profit and loss band, where SOPR is the ratio of sale price to acquisition price across coins spent on a given day. Bands are defined by Fibonacci retracement levels.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Bands with a SOPR above 1 captured profitable sales, bands below 1 captured loss-making sales. Surfaces where realized profits and losses concentrate across retracement levels. Answers questions of the form: are most sales occurring at a profit or a loss relative to acquisition cost, and at what levels are those profits or losses concentrated?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SoprByPnl?a=BTC)\n","operationId":"breakdowns.SoprByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## SOPR by Wallet Size

> \*\*Definition.\*\* Spent Output Profit Ratio (SOPR) computed separately for each wallet-size cohort, where SOPR is the ratio of sale price to acquisition price across coins spent on a given day. Cohorts span from whales to retail investors based on native-asset balance.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Cohort readings above 1 mean the average coin spent by that cohort was sold at a profit, readings below 1 mean it was sold at a loss. Surfaces how the profitability of sales differs across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins at a profit more frequently than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SoprByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/sopr_by_wallet_size":{"get":{"summary":"SOPR by Wallet Size","description":"**Definition.** Spent Output Profit Ratio (SOPR) computed separately for each wallet-size cohort, where SOPR is the ratio of sale price to acquisition price across coins spent on a given day. Cohorts span from whales to retail investors based on native-asset balance.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Cohort readings above 1 mean the average coin spent by that cohort was sold at a profit, readings below 1 mean it was sold at a loss. Surfaces how the profitability of sales differs across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins at a profit more frequently than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SoprByWalletSize?a=BTC)\n","operationId":"breakdowns.SoprByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume by Age

> \*\*Definition.\*\* The total volume of coins spent, segmented by holding-period age cohort. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how total sale volume concentrates across hot-to-cold age cohorts, identifying periods of increased selling among different vintages. Answers questions of the form: are older coins being sold more frequently than newer ones?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_sum_by_age":{"get":{"summary":"Spent Volume by Age","description":"**Definition.** The total volume of coins spent, segmented by holding-period age cohort. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how total sale volume concentrates across hot-to-cold age cohorts, identifying periods of increased selling among different vintages. Answers questions of the form: are older coins being sold more frequently than newer ones?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByAge?a=BTC)\n","operationId":"breakdowns.SpentVolumeSumByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume by LTH/STH

> \*\*Definition.\*\* The total volume of digital assets spent, segmented into Long-Term Holder (LTH) and Short-Term Holder (STH) cohorts.\n\n\*\*Technical.\*\* LTH/STH supply is defined with respect to each entity\&#x27;s average purchasing date, with cohort weights given by a logistic function centered at 155 days and a transition width of 10 days. Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Surfaces how total sale volume splits between long-term and short-term holders. Answers questions of the form: are long-term holders selling their coins more frequently than short-term holders?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByLthSth?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_sum_by_lth_sth":{"get":{"summary":"Spent Volume by LTH/STH","description":"**Definition.** The total volume of digital assets spent, segmented into Long-Term Holder (LTH) and Short-Term Holder (STH) cohorts.\\n\\n**Technical.** LTH/STH supply is defined with respect to each entity&#x27;s average purchasing date, with cohort weights given by a logistic function centered at 155 days and a transition width of 10 days. Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Surfaces how total sale volume splits between long-term and short-term holders. Answers questions of the form: are long-term holders selling their coins more frequently than short-term holders?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByLthSth?a=BTC)\n","operationId":"breakdowns.SpentVolumeSumByLthSth","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume by PnL

> \*\*Definition.\*\* The total volume of digital assets spent, categorized by realized profit and loss band using Fibonacci retracement levels.\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Surfaces how total sale volume concentrates across profit and loss levels. Answers questions of the form: are most coins being sold at specific profit or loss levels, indicating potential zones of market activity?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_sum_by_pnl":{"get":{"summary":"Spent Volume by PnL","description":"**Definition.** The total volume of digital assets spent, categorized by realized profit and loss band using Fibonacci retracement levels.\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Surfaces how total sale volume concentrates across profit and loss levels. Answers questions of the form: are most coins being sold at specific profit or loss levels, indicating potential zones of market activity?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByPnl?a=BTC)\n","operationId":"breakdowns.SpentVolumeSumByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume by Wallet Size

> \*\*Definition.\*\* The total volume of digital assets spent, segmented by holder wallet-size cohort, from whale-scale balances down to retail.\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Surfaces how total sale volume concentrates across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins more frequently than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_sum_by_wallet_size":{"get":{"summary":"Spent Volume by Wallet Size","description":"**Definition.** The total volume of digital assets spent, segmented by holder wallet-size cohort, from whale-scale balances down to retail.\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Surfaces how total sale volume concentrates across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins more frequently than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeSumByWalletSize?a=BTC)\n","operationId":"breakdowns.SpentVolumeSumByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume in Loss by Age

> \*\*Definition.\*\* The total volume of coins sold at a loss, segmented by holding-period age cohort. A sale is in loss when the sale price was lower than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how loss-making sale volume concentrates across hot-to-cold age cohorts. Answers questions of the form: is the volume of coins sold at a loss greater for older or newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeLossSumByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_loss_sum_by_age":{"get":{"summary":"Spent Volume in Loss by Age","description":"**Definition.** The total volume of coins sold at a loss, segmented by holding-period age cohort. A sale is in loss when the sale price was lower than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how loss-making sale volume concentrates across hot-to-cold age cohorts. Answers questions of the form: is the volume of coins sold at a loss greater for older or newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeLossSumByAge?a=BTC)\n","operationId":"breakdowns.SpentVolumeLossSumByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume in Loss by LTH/STH

> \*\*Definition.\*\* The total volume of coins sold at a loss, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. A sale is in loss when the sale price was lower than the acquisition price.\n\n\*\*Technical.\*\* Long-term and short-term holder supply is defined with respect to the entity\&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how loss-making sale volume splits between long-term and short-term holders. Answers questions of the form: are long-term holders selling their coins at a loss more frequently than short-term holders?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeLossSumByLthSth?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_loss_sum_by_lth_sth":{"get":{"summary":"Spent Volume in Loss by LTH/STH","description":"**Definition.** The total volume of coins sold at a loss, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. A sale is in loss when the sale price was lower than the acquisition price.\\n\\n**Technical.** Long-term and short-term holder supply is defined with respect to the entity&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how loss-making sale volume splits between long-term and short-term holders. Answers questions of the form: are long-term holders selling their coins at a loss more frequently than short-term holders?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeLossSumByLthSth?a=BTC)\n","operationId":"breakdowns.SpentVolumeLossSumByLthSth","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume in Loss by Wallet Size

> \*\*Definition.\*\* The total volume of coins sold at a loss, segmented by wallet-size cohort. A sale is in loss when the sale price was lower than the acquisition price. Cohorts span from whales to retail investors based on native-asset balance.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how loss-making sale volume concentrates across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins at a loss more frequently than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeLossSumByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_loss_sum_by_wallet_size":{"get":{"summary":"Spent Volume in Loss by Wallet Size","description":"**Definition.** The total volume of coins sold at a loss, segmented by wallet-size cohort. A sale is in loss when the sale price was lower than the acquisition price. Cohorts span from whales to retail investors based on native-asset balance.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how loss-making sale volume concentrates across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins at a loss more frequently than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeLossSumByWalletSize?a=BTC)\n","operationId":"breakdowns.SpentVolumeLossSumByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume in Profit by Age

> \*\*Definition.\*\* The total volume of coins sold at a profit, segmented by holding-period age cohort. A sale is in profit when the sale price was higher than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how profit-making sale volume concentrates across hot-to-cold age cohorts. Answers questions of the form: are older coins being sold at a profit more frequently than newer coins?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeProfitSumByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_profit_sum_by_age":{"get":{"summary":"Spent Volume in Profit by Age","description":"**Definition.** The total volume of coins sold at a profit, segmented by holding-period age cohort. A sale is in profit when the sale price was higher than the acquisition price. Cohorts span from hot supply (most recently acquired) to cold supply (long-dormant coins).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how profit-making sale volume concentrates across hot-to-cold age cohorts. Answers questions of the form: are older coins being sold at a profit more frequently than newer coins?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeProfitSumByAge?a=BTC)\n","operationId":"breakdowns.SpentVolumeProfitSumByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume in Profit by LTH/STH

> \*\*Definition.\*\* The total volume of coins sold at a profit, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. A sale is in profit when the sale price was higher than the acquisition price.\n\n\*\*Technical.\*\* Long-term and short-term holder supply is defined with respect to the entity\&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how profit-making sale volume splits between long-term and short-term holders. Answers questions of the form: are long-term holders realizing profits more frequently than short-term holders?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeProfitSumByLthSth?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_profit_sum_by_lth_sth":{"get":{"summary":"Spent Volume in Profit by LTH/STH","description":"**Definition.** The total volume of coins sold at a profit, segmented into long-term holder (LTH) and short-term holder (STH) cohorts. A sale is in profit when the sale price was higher than the acquisition price.\\n\\n**Technical.** Long-term and short-term holder supply is defined with respect to the entity&#x27;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. Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level to keep results comparable across digital assets and consistent across different blockchain architectures. This contrasts with the UTXO-based approach available for some chains (e.g. Bitcoin), and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how profit-making sale volume splits between long-term and short-term holders. Answers questions of the form: are long-term holders realizing profits more frequently than short-term holders?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeProfitSumByLthSth?a=BTC)\n","operationId":"breakdowns.SpentVolumeProfitSumByLthSth","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Spent Volume in Profit by Wallet Size

> \*\*Definition.\*\* The total volume of  spent at a profit (sale price above acquisition price), segmented by wallet-size cohort from large holders down to small retail balances. The breakdown shows how realized-profit volume is distributed across investor classes.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level. This contrasts with the UTXO-based approach available for some chains, and cross-method comparisons may show small deviations.\n\n\*\*Interpretation.\*\* Surfaces how profit-making sale volume concentrates across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins at a profit more frequently than smaller wallets (retail investors)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SpentVolumeProfitSumByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/spent_volume_profit_sum_by_wallet_size":{"get":{"summary":"Spent Volume in Profit by Wallet Size","description":"**Definition.** The total volume of  spent at a profit (sale price above acquisition price), segmented by wallet-size cohort from large holders down to small retail balances. The breakdown shows how realized-profit volume is distributed across investor classes.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level. This contrasts with the UTXO-based approach available for some chains, and cross-method comparisons may show small deviations.\\n\\n**Interpretation.** Surfaces how profit-making sale volume concentrates across investor classes, from whales down to retail. Answers questions of the form: are larger wallets (whales) selling their coins at a profit more frequently than smaller wallets (retail investors)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SpentVolumeProfitSumByWalletSize?a=BTC)\n","operationId":"breakdowns.SpentVolumeProfitSumByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Supply by Age

> \*\*Definition.\*\* The total circulating supply of a digital asset, segmented into age cohorts that span from hot supply (recently moved coins) through cold supply (older, dormant coins).\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Thickening older cohorts reads as coin maturation and HODLer dominance, while thickening younger cohorts reads as new-buyer activity or distribution from older holders into young hands. Surfaces the age distribution of total supply, a proxy for market maturity and stability. Answers questions of the form: is the majority of supply held in older coins (a mature market) or in newer coins (a growing market)?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyByAge?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_by_age":{"get":{"summary":"Supply by Age","description":"**Definition.** The total circulating supply of a digital asset, segmented into age cohorts that span from hot supply (recently moved coins) through cold supply (older, dormant coins).\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Thickening older cohorts reads as coin maturation and HODLer dominance, while thickening younger cohorts reads as new-buyer activity or distribution from older holders into young hands. Surfaces the age distribution of total supply, a proxy for market maturity and stability. Answers questions of the form: is the majority of supply held in older coins (a mature market) or in newer coins (a growing market)?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyByAge?a=BTC)\n","operationId":"breakdowns.SupplyByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Supply by Investor Behavior

> \*\*Definition.\*\* The cumulative token supply held by each of five behavior-based investor cohorts: Conviction Buyers (buying into falling prices and lowering their cost basis), Momentum Buyers (buying into uptrends and raising their cost basis), First Buy (first-time entrants), Loss Sellers (exiting at a loss), and Profit Takers (locking in gains).\n\n\*\*Technical.\*\* Exchanges and smart contracts are excluded so the series reflects investor behavior only. For Bitcoin the analysis is performed at the entity level rather than the address level, grouping addresses that belong to the same user.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyByInvestorBehavior?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_by_investor_behavior":{"get":{"summary":"Supply by Investor Behavior","description":"**Definition.** The cumulative token supply held by each of five behavior-based investor cohorts: Conviction Buyers (buying into falling prices and lowering their cost basis), Momentum Buyers (buying into uptrends and raising their cost basis), First Buy (first-time entrants), Loss Sellers (exiting at a loss), and Profit Takers (locking in gains).\\n\\n**Technical.** Exchanges and smart contracts are excluded so the series reflects investor behavior only. For Bitcoin the analysis is performed at the entity level rather than the address level, grouping addresses that belong to the same user.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyByInvestorBehavior?a=BTC)\n","operationId":"breakdowns.SupplyByInvestorBehavior","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Supply by PnL

> \*\*Definition.\*\* The total supply of  segmented by unrealized profit and loss bands defined around Fibonacci retracement levels.\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\n\*\*Interpretation.\*\* Surfaces how much of total supply is held at a profit versus a loss, exposing aggregate market sentiment and potential support / resistance levels. Answers questions of the form: is the majority of supply currently held at a profit or a loss relative to its acquisition cost?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyByPnl?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_by_pnl":{"get":{"summary":"Supply by PnL","description":"**Definition.** The total supply of  segmented by unrealized profit and loss bands defined around Fibonacci retracement levels.\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\\n**Interpretation.** Surfaces how much of total supply is held at a profit versus a loss, exposing aggregate market sentiment and potential support / resistance levels. Answers questions of the form: is the majority of supply currently held at a profit or a loss relative to its acquisition cost?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyByPnl?a=BTC)\n","operationId":"breakdowns.SupplyByPnl","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Supply by Wallet Size

> \*\*Definition.\*\* The total circulating supply of a digital asset, segmented by holder wallet-size cohort, from whale-scale balances down to retail.\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\n\*\*Interpretation.\*\* Surfaces how total supply is distributed across investor classes, a proxy for concentration versus diversity. Answers questions of the form: is the majority of supply held in larger wallets (whales) — a concentrated market — or evenly distributed across smaller wallets (retail investors) — a diverse market?\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyByWalletSize?a=BTC>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_by_wallet_size":{"get":{"summary":"Supply by Wallet Size","description":"**Definition.** The total circulating supply of a digital asset, segmented by holder wallet-size cohort, from whale-scale balances down to retail.\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\\n**Interpretation.** Surfaces how total supply is distributed across investor classes, a proxy for concentration versus diversity. Answers questions of the form: is the majority of supply held in larger wallets (whales) — a concentrated market — or evenly distributed across smaller wallets (retail investors) — a diverse market?\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyByWalletSize?a=BTC)\n","operationId":"breakdowns.SupplyByWalletSize","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 10m, 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Supply in Loss by Age

> \*\*Definition.\*\* The supply of  currently in loss (current price below acquisition price), segmented by holding-period age cohort from hot (recently moved) to cold (long dormant).\n\n\*\*Technical.\*\* Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyLossByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_loss_by_age":{"get":{"summary":"Supply in Loss by Age","description":"**Definition.** The supply of  currently in loss (current price below acquisition price), segmented by holding-period age cohort from hot (recently moved) to cold (long dormant).\\n\\n**Technical.** Breakdowns use an address-based approach, analyzing transactions and holdings at the wallet-address level 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. Metrics for UTXO-based assets may show slight deviations if compared across these different computational methods.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyLossByAge?a=USDT)\n","operationId":"breakdowns.SupplyLossByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Supply in Profit by Age

> \*\*Definition.\*\* The supply of a digital asset currently in profit (current price above acquisition price), segmented into age cohorts that span from hot supply (recently moved coins) through cold supply (older, dormant coins).\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.SupplyProfitByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/supply_profit_by_age":{"get":{"summary":"Supply in Profit by Age","description":"**Definition.** The supply of a digital asset currently in profit (current price above acquisition price), segmented into age cohorts that span from hot supply (recently moved coins) through cold supply (older, dormant coins).\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.SupplyProfitByAge?a=USDT)\n","operationId":"breakdowns.SupplyProfitByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Unrealized Loss by Age

> \*\*Definition.\*\* The total unrealized loss in USD across coins whose acquisition price is above the current price, normalized by the total USD value of those coins, segmented into age cohorts from hot supply (recently moved coins) through cold supply (older, dormant coins).\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.UnrealizedLossByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/unrealized_loss_by_age":{"get":{"summary":"Unrealized Loss by Age","description":"**Definition.** The total unrealized loss in USD across coins whose acquisition price is above the current price, normalized by the total USD value of those coins, segmented into age cohorts from hot supply (recently moved coins) through cold supply (older, dormant coins).\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.UnrealizedLossByAge?a=USDT)\n","operationId":"breakdowns.UnrealizedLossByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Unrealized Profit by Age

> \*\*Definition.\*\* The total unrealized profit in USD across coins whose acquisition price is below the current price, normalized by the total USD value of those coins, segmented into age cohorts from hot supply (recently moved coins) through cold supply (older, dormant coins).\n\n\*\*Technical.\*\* Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\n\
> \
> \[View in Studio]\(<https://studio.glassnode.com/charts/breakdowns.UnrealizedProfitByAge?a=USDT>)<br>

```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - breakdowns","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/breakdowns/unrealized_profit_by_age":{"get":{"summary":"Unrealized Profit by Age","description":"**Definition.** The total unrealized profit in USD across coins whose acquisition price is below the current price, normalized by the total USD value of those coins, segmented into age cohorts from hot supply (recently moved coins) through cold supply (older, dormant coins).\\n\\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to support comparability across digital assets and consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, so metrics for UTXO-based assets may show slight deviations across the two computational methods.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/breakdowns.UnrealizedProfitByAge?a=USDT)\n","operationId":"breakdowns.UnrealizedProfitByAge","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.glassnode.com/basic-api/endpoints/breakdowns.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.