> For the complete documentation index, see [llms.txt](https://docs.glassnode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.glassnode.com/basic-api/endpoints/fees.md).
# Fees
## Exchange Fee Dominance
> \*\*Definition.\*\* Exchange Fee Dominance is the percentage of total transaction fees paid in transactions related to on-chain exchange activity, segmented by counterparty role:\n- Deposits: transactions that include an exchange address as the receiver of funds.\n- Withdrawals: transactions that include an exchange address as the sender of funds.\n- In-House: transactions that include addresses of a single exchange as both the sender and receiver of funds.\n- Inter-Exchange: transactions that include addresses of (distinct) exchanges as both the sender and receiver of funds.\n\n\*\*Technical.\*\* When a transaction can be categorized into multiple of these categories, for example a transaction that sends funds externally as well as in-house, the fees are split into percentages according to the volume transferred. Exchange metrics are based on Glassnode\'s continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our \[article on exchange metrics]\() and \[Exchange Data Transparency Notice]\(
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/exchanges_relative":{"get":{"summary":"Exchange Fee Dominance","description":"**Definition.** Exchange Fee Dominance is the percentage of total transaction fees paid in transactions related to on-chain exchange activity, segmented by counterparty role:\\n- Deposits: transactions that include an exchange address as the receiver of funds.\\n- Withdrawals: transactions that include an exchange address as the sender of funds.\\n- In-House: transactions that include addresses of a single exchange as both the sender and receiver of funds.\\n- Inter-Exchange: transactions that include addresses of (distinct) exchanges as both the sender and receiver of funds.\\n\\n**Technical.** When a transaction can be categorized into multiple of these categories, for example a transaction that sends funds externally as well as in-house, the fees are split into percentages according to the volume transferred. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our [article on exchange metrics](https://insights.glassnode.com/exchange-metrics/) and [Exchange Data Transparency Notice](https://docs.glassnode.com/further-information/exchange-data-transparency-notice).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.ExchangesRelative?a=BTC)\n","operationId":"fees.ExchangesRelative","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"}}}}}}}}}
```
## Exchange Fees (Mean)
> \*\*Definition.\*\* The mean amount of fees paid in transactions related to on-chain exchange activity, segmented into flow cohorts:\n- Deposits: transactions that include an exchange address as the receiver of funds.\n- Withdrawals: transactions that include an exchange address as the sender of funds.\n- In-House: transactions that include addresses of a single exchange as both the sender and receiver of funds.\n- Inter-Exchange: transactions that include addresses of (distinct) exchanges as both the sender and receiver of funds.\n\n\*\*Technical.\*\* The mean is computed over transfers, not transactions. If a transaction can be categorized into multiple of these categories (e.g. a transaction that sends funds externally as well as in-house), the fees are split into percentages according to the volume transferred. Exchange metrics are based on Glassnode\'s continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our \[article on exchange metrics]\() and \[Exchange Data Transparency Notice]\(
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/exchanges_mean":{"get":{"summary":"Exchange Fees (Mean)","description":"**Definition.** The mean amount of fees paid in transactions related to on-chain exchange activity, segmented into flow cohorts:\\n- Deposits: transactions that include an exchange address as the receiver of funds.\\n- Withdrawals: transactions that include an exchange address as the sender of funds.\\n- In-House: transactions that include addresses of a single exchange as both the sender and receiver of funds.\\n- Inter-Exchange: transactions that include addresses of (distinct) exchanges as both the sender and receiver of funds.\\n\\n**Technical.** The mean is computed over transfers, not transactions. If a transaction can be categorized into multiple of these categories (e.g. a transaction that sends funds externally as well as in-house), the fees are split into percentages according to the volume transferred. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our [article on exchange metrics](https://insights.glassnode.com/exchange-metrics/) and [Exchange Data Transparency Notice](https://docs.glassnode.com/further-information/exchange-data-transparency-notice).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.ExchangesMean?a=BTC)\n","operationId":"fees.ExchangesMean","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Exchange Fees (Total)
> \*\*Definition.\*\* The total amount of fees paid in transactions related to on-chain exchange activity, segmented by counterparty role:\n- Deposits: transactions that include an exchange address as the receiver of funds.\n- Withdrawals: transactions that include an exchange address as the sender of funds.\n- In-House: transactions that include addresses of a single exchange as both the sender and receiver of funds.\n- Inter-Exchange: transactions that include addresses of (distinct) exchanges as both the sender and receiver of funds.\n\n\*\*Technical.\*\* When a transaction can be categorized into multiple of these categories, for example a transaction that sends funds externally as well as in-house, the fees are split according to the volume transferred. Exchange metrics are based on Glassnode\'s continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our \[article on exchange metrics]\() and \[Exchange Data Transparency Notice]\(
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/exchanges_sum":{"get":{"summary":"Exchange Fees (Total)","description":"**Definition.** The total amount of fees paid in transactions related to on-chain exchange activity, segmented by counterparty role:\\n- Deposits: transactions that include an exchange address as the receiver of funds.\\n- Withdrawals: transactions that include an exchange address as the sender of funds.\\n- In-House: transactions that include addresses of a single exchange as both the sender and receiver of funds.\\n- Inter-Exchange: transactions that include addresses of (distinct) exchanges as both the sender and receiver of funds.\\n\\n**Technical.** When a transaction can be categorized into multiple of these categories, for example a transaction that sends funds externally as well as in-house, the fees are split according to the volume transferred. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our [article on exchange metrics](https://insights.glassnode.com/exchange-metrics/) and [Exchange Data Transparency Notice](https://docs.glassnode.com/further-information/exchange-data-transparency-notice).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.ExchangesSum?a=BTC)\n","operationId":"fees.ExchangesSum","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 1h, 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"c","in":"query","required":false,"description":"currency - NATIVE, USD","schema":{"type":"string"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Fee Ratio Multiple (FRM)
> \*\*Definition.\*\* Fee Ratio Multiple (FRM) is the ratio between total miner revenue (block rewards plus transaction fees) and transaction fees alone.\n\n\*\*Interpretation.\*\* FRM gauges how reliant network security is on protocol-issued block rewards versus user-paid fees, indicating how secure a chain would remain once block rewards disappear.\n\n\*\*Notes.\*\* Introduced by \[Matteo Leibowitz]\(). For more information, see his introduction to \[the Fee Ratio Multiple (FRM)]\(
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/fee_ratio_multiple":{"get":{"summary":"Fee Ratio Multiple (FRM)","description":"**Definition.** Fee Ratio Multiple (FRM) is the ratio between total miner revenue (block rewards plus transaction fees) and transaction fees alone.\\n\\n**Interpretation.** FRM gauges how reliant network security is on protocol-issued block rewards versus user-paid fees, indicating how secure a chain would remain once block rewards disappear.\\n\\n**Notes.** Introduced by [Matteo Leibowitz](https://twitter.com/teo_leibowitz). For more information, see his introduction to [the Fee Ratio Multiple (FRM)](https://medium.com/coinmonks/introducing-fee-ratio-multiple-frm-1eada9ac9bec).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.FeeRatioMultiple?a=BTC)\n","operationId":"fees.FeeRatioMultiple","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"}}}}}}}}}
```
## Fees (Mean)
> \*\*Definition.\*\* The mean fee paid per transaction.\n\n\*\*Technical.\*\* Issued (minted) coins are not included.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/volume_mean":{"get":{"summary":"Fees (Mean)","description":"**Definition.** The mean fee paid per transaction.\\n\\n**Technical.** Issued (minted) coins are not included.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.VolumeMean?a=BTC)\n","operationId":"fees.VolumeMean","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":"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"}}}}}}}}}
```
## Fees (Median)
> \*\*Definition.\*\* The median fee paid per transaction.\n\n\*\*Technical.\*\* Issued (minted) coins are not included.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/volume_median":{"get":{"summary":"Fees (Median)","description":"**Definition.** The median fee paid per transaction.\\n\\n**Technical.** Issued (minted) coins are not included.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.VolumeMedian?a=BTC)\n","operationId":"fees.VolumeMedian","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":"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"}}}}}}}}}
```
## Fees (Total)
> \*\*Definition.\*\* The total amount of fees paid to miners.\n\n\*\*Technical.\*\* Issued (minted) coins are not included.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/volume_sum":{"get":{"summary":"Fees (Total)","description":"**Definition.** The total amount of fees paid to miners.\\n\\n**Technical.** Issued (minted) coins are not included.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.VolumeSum?a=BTC)\n","operationId":"fees.VolumeSum","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":"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"}}}}}}}}}
```
## Gas Price (Mean)
> \*\*Definition.\*\* The mean gas price paid per transaction.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_price_mean":{"get":{"summary":"Gas Price (Mean)","description":"**Definition.** The mean gas price paid per transaction.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasPriceMean?a=ETH)\n","operationId":"fees.GasPriceMean","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":"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"}}}}}}}}}
```
## Gas Price (Median)
> \*\*Definition.\*\* The median gas price paid per transaction.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_price_median":{"get":{"summary":"Gas Price (Median)","description":"**Definition.** The median gas price paid per transaction.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasPriceMedian?a=ETH)\n","operationId":"fees.GasPriceMedian","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":"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"}}}}}}}}}
```
## Gas Usage by Bridges (Absolute)
> \*\*Definition.\*\* The total amount of gas consumed on the Ethereum network by contracts that allow transfer of tokens between different blockchains.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_bridges":{"get":{"summary":"Gas Usage by Bridges (Absolute)","description":"**Definition.** The total amount of gas consumed on the Ethereum network by contracts that allow transfer of tokens between different blockchains.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumBridges?a=ETH)\n","operationId":"fees.GasUsedSumBridges","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"}}}}}}}}}
```
## Gas Usage by Bridges (Relative)
> \*\*Definition.\*\* The share of total Ethereum network gas consumed by contracts that allow transfer of tokens between different blockchains.\n\n\*\*Interpretation.\*\* A rising share means cross-chain bridging activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_bridges_relative":{"get":{"summary":"Gas Usage by Bridges (Relative)","description":"**Definition.** The share of total Ethereum network gas consumed by contracts that allow transfer of tokens between different blockchains.\\n\\n**Interpretation.** A rising share means cross-chain bridging activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumBridgesRelative?a=ETH)\n","operationId":"fees.GasUsedSumBridgesRelative","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"}}}}}}}}}
```
## Gas Usage by DeFi (Absolute)
> \*\*Definition.\*\* The total amount of Ethereum network gas consumed by on-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs).\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_defi":{"get":{"summary":"Gas Usage by DeFi (Absolute)","description":"**Definition.** The total amount of Ethereum network gas consumed by on-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs).\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumDefi?a=ETH)\n","operationId":"fees.GasUsedSumDefi","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"}}}}}}}}}
```
## Gas Usage by DeFi (Relative)
> \*\*Definition.\*\* The share of total Ethereum network gas consumed by on-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs).\n\n\*\*Interpretation.\*\* A rising share means DeFi activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_defi_relative":{"get":{"summary":"Gas Usage by DeFi (Relative)","description":"**Definition.** The share of total Ethereum network gas consumed by on-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs).\\n\\n**Interpretation.** A rising share means DeFi activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumDefiRelative?a=ETH)\n","operationId":"fees.GasUsedSumDefiRelative","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"}}}}}}}}}
```
## Gas Usage by ERC-20 Tokens (Absolute)
> \*\*Definition.\*\* The total amount of Ethereum network gas consumed by transactions calling ERC-20 contracts.\n\n\*\*Technical.\*\* Stablecoin contracts are excluded from this category.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_erc20":{"get":{"summary":"Gas Usage by ERC-20 Tokens (Absolute)","description":"**Definition.** The total amount of Ethereum network gas consumed by transactions calling ERC-20 contracts.\\n\\n**Technical.** Stablecoin contracts are excluded from this category.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumErc20?a=ETH)\n","operationId":"fees.GasUsedSumErc20","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"}}}}}}}}}
```
## Gas Usage by ERC-20 Tokens (Relative)
> \*\*Definition.\*\* The share of total Ethereum network gas consumed by transactions calling ERC-20 contracts.\n\n\*\*Technical.\*\* Stablecoin contracts are excluded from this category.\n\n\*\*Interpretation.\*\* A rising share means ERC-20 token activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_erc20_relative":{"get":{"summary":"Gas Usage by ERC-20 Tokens (Relative)","description":"**Definition.** The share of total Ethereum network gas consumed by transactions calling ERC-20 contracts.\\n\\n**Technical.** Stablecoin contracts are excluded from this category.\\n\\n**Interpretation.** A rising share means ERC-20 token activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumErc20Relative?a=ETH)\n","operationId":"fees.GasUsedSumErc20Relative","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"}}}}}}}}}
```
## Gas Usage by NFTs (Absolute)
> \*\*Definition.\*\* The total amount of Ethereum network gas consumed by transactions interacting with non-fungible tokens. This category includes both NFT token contract standards (ERC721, ERC1155) and NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) used to trade them.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_nfts":{"get":{"summary":"Gas Usage by NFTs (Absolute)","description":"**Definition.** The total amount of Ethereum network gas consumed by transactions interacting with non-fungible tokens. This category includes both NFT token contract standards (ERC721, ERC1155) and NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) used to trade them.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumNfts?a=ETH)\n","operationId":"fees.GasUsedSumNfts","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"}}}}}}}}}
```
## Gas Usage by NFTs (Relative)
> \*\*Definition.\*\* The share of Ethereum gas consumed by transactions interacting with non-fungible tokens. The category includes both NFT token-contract standards (ERC-721, ERC-1155) and the NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) where those tokens trade.\n\n\*\*Interpretation.\*\* A rising share means NFT activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_nfts_relative":{"get":{"summary":"Gas Usage by NFTs (Relative)","description":"**Definition.** The share of Ethereum gas consumed by transactions interacting with non-fungible tokens. The category includes both NFT token-contract standards (ERC-721, ERC-1155) and the NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) where those tokens trade.\\n\\n**Interpretation.** A rising share means NFT activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or the underlying activity contracted.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumNftsRelative?a=ETH)\n","operationId":"fees.GasUsedSumNftsRelative","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"}}}}}}}}}
```
## Gas Usage by Stablecoins (Absolute)
> \*\*Definition.\*\* The total amount of gas consumed by the Ethereum network by stablecoin transactions. Stablecoins are fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_stablecoins":{"get":{"summary":"Gas Usage by Stablecoins (Absolute)","description":"**Definition.** The total amount of gas consumed by the Ethereum network by stablecoin transactions. Stablecoins are fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumStablecoins?a=ETH)\n","operationId":"fees.GasUsedSumStablecoins","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"}}}}}}}}}
```
## Gas Usage by Stablecoins (Relative)
> \*\*Definition.\*\* The share of Ethereum gas consumed by stablecoin transactions. Stablecoins are fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\n\n\*\*Interpretation.\*\* A rising share means dollar-rail activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or contracted.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_stablecoins_relative":{"get":{"summary":"Gas Usage by Stablecoins (Relative)","description":"**Definition.** The share of Ethereum gas consumed by stablecoin transactions. Stablecoins are fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\\n\\n**Interpretation.** A rising share means dollar-rail activity outbid other categories for finite Ethereum blockspace, a falling share means it was outbid or contracted.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumStablecoinsRelative?a=ETH)\n","operationId":"fees.GasUsedSumStablecoinsRelative","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"}}}}}}}}}
```
## Gas Usage by Transaction Type (Absolute)
> \*\*Definition.\*\* The total amount of gas consumed by the Ethereum network by transaction category. Transactions are classified into the following categories:\n\n- \*Vanilla:\* Pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\n- \*ERC20:\* Transactions calling ERC-20 contracts. Contracts in the Stablecoins category are excluded here.\n- \*Stablecoins:\* Fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\n- \*DeFi:\* On-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs). The category includes 90+ DeFi protocols such as Uniswap, Etherdelta, 1inch, Sushiswap, Aave, and 0x.\n- \*Bridges:\* Contracts allowing transfer of tokens between different blockchains. The category includes 50+ bridges such as Ronin, Polygon, Optimism, and Arbitrum.\n- \*NFTs:\* Transactions interacting with non-fungible tokens. The category includes both token-contract standards (ERC-721, ERC-1155) and NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) for trading them.\n- \*MEV Bots:\* Miner Extractable Value (MEV) bots execute transactions for profit by reordering, inserting, and censoring transactions within blocks.\n- \*Other:\* All other Ethereum transactions not included in the categories above.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/tx_types_breakdown_sum":{"get":{"summary":"Gas Usage by Transaction Type (Absolute)","description":"**Definition.** The total amount of gas consumed by the Ethereum network by transaction category. Transactions are classified into the following categories:\\n\\n- *Vanilla:* Pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\\n- *ERC20:* Transactions calling ERC-20 contracts. Contracts in the Stablecoins category are excluded here.\\n- *Stablecoins:* Fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\\n- *DeFi:* On-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs). The category includes 90+ DeFi protocols such as Uniswap, Etherdelta, 1inch, Sushiswap, Aave, and 0x.\\n- *Bridges:* Contracts allowing transfer of tokens between different blockchains. The category includes 50+ bridges such as Ronin, Polygon, Optimism, and Arbitrum.\\n- *NFTs:* Transactions interacting with non-fungible tokens. The category includes both token-contract standards (ERC-721, ERC-1155) and NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) for trading them.\\n- *MEV Bots:* Miner Extractable Value (MEV) bots execute transactions for profit by reordering, inserting, and censoring transactions within blocks.\\n- *Other:* All other Ethereum transactions not included in the categories above.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.TxTypesBreakdownSum?a=ETH)\n","operationId":"fees.TxTypesBreakdownSum","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"}}}}}}}}}
```
## Gas Usage by Transaction Type (Relative)
> \*\*Definition.\*\* The share of Ethereum gas consumed by transaction category. Transactions are classified into one of the following categories:\n\n- \*Vanilla:\* Pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\n- \*ERC20:\* Transactions calling ERC-20 contracts. Contracts in the Stablecoins category are excluded here.\n- \*Stablecoins:\* Fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\n- \*DeFi:\* On-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs). The category includes 90+ DeFi protocols such as Uniswap, Etherdelta, 1inch, Sushiswap, Aave, and 0x.\n- \*Bridges:\* Contracts allowing transfer of tokens between different blockchains. The category includes 50+ bridges such as Ronin, Polygon, Optimism, and Arbitrum.\n- \*NFTs:\* Transactions interacting with non-fungible tokens. The category includes both token-contract standards (ERC-721, ERC-1155) and NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) for trading them.\n- \*MEV Bots:\* Miner Extractable Value (MEV) bots execute transactions for profit by reordering, inserting, and censoring transactions within blocks.\n- \*Other:\* All other Ethereum transactions not included in the categories above.\n\n\*\*Interpretation.\*\* Shares sum to one across categories, so a rising line necessarily implies a falling line elsewhere. A category\'s share rises when it outbids the rest of the platform for finite Ethereum blockspace.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/tx_types_breakdown_relative":{"get":{"summary":"Gas Usage by Transaction Type (Relative)","description":"**Definition.** The share of Ethereum gas consumed by transaction category. Transactions are classified into one of the following categories:\\n\\n- *Vanilla:* Pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\\n- *ERC20:* Transactions calling ERC-20 contracts. Contracts in the Stablecoins category are excluded here.\\n- *Stablecoins:* Fungible tokens whose value is pegged to an off-chain asset, either by the issuer or by an algorithm. The category includes 150+ stablecoins, with USDT, USDC, UST, BUSD, and DAI the most prominent.\\n- *DeFi:* On-chain financial instruments and protocols implemented as smart contracts, including decentralized exchanges (DEXs). The category includes 90+ DeFi protocols such as Uniswap, Etherdelta, 1inch, Sushiswap, Aave, and 0x.\\n- *Bridges:* Contracts allowing transfer of tokens between different blockchains. The category includes 50+ bridges such as Ronin, Polygon, Optimism, and Arbitrum.\\n- *NFTs:* Transactions interacting with non-fungible tokens. The category includes both token-contract standards (ERC-721, ERC-1155) and NFT marketplaces (OpenSea, Blur, LooksRare, Rarible, SuperRare) for trading them.\\n- *MEV Bots:* Miner Extractable Value (MEV) bots execute transactions for profit by reordering, inserting, and censoring transactions within blocks.\\n- *Other:* All other Ethereum transactions not included in the categories above.\\n\\n**Interpretation.** Shares sum to one across categories, so a rising line necessarily implies a falling line elsewhere. A category's share rises when it outbids the rest of the platform for finite Ethereum blockspace.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.TxTypesBreakdownRelative?a=ETH)\n","operationId":"fees.TxTypesBreakdownRelative","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"}}}}}}}}}
```
## Gas Usage by Vanilla Transactions (Absolute)
> \*\*Definition.\*\* The total amount of gas consumed by the Ethereum network by vanilla transactions. Vanilla transactions are pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\n\n\*\*Technical.\*\* The value of the latest datapoint can shift slightly as some addresses initially transact as vanilla before their associated smart-contract deployment is observed and reclassified.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_vanilla":{"get":{"summary":"Gas Usage by Vanilla Transactions (Absolute)","description":"**Definition.** The total amount of gas consumed by the Ethereum network by vanilla transactions. Vanilla transactions are pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\\n\\n**Technical.** The value of the latest datapoint can shift slightly as some addresses initially transact as vanilla before their associated smart-contract deployment is observed and reclassified.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumVanilla?a=ETH)\n","operationId":"fees.GasUsedSumVanilla","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"}}}}}}}}}
```
## Gas Usage by Vanilla Transactions (Relative)
> \*\*Definition.\*\* The share of Ethereum gas consumed by vanilla transactions. Vanilla transactions are pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\n\n\*\*Technical.\*\* The value of the latest datapoint can shift slightly as some addresses initially transact as vanilla before their associated smart-contract deployment is observed and reclassified.\n\n\*\*Interpretation.\*\* A rising share means plain ETH-transfer activity claimed more of finite Ethereum blockspace relative to contract-mediated categories, a falling share means it was displaced by them.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum_vanilla_relative":{"get":{"summary":"Gas Usage by Vanilla Transactions (Relative)","description":"**Definition.** The share of Ethereum gas consumed by vanilla transactions. Vanilla transactions are pure ETH transfers between externally owned accounts (EOAs) with no contract calls.\\n\\n**Technical.** The value of the latest datapoint can shift slightly as some addresses initially transact as vanilla before their associated smart-contract deployment is observed and reclassified.\\n\\n**Interpretation.** A rising share means plain ETH-transfer activity claimed more of finite Ethereum blockspace relative to contract-mediated categories, a falling share means it was displaced by them.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSumVanillaRelative?a=ETH)\n","operationId":"fees.GasUsedSumVanillaRelative","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"}}}}}}}}}
```
## Gas Used (Mean)
> \*\*Definition.\*\* The mean amount of gas used per transaction.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_mean":{"get":{"summary":"Gas Used (Mean)","description":"**Definition.** The mean amount of gas used per transaction.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedMean?a=ETH)\n","operationId":"fees.GasUsedMean","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"}}}}}}}}}
```
## Gas Used (Median)
> \*\*Definition.\*\* The median amount of gas used per transaction.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_median":{"get":{"summary":"Gas Used (Median)","description":"**Definition.** The median amount of gas used per transaction.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedMedian?a=ETH)\n","operationId":"fees.GasUsedMedian","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"}}}}}}}}}
```
## Gas Used (Total)
> \*\*Definition.\*\* The total amount of gas used across all transactions.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_used_sum":{"get":{"summary":"Gas Used (Total)","description":"**Definition.** The total amount of gas used across all transactions.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasUsedSum?a=ETH)\n","operationId":"fees.GasUsedSum","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"}}}}}}}}}
```
## Transaction Gas Limit (Mean)
> \*\*Definition.\*\* The mean gas limit per transaction.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_limit_tx_mean":{"get":{"summary":"Transaction Gas Limit (Mean)","description":"**Definition.** The mean gas limit per transaction.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasLimitTxMean?a=ETH)\n","operationId":"fees.GasLimitTxMean","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"}}}}}}}}}
```
## Transaction Gas Limit (Median)
> \*\*Definition.\*\* The median gas limit per transaction.\n\
> \
> \[View in Studio]\()
```json
{"openapi":"3.0.3","info":{"title":"Glassnode API - fees","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/fees/gas_limit_tx_median":{"get":{"summary":"Transaction Gas Limit (Median)","description":"**Definition.** The median gas limit per transaction.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/fees.GasLimitTxMedian?a=ETH)\n","operationId":"fees.GasLimitTxMedian","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"}}}}}}}}}
```
---
# 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/fees.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.