For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fees

Exchange Fee Dominance

get

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\nTechnical. 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.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/exchanges_relative
GET /v1/metrics/fees/exchanges_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Fees (Mean)

get

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\nTechnical. 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.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/exchanges_mean
GET /v1/metrics/fees/exchanges_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Fees (Total)

get

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\nTechnical. 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.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/exchanges_sum
GET /v1/metrics/fees/exchanges_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Fee Ratio Multiple (FRM)

get

Definition. Fee Ratio Multiple (FRM) is the ratio between total miner revenue (block rewards plus transaction fees) and transaction fees alone.\n\nInterpretation. 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\nNotes. Introduced by Matteo Leibowitz. For more information, see his introduction to the Fee Ratio Multiple (FRM).\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/fee_ratio_multiple
GET /v1/metrics/fees/fee_ratio_multiple?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Fees (Mean)

get

Definition. The mean fee paid per transaction.\n\nTechnical. Issued (minted) coins are not included.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/volume_mean
GET /v1/metrics/fees/volume_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Fees (Median)

get

Definition. The median fee paid per transaction.\n\nTechnical. Issued (minted) coins are not included.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/volume_median
GET /v1/metrics/fees/volume_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Fees (Total)

get

Definition. The total amount of fees paid to miners.\n\nTechnical. Issued (minted) coins are not included.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/volume_sum
GET /v1/metrics/fees/volume_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Price (Mean)

get

Definition. The mean gas price paid per transaction.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_price_mean
GET /v1/metrics/fees/gas_price_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Price (Median)

get

Definition. The median gas price paid per transaction.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_price_median
GET /v1/metrics/fees/gas_price_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Bridges (Absolute)

get

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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_bridges
GET /v1/metrics/fees/gas_used_sum_bridges?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Bridges (Relative)

get

Definition. The share of total Ethereum network gas consumed by contracts that allow transfer of tokens between different blockchains.\n\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_bridges_relative
GET /v1/metrics/fees/gas_used_sum_bridges_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by DeFi (Absolute)

get

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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_defi
GET /v1/metrics/fees/gas_used_sum_defi?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by DeFi (Relative)

get

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\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_defi_relative
GET /v1/metrics/fees/gas_used_sum_defi_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by ERC-20 Tokens (Absolute)

get

Definition. The total amount of Ethereum network gas consumed by transactions calling ERC-20 contracts.\n\nTechnical. Stablecoin contracts are excluded from this category.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_erc20
GET /v1/metrics/fees/gas_used_sum_erc20?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by ERC-20 Tokens (Relative)

get

Definition. The share of total Ethereum network gas consumed by transactions calling ERC-20 contracts.\n\nTechnical. Stablecoin contracts are excluded from this category.\n\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_erc20_relative
GET /v1/metrics/fees/gas_used_sum_erc20_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by NFTs (Absolute)

get

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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_nfts
GET /v1/metrics/fees/gas_used_sum_nfts?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by NFTs (Relative)

get

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\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_nfts_relative
GET /v1/metrics/fees/gas_used_sum_nfts_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Stablecoins (Absolute)

get

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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_stablecoins
GET /v1/metrics/fees/gas_used_sum_stablecoins?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Stablecoins (Relative)

get

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\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_stablecoins_relative
GET /v1/metrics/fees/gas_used_sum_stablecoins_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Transaction Type (Absolute)

get

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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/tx_types_breakdown_sum
GET /v1/metrics/fees/tx_types_breakdown_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Transaction Type (Relative)

get

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\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/tx_types_breakdown_relative
GET /v1/metrics/fees/tx_types_breakdown_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Vanilla Transactions (Absolute)

get

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\nTechnical. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_vanilla
GET /v1/metrics/fees/gas_used_sum_vanilla?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Usage by Vanilla Transactions (Relative)

get

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\nTechnical. 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\nInterpretation. 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

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum_vanilla_relative
GET /v1/metrics/fees/gas_used_sum_vanilla_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Used (Mean)

get

Definition. The mean amount of gas used per transaction.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_mean
GET /v1/metrics/fees/gas_used_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Used (Median)

get

Definition. The median amount of gas used per transaction.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_median
GET /v1/metrics/fees/gas_used_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gas Used (Total)

get

Definition. The total amount of gas used across all transactions.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_used_sum
GET /v1/metrics/fees/gas_used_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Transaction Gas Limit (Mean)

get

Definition. The mean gas limit per transaction.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_limit_tx_mean
GET /v1/metrics/fees/gas_limit_tx_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Transaction Gas Limit (Median)

get

Definition. The median gas limit per transaction.\n

View in Studio

Authorizations
api_keystringRequired

Your Glassnode API key

Query parameters
astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h, 1w, 1month

fstring · enumOptional

format - csv, json

Default: jsonPossible values:
timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:
Responses
200

Successful response

application/json
tinteger · int64Optional

Unix timestamp

Example: 1726790400
vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077
numberOptional
or
objectOptional
or
arrayOptional
get/v1/metrics/fees/gas_limit_tx_median
GET /v1/metrics/fees/gas_limit_tx_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Last updated