# Market ## Asia Month-over-Month Price Change > \*\*Definition.\*\* The 30-day change in the regional price series constructed from price movements that occur during Asian working hours, between 8am and 8pm China Standard Time (00:00-12:00 UTC).\n\n\*\*Technical.\*\* Regional prices are constructed in a two-step process. First, price movements are assigned to regions based on working hours in the US, Europe, and Asia. Regional prices are then derived by taking the cumulative sum of the price changes over time for each region.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/apac_30d_price_change":{"get":{"summary":"Asia Month-over-Month Price Change","description":"**Definition.** The 30-day change in the regional price series constructed from price movements that occur during Asian working hours, between 8am and 8pm China Standard Time (00:00-12:00 UTC).\\n\\n**Technical.** Regional prices are constructed in a two-step process. First, price movements are assigned to regions based on working hours in the US, Europe, and Asia. Regional prices are then derived by taking the cumulative sum of the price changes over time for each region.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.Apac30DPriceChange?a=BTC)\n","operationId":"market.Apac30DPriceChange","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"}}}}}}}}} ``` ## Beta to BTC (7D) > \*\*Definition.\*\* Beta to BTC (7D) is a 7-day rolling beta coefficient measuring an asset\'s sensitivity to Bitcoin\'s price movements, quantifying how much the asset tends to move relative to BTC.\n\n\*\*Interpretation.\*\* A beta of 1 means the asset moves in line with BTC, values greater than 1 indicate higher volatility relative to BTC (a beta of 1.5 means a 10 asset move), and values less than 1 indicate lower volatility. Negative beta indicates the asset tends to move opposite to BTC.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/beta_btc_7d":{"get":{"summary":"Beta to BTC (7D)","description":"**Definition.** Beta to BTC (7D) is a 7-day rolling beta coefficient measuring an asset's sensitivity to Bitcoin's price movements, quantifying how much the asset tends to move relative to BTC.\\n\\n**Interpretation.** A beta of 1 means the asset moves in line with BTC, values greater than 1 indicate higher volatility relative to BTC (a beta of 1.5 means a 10 asset move), and values less than 1 indicate lower volatility. Negative beta indicates the asset tends to move opposite to BTC.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.BetaBtc7D?a=ETH)\n","operationId":"market.BetaBtc7D","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"}}}}}}}}} ``` ## BTC Dominance > \*\*Definition.\*\* BTC Dominance (Bitcoin Dominance) is Bitcoin\'s market capitalization expressed as a percentage of the total market capitalization of all cryptocurrencies.\n\n\*\*Technical.\*\* Calculated by dividing Bitcoin\'s market cap by the total cryptocurrency market cap. The metric is updated daily at 10:15 UTC, providing the previous day\'s data point at this time.\n\n\*\*Interpretation.\*\* Higher readings indicate capital is concentrated in Bitcoin, while lower readings indicate capital is distributed across altcoins and stablecoins.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/btc_dominance":{"get":{"summary":"BTC Dominance","description":"**Definition.** BTC Dominance (Bitcoin Dominance) is Bitcoin's market capitalization expressed as a percentage of the total market capitalization of all cryptocurrencies.\\n\\n**Technical.** Calculated by dividing Bitcoin's market cap by the total cryptocurrency market cap. The metric is updated daily at 10:15 UTC, providing the previous day's data point at this time.\\n\\n**Interpretation.** Higher readings indicate capital is concentrated in Bitcoin, while lower readings indicate capital is distributed across altcoins and stablecoins.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.BtcDominance?a=BTC)\n","operationId":"market.BtcDominance","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"}}}}}}}}} ``` ## Correlation to BTC (7D) > \*\*Definition.\*\* Correlation to BTC (7D) is the 7-day rolling correlation coefficient between \'s returns and Bitcoin\'s returns, measuring how closely the asset\'s price movements track Bitcoin over a weekly period.\n\n\*\*Interpretation.\*\* Values range from -1 to 1: 1 indicates perfect positive correlation (the asset moves in the same direction as BTC), -1 indicates perfect negative correlation (opposite direction), and 0 indicates no correlation.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/correlation_btc_7d":{"get":{"summary":"Correlation to BTC (7D)","description":"**Definition.** Correlation to BTC (7D) is the 7-day rolling correlation coefficient between 's returns and Bitcoin's returns, measuring how closely the asset's price movements track Bitcoin over a weekly period.\\n\\n**Interpretation.** Values range from -1 to 1: 1 indicates perfect positive correlation (the asset moves in the same direction as BTC), -1 indicates perfect negative correlation (opposite direction), and 0 indicates no correlation.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.CorrelationBtc7D?a=ETH)\n","operationId":"market.CorrelationBtc7D","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"}}}}}}}}} ``` ## Delta Cap > \*\*Definition.\*\* Delta Cap is the difference between Realized Cap and Average Cap, where Average Cap is the life-to-date moving average of Market Cap. The per-coin form, Delta Price, is Realized Price minus the life-to-date moving average of price. It is designed to detect major market bottoms in Bitcoin cycles.\n\n\*\*Notes.\*\* Originally proposed by \[David Puell]\(). For more information, see his \[introductory article]\( > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/deltacap_usd":{"get":{"summary":"Delta Cap","description":"**Definition.** Delta Cap is the difference between Realized Cap and Average Cap, where Average Cap is the life-to-date moving average of Market Cap. The per-coin form, Delta Price, is Realized Price minus the life-to-date moving average of price. It is designed to detect major market bottoms in Bitcoin cycles.\\n\\n**Notes.** Originally proposed by [David Puell](https://twitter.com/kenoshaking). For more information, see his [introductory article](https://medium.com/@kenoshaking/bitcoin-delta-capitalization-1d51a7b256b4).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.DeltacapUsd?a=BTC)\n","operationId":"market.DeltacapUsd","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, 1month, 1w, 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"}}}}}}}}} ``` ## EU Month-over-Month Price Change > \*\*Definition.\*\* The 30-day change in the regional price set during EU working hours, defined as 8am to 8pm Central European Time (07:00-19:00 UTC, or 06:00-18:00 UTC during Central European Summer Time).\n\n\*\*Technical.\*\* Regional prices are constructed in a two-step process. First, price movements are assigned to regions based on working hours in the US, Europe, and Asia. Regional prices are then determined by calculating the cumulative sum of the price changes over time for each region.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/emea_30d_price_change":{"get":{"summary":"EU Month-over-Month Price Change","description":"**Definition.** The 30-day change in the regional price set during EU working hours, defined as 8am to 8pm Central European Time (07:00-19:00 UTC, or 06:00-18:00 UTC during Central European Summer Time).\\n\\n**Technical.** Regional prices are constructed in a two-step process. First, price movements are assigned to regions based on working hours in the US, Europe, and Asia. Regional prices are then determined by calculating the cumulative sum of the price changes over time for each region.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.Emea30DPriceChange?a=BTC)\n","operationId":"market.Emea30DPriceChange","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"}}}}}}}}} ``` ## HODL Cave > \*\*Definition.\*\* HODL Cave is the distribution of historical returns for investors who hold over various durations, visualizing both potential gains and risks across holding periods.\n\n\*\*Technical.\*\* The chart shows holding period in days on the x-axis and the distribution of historically observed returns at that duration on the y-axis as percentiles. For example, at a three-year holding duration, if the 80th percentile line shows a 5x return, 80% of all three-year holding periods achieved at least that return. The series is not static: new holding windows ending at the current timestamp contribute to all existing holding periods and modify the observed distribution.\n\n\*\*Interpretation.\*\* Surfaces the full spread of historical outcomes at each holding duration rather than a single average, exposing both long-term growth potential and short-term volatility. Answers questions of the form: what have been the typical returns for holding for three years?\n\n\*\*Notes.\*\* First introduced by \[Unchained Capital]\( > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/hodl_cave":{"get":{"summary":"HODL Cave","description":"**Definition.** HODL Cave is the distribution of historical returns for investors who hold over various durations, visualizing both potential gains and risks across holding periods.\\n\\n**Technical.** The chart shows holding period in days on the x-axis and the distribution of historically observed returns at that duration on the y-axis as percentiles. For example, at a three-year holding duration, if the 80th percentile line shows a 5x return, 80% of all three-year holding periods achieved at least that return. The series is not static: new holding windows ending at the current timestamp contribute to all existing holding periods and modify the observed distribution.\\n\\n**Interpretation.** Surfaces the full spread of historical outcomes at each holding duration rather than a single average, exposing both long-term growth potential and short-term volatility. Answers questions of the form: what have been the typical returns for holding for three years?\\n\\n**Notes.** First introduced by [Unchained Capital](https://unchained.com/features/hodl-cave).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.HodlCave?a=BTC)\n","operationId":"market.HodlCave","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":"i","in":"query","required":true,"description":"frequency interval - 1w","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"}}}}}}}}} ``` ## LTH-MVRV > \*\*Definition.\*\* Long Term Holder MVRV (LTH-MVRV) is the MVRV ratio computed using only UTXOs with a lifespan of at least 155 days, serving as an indicator of long-term investor behaviour.\n\n\*\*Notes.\*\* For more information, see our article on \[breaking up on-chain metrics for short- and long-term holders]\( > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/mvrv_more_155":{"get":{"summary":"LTH-MVRV","description":"**Definition.** Long Term Holder MVRV (LTH-MVRV) is the MVRV ratio computed using only UTXOs with a lifespan of at least 155 days, serving as an indicator of long-term investor behaviour.\\n\\n**Notes.** For more information, see our article on [breaking up on-chain metrics for short- and long-term holders](https://insights.glassnode.com/sth-lth-sopr-mvrv).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.MvrvMore155?a=BTC)\n","operationId":"market.MvrvMore155","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 > \*\*Definition.\*\* Market Cap (network value) is the product of the current supply and the current USD price of .\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/marketcap_usd":{"get":{"summary":"Market Cap","description":"**Definition.** Market Cap (network value) is the product of the current supply and the current USD price of .\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.MarketcapUsd?a=BTC)\n","operationId":"market.MarketcapUsd","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, 1month, 1w, 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"}}}}}}}}} ``` ## Median MVRV > \*\*Definition.\*\* Median MVRV is the ratio of the current market price to the median realized price, providing a view of market valuation against the midpoint acquisition cost of the supply.\n\n\*\*Technical.\*\* Unlike the standard MVRV, which compares market cap to realized cap, Median MVRV focuses on the midpoint acquisition price rather than the average. The metric indicates whether the traded price is above or below a typical acquisition price, highlighting potential undervaluation or overvaluation relative to the central price level at which the asset\'s supply was acquired.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/mvrv_median":{"get":{"summary":"Median MVRV","description":"**Definition.** Median MVRV is the ratio of the current market price to the median realized price, providing a view of market valuation against the midpoint acquisition cost of the supply.\\n\\n**Technical.** Unlike the standard MVRV, which compares market cap to realized cap, Median MVRV focuses on the midpoint acquisition price rather than the average. The metric indicates whether the traded price is above or below a typical acquisition price, highlighting potential undervaluation or overvaluation relative to the central price level at which the asset's supply was acquired.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.MvrvMedian?a=BTC)\n","operationId":"market.MvrvMedian","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"}}}}}}}}} ``` ## Median Realized Price > \*\*Definition.\*\* Median Realized Price is the median acquisition cost across the total supply of , reflecting the price point at which half of the supply was last moved.\n\n\*\*Technical.\*\* Unlike average Realized Price, which is Realized Cap divided by current supply, this median calculation provides a view of the central acquisition price by focusing on the midpoint rather than the mean.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/price_realized_median_usd":{"get":{"summary":"Median Realized Price","description":"**Definition.** Median Realized Price is the median acquisition cost across the total supply of , reflecting the price point at which half of the supply was last moved.\\n\\n**Technical.** Unlike average Realized Price, which is Realized Cap divided by current supply, this median calculation provides a view of the central acquisition price by focusing on the midpoint rather than the mean.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.PriceRealizedMedianUsd?a=BTC)\n","operationId":"market.PriceRealizedMedianUsd","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"}}}}}}}}} ``` ## MVRV Ratio > \*\*Definition.\*\* Market Value to Realized Value (MVRV) is the ratio between market cap and realized cap.\n\n\*\*Interpretation.\*\* It gives an indication of when the traded price is below a \\"fair value\\".\n\n\*\*Notes.\*\* Created by \[David Puell]\() and \[Murad Muhmudov]\(). For more information, see the post on \[the MVRV ratio]\( > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/mvrv":{"get":{"summary":"MVRV Ratio","description":"**Definition.** Market Value to Realized Value (MVRV) is the ratio between market cap and realized cap.\\n\\n**Interpretation.** It gives an indication of when the traded price is below a \\\"fair value\\\".\\n\\n**Notes.** Created by [David Puell](https://twitter.com/kenoshaking) and [Murad Muhmudov](https://twitter.com/MustStopMurad). For more information, see the post on [the MVRV ratio](https://medium.com/adaptivecapital/bitcoin-market-value-to-realized-value-mvrv-ratio-3ebc914dbaee).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.Mvrv?a=BTC)\n","operationId":"market.Mvrv","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 Z-Score > \*\*Definition.\*\* MVRV Z-Score evaluates whether is overvalued or undervalued relative to its fair value by standardising the spread between market value and realized value.\n\n\*\*Technical.\*\* Defined as the ratio between the difference of market cap and realized cap, and the standard deviation of market cap: (market cap - realized cap) / std(market cap). The standard deviation is computed cumulatively from the first available data point to the present day. Market value is network valuation by spot price multiplied by supply, while realized value represents the cumulative capital inflow into the asset.\n\n\*\*Interpretation.\*\* When market value is significantly higher than realized value, the score has typically signaled a market top (red zone). When significantly lower, it has often indicated a market bottom (green zone).\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/mvrv_z_score":{"get":{"summary":"MVRV Z-Score","description":"**Definition.** MVRV Z-Score evaluates whether is overvalued or undervalued relative to its fair value by standardising the spread between market value and realized value.\\n\\n**Technical.** Defined as the ratio between the difference of market cap and realized cap, and the standard deviation of market cap: (market cap - realized cap) / std(market cap). The standard deviation is computed cumulatively from the first available data point to the present day. Market value is network valuation by spot price multiplied by supply, while realized value represents the cumulative capital inflow into the asset.\\n\\n**Interpretation.** When market value is significantly higher than realized value, the score has typically signaled a market top (red zone). When significantly lower, it has often indicated a market bottom (green zone).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.MvrvZScore?a=BTC)\n","operationId":"market.MvrvZScore","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"}}}}}}}}} ``` ## Price > \*\*Definition.\*\* The closing price of in USD, aggregated from both centralised and decentralised exchanges. Strictly immutable data points are available in the point-in-time variant of this metric.\n\n\*\*Technical.\*\* Prices are calculated using a VWAP-like methodology with outlier detection to mitigate the impact of erroneous or anomalous trades on the final composite price. Data is available with up to 10-minute resolution and usually arrives with 3-minute latency once the interval has ended. Prices may occasionally change as late-reported data from individual exchanges is incorporated.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/price_usd_close":{"get":{"summary":"Price","description":"**Definition.** The closing price of in USD, aggregated from both centralised and decentralised exchanges. Strictly immutable data points are available in the point-in-time variant of this metric.\\n\\n**Technical.** Prices are calculated using a VWAP-like methodology with outlier detection to mitigate the impact of erroneous or anomalous trades on the final composite price. Data is available with up to 10-minute resolution and usually arrives with 3-minute latency once the interval has ended. Prices may occasionally change as late-reported data from individual exchanges is incorporated.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.PriceUsdClose?a=BTC)\n","operationId":"market.PriceUsdClose","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, 1month, 1w, 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"}}}}}}}}} ``` ## Price Drawdown from ATH > \*\*Definition.\*\* The percent drawdown of the asset\'s price from the previous all-time high.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/price_drawdown_relative":{"get":{"summary":"Price Drawdown from ATH","description":"**Definition.** The percent drawdown of the asset's price from the previous all-time high.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.PriceDrawdownRelative?a=BTC)\n","operationId":"market.PriceDrawdownRelative","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, 1month, 1w, 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"}}}}}}}}} ``` ## Price OHLC > \*\*Definition.\*\* The Open, High, Low, and Close prices of in USD, aggregated from both centralised and decentralised exchanges.\n\n\*\*Technical.\*\* Prices are calculated using a VWAP-like methodology with outlier detection to mitigate the impact of erroneous or anomalous trades on the final composite. Data is available with up to 10-minute resolution and usually arrives with 3-minute latency once the interval has ended. Prices may occasionally change as late-reported data from individual exchanges is incorporated. When showing 1-hour resolution, the chart dynamically aggregates data based on zoom level.\n\n\*\*Notes.\*\* Strictly immutable data points are available in the point-in-time variant of this metric.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/price_usd_ohlc":{"get":{"summary":"Price OHLC","description":"**Definition.** The Open, High, Low, and Close prices of in USD, aggregated from both centralised and decentralised exchanges.\\n\\n**Technical.** Prices are calculated using a VWAP-like methodology with outlier detection to mitigate the impact of erroneous or anomalous trades on the final composite. Data is available with up to 10-minute resolution and usually arrives with 3-minute latency once the interval has ended. Prices may occasionally change as late-reported data from individual exchanges is incorporated. When showing 1-hour resolution, the chart dynamically aggregates data based on zoom level.\\n\\n**Notes.** Strictly immutable data points are available in the point-in-time variant of this metric.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.PriceUsdOhlc?a=BTC)\n","operationId":"market.PriceUsdOhlc","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 > \*\*Definition.\*\* Realized Cap values different parts of the supply at different prices instead of using the current daily close. It represents the aggregate on-chain cost basis of the supply.\n\n\*\*Technical.\*\* It is computed by valuing each UTXO at the price when it was last moved.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/marketcap_realized_usd":{"get":{"summary":"Realized Cap","description":"**Definition.** Realized Cap values different parts of the supply at different prices instead of using the current daily close. It represents the aggregate on-chain cost basis of the supply.\\n\\n**Technical.** It is computed by valuing each UTXO at the price when it was last moved.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.MarketcapRealizedUsd?a=BTC)\n","operationId":"market.MarketcapRealizedUsd","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 > \*\*Definition.\*\* Realized Price is Realized Cap divided by current supply. It represents the volume-weighted average price at which every unit of circulating supply last moved on-chain.\n\n\*\*Interpretation.\*\* Spot above Realized Price means the aggregate holder base sits in unrealized profit, while spot below means net unrealized loss.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/price_realized_usd":{"get":{"summary":"Realized Price","description":"**Definition.** Realized Price is Realized Cap divided by current supply. It represents the volume-weighted average price at which every unit of circulating supply last moved on-chain.\\n\\n**Interpretation.** Spot above Realized Price means the aggregate holder base sits in unrealized profit, while spot below means net unrealized loss.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.PriceRealizedUsd?a=BTC)\n","operationId":"market.PriceRealizedUsd","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 Volatility (1 Month) > \*\*Definition.\*\* Annualized Realized Volatility (1 Month) is the standard deviation of returns from the mean return of the market, measured over a rolling 1-month window and annualized.\n\n\*\*Technical.\*\* Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas \[implied volatility]\() reflects the market\'s assessment of future volatility, realized volatility measures what happened in the past.\n\n\*\*Interpretation.\*\* High values indicate a phase of high risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_1_month":{"get":{"summary":"Realized Volatility (1 Month)","description":"**Definition.** Annualized Realized Volatility (1 Month) is the standard deviation of returns from the mean return of the market, measured over a rolling 1-month window and annualized.\\n\\n**Technical.** Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll) reflects the market's assessment of future volatility, realized volatility measures what happened in the past.\\n\\n**Interpretation.** High values indicate a phase of high risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatility1Month?a=BTC)\n","operationId":"market.RealizedVolatility1Month","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 Volatility (1 Week) > \*\*Definition.\*\* Annualized Realized Volatility (1 Week) is the standard deviation of returns from the mean return of the market, measured over a rolling 1-week window and annualized.\n\n\*\*Technical.\*\* Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas \[implied volatility]\() reflects the market\'s assessment of future volatility, realized volatility measures what happened in the past.\n\n\*\*Interpretation.\*\* High values indicate a phase of high risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_1_week":{"get":{"summary":"Realized Volatility (1 Week)","description":"**Definition.** Annualized Realized Volatility (1 Week) is the standard deviation of returns from the mean return of the market, measured over a rolling 1-week window and annualized.\\n\\n**Technical.** Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll) reflects the market's assessment of future volatility, realized volatility measures what happened in the past.\\n\\n**Interpretation.** High values indicate a phase of high risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatility1Week?a=BTC)\n","operationId":"market.RealizedVolatility1Week","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 Volatility (1 Year) > \*\*Definition.\*\* Annualized Realized Volatility (1 Year) is the standard deviation of returns measured over a rolling one-year window, expressed on an annualized basis.\n\n\*\*Technical.\*\* Computed from daily log returns and multiplied by \`sqrt(365)\` to yield the annualized realized volatility over a rolling 365-day window. Realized volatility measures past delivered movement, in contrast to \[implied volatility]\(), which reflects the market\'s assessment of future volatility.\n\n\*\*Interpretation.\*\* Higher values indicate phases of higher delivered risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_1_year":{"get":{"summary":"Realized Volatility (1 Year)","description":"**Definition.** Annualized Realized Volatility (1 Year) is the standard deviation of returns measured over a rolling one-year window, expressed on an annualized basis.\\n\\n**Technical.** Computed from daily log returns and multiplied by `sqrt(365)` to yield the annualized realized volatility over a rolling 365-day window. Realized volatility measures past delivered movement, in contrast to [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll), which reflects the market's assessment of future volatility.\\n\\n**Interpretation.** Higher values indicate phases of higher delivered risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatility1Year?a=BTC)\n","operationId":"market.RealizedVolatility1Year","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 Volatility (2 Weeks) > \*\*Definition.\*\* Annualized Realized Volatility (2 Weeks) is the standard deviation of returns from the mean return of the market, measured over a rolling 2-week window and annualized.\n\n\*\*Technical.\*\* Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas \[implied volatility]\() reflects the market\'s assessment of future volatility, realized volatility measures what happened in the past.\n\n\*\*Interpretation.\*\* High values indicate a phase of high risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_2_weeks":{"get":{"summary":"Realized Volatility (2 Weeks)","description":"**Definition.** Annualized Realized Volatility (2 Weeks) is the standard deviation of returns from the mean return of the market, measured over a rolling 2-week window and annualized.\\n\\n**Technical.** Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll) reflects the market's assessment of future volatility, realized volatility measures what happened in the past.\\n\\n**Interpretation.** High values indicate a phase of high risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatility2Weeks?a=BTC)\n","operationId":"market.RealizedVolatility2Weeks","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 Volatility (3 Months) > \*\*Definition.\*\* Annualized Realized Volatility (3 Months) is the standard deviation of returns from the mean return of the market, measured over a rolling 3-month window and annualized.\n\n\*\*Technical.\*\* Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas \[implied volatility]\() reflects the market\'s assessment of future volatility, realized volatility measures what happened in the past.\n\n\*\*Interpretation.\*\* High values indicate a phase of high risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_3_months":{"get":{"summary":"Realized Volatility (3 Months)","description":"**Definition.** Annualized Realized Volatility (3 Months) is the standard deviation of returns from the mean return of the market, measured over a rolling 3-month window and annualized.\\n\\n**Technical.** Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll) reflects the market's assessment of future volatility, realized volatility measures what happened in the past.\\n\\n**Interpretation.** High values indicate a phase of high risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatility3Months?a=BTC)\n","operationId":"market.RealizedVolatility3Months","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 Volatility (6 Months) > \*\*Definition.\*\* Annualized Realized Volatility (6 Months) is the standard deviation of returns from the mean return of the market, measured over a rolling 6-month window and annualized.\n\n\*\*Technical.\*\* Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas \[implied volatility]\() reflects the market\'s assessment of future volatility, realized volatility measures what happened in the past.\n\n\*\*Interpretation.\*\* High values indicate a phase of high risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_6_months":{"get":{"summary":"Realized Volatility (6 Months)","description":"**Definition.** Annualized Realized Volatility (6 Months) is the standard deviation of returns from the mean return of the market, measured over a rolling 6-month window and annualized.\\n\\n**Technical.** Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll) reflects the market's assessment of future volatility, realized volatility measures what happened in the past.\\n\\n**Interpretation.** High values indicate a phase of high risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatility6Months?a=BTC)\n","operationId":"market.RealizedVolatility6Months","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 Volatility (All) > \*\*Definition.\*\* Annualized Realized Volatility (All) is the standard deviation of returns from the mean return of the market, measured over rolling windows of 1 week, 2 weeks, 1 month, 3 months, 6 months, and 1 year, each annualized.\n\n\*\*Technical.\*\* Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas \[implied volatility]\() reflects the market\'s assessment of future volatility, realized volatility measures what happened in the past.\n\n\*\*Interpretation.\*\* High values indicate a phase of high risk in the market.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/realized_volatility_all":{"get":{"summary":"Realized Volatility (All)","description":"**Definition.** Annualized Realized Volatility (All) is the standard deviation of returns from the mean return of the market, measured over rolling windows of 1 week, 2 weeks, 1 month, 3 months, 6 months, and 1 year, each annualized.\\n\\n**Technical.** Computed on log returns over a fixed time horizon or a rolling window to obtain a time-dependent observable. Realized volatility is calculated from daily returns and multiplied by a factor of sqrt(365) to yield the annualized daily realized volatility. Whereas [implied volatility](https://studio.glassnode.com/metrics?a=BTC&category=&m=derivatives.OptionsAtmImpliedVolatilityAll) reflects the market's assessment of future volatility, realized volatility measures what happened in the past.\\n\\n**Interpretation.** High values indicate a phase of high risk in the market.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.RealizedVolatilityAll?a=BTC)\n","operationId":"market.RealizedVolatilityAll","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"}}}}}}}}} ``` ## Spot / Futures Volume > \*\*Definition.\*\* Spot / Futures Volume Ratio is the ratio of spot trading volume to futures trading volume, indicating whether market activity is dominated by spot or derivatives trading.\n\n\*\*Technical.\*\* The metric can be viewed per exchange or aggregated across all exchanges (default).\n\n\*\*Interpretation.\*\* Values above 1 indicate spot volume exceeds futures volume, while values below 1 indicate futures-dominated trading.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_futures_volume_ratio":{"get":{"summary":"Spot / Futures Volume","description":"**Definition.** Spot / Futures Volume Ratio is the ratio of spot trading volume to futures trading volume, indicating whether market activity is dominated by spot or derivatives trading.\\n\\n**Technical.** The metric can be viewed per exchange or aggregated across all exchanges (default).\\n\\n**Interpretation.** Values above 1 indicate spot volume exceeds futures volume, while values below 1 indicate futures-dominated trading.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotFuturesVolumeRatio?a=BTC)\n","operationId":"market.SpotFuturesVolumeRatio","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"}}}}}}}}} ``` ## Spot Accumulation/Distribution Line (ADL) > \*\*Definition.\*\* The Accumulation/Distribution Line (ADL) is a cumulative indicator that uses volume and price to assess whether an asset is being accumulated (bought) or distributed (sold), measuring money flow volume from the relationship between closing price and the day\'s price range.\n\n\*\*Technical.\*\* Tracks ADL for spot trades where USD or USD-related currencies serve as the quote. The series can be viewed per exchange or aggregated across exchanges.\n\n\*\*Interpretation.\*\* When price closes in the upper portion of the day\'s range, the indicator reflects accumulation. When it closes in the lower portion, it reflects distribution.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_accumulation_distribution_line":{"get":{"summary":"Spot Accumulation/Distribution Line (ADL)","description":"**Definition.** The Accumulation/Distribution Line (ADL) is a cumulative indicator that uses volume and price to assess whether an asset is being accumulated (bought) or distributed (sold), measuring money flow volume from the relationship between closing price and the day's price range.\\n\\n**Technical.** Tracks ADL for spot trades where USD or USD-related currencies serve as the quote. The series can be viewed per exchange or aggregated across exchanges.\\n\\n**Interpretation.** When price closes in the upper portion of the day's range, the indicator reflects accumulation. When it closes in the lower portion, it reflects distribution.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotAccumulationDistributionLine?a=BTC)\n","operationId":"market.SpotAccumulationDistributionLine","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 - 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"}}}}}}}}} ``` ## Spot Buying Volume > \*\*Definition.\*\* The total spot trading volume in which the buyer was the aggressor, denominated in the native asset against USD-related currencies (both fiat and stablecoins).\n\n\*\*Technical.\*\* Volume is aggregated within an intraday time window determined by the chosen data resolution (e.g. hourly, 10-minute intervals). Available for individual exchanges or as an aggregate total across exchanges.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_buying_volume_sum":{"get":{"summary":"Spot Buying Volume","description":"**Definition.** The total spot trading volume in which the buyer was the aggressor, denominated in the native asset against USD-related currencies (both fiat and stablecoins).\\n\\n**Technical.** Volume is aggregated within an intraday time window determined by the chosen data resolution (e.g. hourly, 10-minute intervals). Available for individual exchanges or as an aggregate total across exchanges.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotBuyingVolumeSum?a=BTC)\n","operationId":"market.SpotBuyingVolumeSum","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"}}}}}}}}} ``` ## Spot Cumulative Volume Delta (CVD) > \*\*Definition.\*\* Spot Cumulative Volume Delta (CVD) is the running total of net buying versus selling volume over time, capturing sustained market pressure in either direction.\n\n\*\*Technical.\*\* Aggregates Volume Delta (VD), the difference between buyer-initiated and seller-initiated trades, across intervals (e.g., hourly, 10-minute) where USD or USD-related currencies serve as the quote. The series can be viewed per exchange or aggregated across exchanges to reveal persistent market momentum.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_cvd_sum":{"get":{"summary":"Spot Cumulative Volume Delta (CVD)","description":"**Definition.** Spot Cumulative Volume Delta (CVD) is the running total of net buying versus selling volume over time, capturing sustained market pressure in either direction.\\n\\n**Technical.** Aggregates Volume Delta (VD), the difference between buyer-initiated and seller-initiated trades, across intervals (e.g., hourly, 10-minute) where USD or USD-related currencies serve as the quote. The series can be viewed per exchange or aggregated across exchanges to reveal persistent market momentum.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotCvdSum?a=BTC)\n","operationId":"market.SpotCvdSum","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"}}}}}}}}} ``` ## Spot Money Flow Index (MFI) > \*\*Definition.\*\* The Money Flow Index (MFI) is a momentum indicator that uses both price and volume data to identify overbought or oversold conditions, ranging from 0.\n\n\*\*Technical.\*\* Calculated using a 14-day period, MFI incorporates typical price (average of high, low, and close) multiplied by volume to measure buying and selling pressure. The metric tracks MFI for spot trades where USD or USD-related currencies serve as the quote, and can be viewed per exchange or aggregated across exchanges.\n\n\*\*Interpretation.\*\* Readings above 80 indicate oversold conditions.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_money_flow_index":{"get":{"summary":"Spot Money Flow Index (MFI)","description":"**Definition.** The Money Flow Index (MFI) is a momentum indicator that uses both price and volume data to identify overbought or oversold conditions, ranging from 0.\\n\\n**Technical.** Calculated using a 14-day period, MFI incorporates typical price (average of high, low, and close) multiplied by volume to measure buying and selling pressure. The metric tracks MFI for spot trades where USD or USD-related currencies serve as the quote, and can be viewed per exchange or aggregated across exchanges.\\n\\n**Interpretation.** Readings above 80 indicate oversold conditions.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotMoneyFlowIndex?a=BTC)\n","operationId":"market.SpotMoneyFlowIndex","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 - 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"}}}}}}}}} ``` ## Spot On-Balance Volume (OBV) > \*\*Definition.\*\* Spot On-Balance Volume (OBV) is a cumulative momentum indicator that relates volume to price changes, adding volume on up days and subtracting volume on down days to gauge the strength behind price movements.\n\n\*\*Technical.\*\* Computed across spot trades aggregated from exchanges where USD or USD-related currencies serve as the quote.\n\n\*\*Interpretation.\*\* Positive OBV indicates net accumulation or buying pressure, negative OBV indicates net distribution or selling pressure.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_on_balance_volume":{"get":{"summary":"Spot On-Balance Volume (OBV)","description":"**Definition.** Spot On-Balance Volume (OBV) is a cumulative momentum indicator that relates volume to price changes, adding volume on up days and subtracting volume on down days to gauge the strength behind price movements.\\n\\n**Technical.** Computed across spot trades aggregated from exchanges where USD or USD-related currencies serve as the quote.\\n\\n**Interpretation.** Positive OBV indicates net accumulation or buying pressure, negative OBV indicates net distribution or selling pressure.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotOnBalanceVolume?a=BTC)\n","operationId":"market.SpotOnBalanceVolume","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 - 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"}}}}}}}}} ``` ## Spot Relative Volume (30D) > \*\*Definition.\*\* Spot Relative Volume (30D) is current spot trading volume divided by the trailing 30-day average volume, expressing current activity relative to its recent norm.\n\n\*\*Technical.\*\* Computed for spot trades where USD or USD-related currencies serve as the quote. Available per individual exchange or aggregated across exchanges.\n\n\*\*Interpretation.\*\* Values above 1.0 indicate higher-than-average volume, values below 1.0 indicate lower-than-average activity. Sharp deviations from 1.0 surface unusual trading activity and often coincide with significant market events.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_relative_30d":{"get":{"summary":"Spot Relative Volume (30D)","description":"**Definition.** Spot Relative Volume (30D) is current spot trading volume divided by the trailing 30-day average volume, expressing current activity relative to its recent norm.\\n\\n**Technical.** Computed for spot trades where USD or USD-related currencies serve as the quote. Available per individual exchange or aggregated across exchanges.\\n\\n**Interpretation.** Values above 1.0 indicate higher-than-average volume, values below 1.0 indicate lower-than-average activity. Sharp deviations from 1.0 surface unusual trading activity and often coincide with significant market events.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeRelative30D?a=BTC)\n","operationId":"market.SpotVolumeRelative30D","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 - 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"}}}}}}}}} ``` ## Spot Selling Volume > \*\*Definition.\*\* The aggregate spot trading volume in which the seller was the aggressor, for the native asset against USD-related currencies (both fiat and stablecoins).\n\n\*\*Technical.\*\* Computed within an intraday time frame determined by the chosen data resolution (e.g. hourly, 10-minute). Available for individual exchanges or as an aggregate total across exchanges.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_selling_volume_sum":{"get":{"summary":"Spot Selling Volume","description":"**Definition.** The aggregate spot trading volume in which the seller was the aggressor, for the native asset against USD-related currencies (both fiat and stablecoins).\\n\\n**Technical.** Computed within an intraday time frame determined by the chosen data resolution (e.g. hourly, 10-minute). Available for individual exchanges or as an aggregate total across exchanges.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotSellingVolumeSum?a=BTC)\n","operationId":"market.SpotSellingVolumeSum","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"}}}}}}}}} ``` ## Spot Volume > \*\*Definition.\*\* The aggregate spot trading volume for the native asset against USD-related currencies (both fiat and stablecoins), summed within an intraday interval.\n\n\*\*Technical.\*\* The interval length is determined by the chosen data resolution (e.g. hourly, 10-minute). Available per individual exchange or as an aggregate across exchanges.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_sum_intraday":{"get":{"summary":"Spot Volume","description":"**Definition.** The aggregate spot trading volume for the native asset against USD-related currencies (both fiat and stablecoins), summed within an intraday interval.\\n\\n**Technical.** The interval length is determined by the chosen data resolution (e.g. hourly, 10-minute). Available per individual exchange or as an aggregate across exchanges.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeSumIntraday?a=BTC)\n","operationId":"market.SpotVolumeSumIntraday","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"}}}}}}}}} ``` ## Spot Volume (All Assets) > \*\*Definition.\*\* The aggregate spot trading volume across all assets paired with USD-related currencies (both fiat and stablecoins), summed within an intraday interval.\n\n\*\*Technical.\*\* The interval length is determined by the chosen data resolution (e.g. hourly, 10-minute). Available per individual exchange or as an aggregate across exchanges.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_sum_intraday_all":{"get":{"summary":"Spot Volume (All Assets)","description":"**Definition.** The aggregate spot trading volume across all assets paired with USD-related currencies (both fiat and stablecoins), summed within an intraday interval.\\n\\n**Technical.** The interval length is determined by the chosen data resolution (e.g. hourly, 10-minute). Available per individual exchange or as an aggregate across exchanges.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeSumIntradayAll?a=BTC)\n","operationId":"market.SpotVolumeSumIntradayAll","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"}}}}}}}}} ``` ## Spot Volume / Market Cap > \*\*Definition.\*\* Spot Volume / Market Cap Ratio is spot trading volume divided by market capitalization, expressing trading activity relative to the asset\'s size.\n\n\*\*Technical.\*\* Available per individual exchange or aggregated across exchanges (default).\n\n\*\*Interpretation.\*\* Higher values indicate more active trading relative to the asset\'s market cap, lower values indicate quieter turnover relative to size.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_mcap_ratio":{"get":{"summary":"Spot Volume / Market Cap","description":"**Definition.** Spot Volume / Market Cap Ratio is spot trading volume divided by market capitalization, expressing trading activity relative to the asset's size.\\n\\n**Technical.** Available per individual exchange or aggregated across exchanges (default).\\n\\n**Interpretation.** Higher values indicate more active trading relative to the asset's market cap, lower values indicate quieter turnover relative to size.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeMcapRatio?a=BTC)\n","operationId":"market.SpotVolumeMcapRatio","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"}}}}}}}}} ``` ## Spot Volume 24h > \*\*Definition.\*\* The total spot trading volume of the native asset against all USD-related currencies (both fiat and stablecoins), aggregated over the past 24 hours.\n\n\*\*Technical.\*\* Available per individual exchange or as an aggregate across exchanges (default). Values are presented according to the selected data resolution.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_daily_sum":{"get":{"summary":"Spot Volume 24h","description":"**Definition.** The total spot trading volume of the native asset against all USD-related currencies (both fiat and stablecoins), aggregated over the past 24 hours.\\n\\n**Technical.** Available per individual exchange or as an aggregate across exchanges (default). Values are presented according to the selected data resolution.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeDailySum?a=BTC)\n","operationId":"market.SpotVolumeDailySum","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"}}}}}}}}} ``` ## Spot Volume 24h (Latest) > \*\*Definition.\*\* The total spot trading volume of the native asset, aggregated over the trailing 24 hours and reported per exchange.\n\n\*\*Technical.\*\* Values are updated every 10 minutes. Alongside the volume, a \`change\` value is reported indicating the difference compared to the previous update.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_daily_latest":{"get":{"summary":"Spot Volume 24h (Latest)","description":"**Definition.** The total spot trading volume of the native asset, aggregated over the trailing 24 hours and reported per exchange.\\n\\n**Technical.** Values are updated every 10 minutes. Alongside the volume, a `change` value is reported indicating the difference compared to the previous update.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeDailyLatest?a=BTC)\n","operationId":"market.SpotVolumeDailyLatest","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":"i","in":"query","required":true,"description":"frequency interval - 10m","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"}}}}}}}}} ``` ## Spot Volume 24h (Stacked) > \*\*Definition.\*\* The cumulative spot trading volume of the native asset against USD-based currencies (both fiat and stablecoins) over the trailing 24 hours, broken down by each exchange and visualized as a stacked area.\n\n\*\*Technical.\*\* Each component series sums trades on a single exchange across the 24-hour window, the stacked total reflects the aggregate across exchanges.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_daily_sum_all":{"get":{"summary":"Spot Volume 24h (Stacked)","description":"**Definition.** The cumulative spot trading volume of the native asset against USD-based currencies (both fiat and stablecoins) over the trailing 24 hours, broken down by each exchange and visualized as a stacked area.\\n\\n**Technical.** Each component series sums trades on a single exchange across the 24-hour window, the stacked total reflects the aggregate across exchanges.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeDailySumAll?a=BTC)\n","operationId":"market.SpotVolumeDailySumAll","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"}}}}}}}}} ``` ## Spot Volume Delta > \*\*Definition.\*\* Spot Volume Delta (VD) is the net difference between buyer-initiated and seller-initiated spot trade volume, for the native asset quoted against USD-related currencies (both fiat and stablecoins).\n\n\*\*Technical.\*\* Computed per interval within an intraday time frame determined by the chosen data resolution (e.g. hourly, 10-minute). Available for individual exchanges or as an aggregate total across exchanges.\n\n\*\*Interpretation.\*\* Positive values indicate taker-buy pressure dominated within the interval, negative values indicate taker-sell pressure dominated.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_vd_sum":{"get":{"summary":"Spot Volume Delta","description":"**Definition.** Spot Volume Delta (VD) is the net difference between buyer-initiated and seller-initiated spot trade volume, for the native asset quoted against USD-related currencies (both fiat and stablecoins).\\n\\n**Technical.** Computed per interval within an intraday time frame determined by the chosen data resolution (e.g. hourly, 10-minute). Available for individual exchanges or as an aggregate total across exchanges.\\n\\n**Interpretation.** Positive values indicate taker-buy pressure dominated within the interval, negative values indicate taker-sell pressure dominated.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVdSum?a=BTC)\n","operationId":"market.SpotVdSum","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"}}}}}}}}} ``` ## Spot Volume Price Trend (VPT) > \*\*Definition.\*\* Spot Volume Price Trend (VPT) is a cumulative indicator that combines price and volume, weighting volume by the percentage price change from the previous period to track the strength of price trends and flag potential reversals.\n\n\*\*Technical.\*\* Each period adds or subtracts a portion of volume scaled by the period\'s percentage price change, producing a running total. Unlike OBV, which uses absolute volume changes, VPT weights volume by the magnitude of price movement, making it more sensitive to the degree of price changes. Computed across spot trades aggregated from exchanges where USD or USD-related currencies serve as the quote.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_price_trend":{"get":{"summary":"Spot Volume Price Trend (VPT)","description":"**Definition.** Spot Volume Price Trend (VPT) is a cumulative indicator that combines price and volume, weighting volume by the percentage price change from the previous period to track the strength of price trends and flag potential reversals.\\n\\n**Technical.** Each period adds or subtracts a portion of volume scaled by the period's percentage price change, producing a running total. Unlike OBV, which uses absolute volume changes, VPT weights volume by the magnitude of price movement, making it more sensitive to the degree of price changes. Computed across spot trades aggregated from exchanges where USD or USD-related currencies serve as the quote.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumePriceTrend?a=BTC)\n","operationId":"market.SpotVolumePriceTrend","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 - 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"}}}}}}}}} ``` ## Spot Volume Trend (7D) > \*\*Definition.\*\* Spot Volume Trend (7D) is the percentage change in the 7-day average trading volume compared to the 7-day average volume from 7 days prior.\n\n\*\*Technical.\*\* Computed for spot trades where USD or USD-related currencies serve as the quote. Available per individual exchange or aggregated across exchanges.\n\n\*\*Interpretation.\*\* Positive values indicate trading activity is expanding week-over-week, negative values indicate it is contracting. Direction surfaces changes in market interest and liquidity conditions over the weekly horizon.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_trend_7d":{"get":{"summary":"Spot Volume Trend (7D)","description":"**Definition.** Spot Volume Trend (7D) is the percentage change in the 7-day average trading volume compared to the 7-day average volume from 7 days prior.\\n\\n**Technical.** Computed for spot trades where USD or USD-related currencies serve as the quote. Available per individual exchange or aggregated across exchanges.\\n\\n**Interpretation.** Positive values indicate trading activity is expanding week-over-week, negative values indicate it is contracting. Direction surfaces changes in market interest and liquidity conditions over the weekly horizon.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeTrend7D?a=BTC)\n","operationId":"market.SpotVolumeTrend7D","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 - 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"}}}}}}}}} ``` ## Spot VWAP > \*\*Definition.\*\* Spot Volume-Weighted Average Price (VWAP) is the average price at which an asset has traded over a chosen period, weighted by spot volume.\n\n\*\*Technical.\*\* Computed as the cumulative typical price (average of high, low, and close) multiplied by volume, divided by cumulative volume over the chosen window. Computed across spot trades aggregated from exchanges where USD or USD-related currencies serve as the quote. Use the period dropdown to select the lookback window (24h for daily or 1w for weekly).\n\n\*\*Interpretation.\*\* Used as a benchmark for trade execution quality and as a reference for potential support and resistance levels.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/spot_volume_weighted_average_price":{"get":{"summary":"Spot VWAP","description":"**Definition.** Spot Volume-Weighted Average Price (VWAP) is the average price at which an asset has traded over a chosen period, weighted by spot volume.\\n\\n**Technical.** Computed as the cumulative typical price (average of high, low, and close) multiplied by volume, divided by cumulative volume over the chosen window. Computed across spot trades aggregated from exchanges where USD or USD-related currencies serve as the quote. Use the period dropdown to select the lookback window (24h for daily or 1w for weekly).\\n\\n**Interpretation.** Used as a benchmark for trade execution quality and as a reference for potential support and resistance levels.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.SpotVolumeWeightedAveragePrice?a=BTC)\n","operationId":"market.SpotVolumeWeightedAveragePrice","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 - 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"}}}}}}}}} ``` ## STH-MVRV > \*\*Definition.\*\* Short Term Holder MVRV (STH-MVRV) is the MVRV ratio computed using only UTXOs younger than 155 days, serving as an indicator of short-term investor behaviour.\n\n\*\*Notes.\*\* For more information, see our article on \[breaking up on-chain metrics for short- and long-term holders]\( > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/mvrv_less_155":{"get":{"summary":"STH-MVRV","description":"**Definition.** Short Term Holder MVRV (STH-MVRV) is the MVRV ratio computed using only UTXOs younger than 155 days, serving as an indicator of short-term investor behaviour.\\n\\n**Notes.** For more information, see our article on [breaking up on-chain metrics for short- and long-term holders](https://insights.glassnode.com/sth-lth-sopr-mvrv).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.MvrvLess155?a=BTC)\n","operationId":"market.MvrvLess155","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"}}}}}}}}} ``` ## US Month-over-Month Price Change > \*\*Definition.\*\* The 30-day change in the regional price series constructed from price movements that occur during US working hours, between 8am and 8pm Eastern Time (13:00-01:00 UTC, or 12:00-0:00 UTC under Eastern Daylight Time).\n\n\*\*Technical.\*\* Regional prices are constructed in a two-step process. First, price movements are assigned to regions based on working hours in the US, Europe, and Asia. Regional prices are then derived by taking the cumulative sum of the price changes over time for each region.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - market","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/market/amer_30d_price_change":{"get":{"summary":"US Month-over-Month Price Change","description":"**Definition.** The 30-day change in the regional price series constructed from price movements that occur during US working hours, between 8am and 8pm Eastern Time (13:00-01:00 UTC, or 12:00-0:00 UTC under Eastern Daylight Time).\\n\\n**Technical.** Regional prices are constructed in a two-step process. First, price movements are assigned to regions based on working hours in the US, Europe, and Asia. Regional prices are then derived by taking the cumulative sum of the price changes over time for each region.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/market.Amer30DPriceChange?a=BTC)\n","operationId":"market.Amer30DPriceChange","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"}}}}}}}}} ``` --- # 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/market.md?ask= ``` 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.