Gas

Hourly gas statistics combining block-level signals (base fee, utilization) with transaction-level tip distribution (priority fee percentiles, zero-tip ratio). Useful for building fee estimators, congestion dashboards, and "best time to transact" heuristics.

Get Hourly Gas Stats

Return hourly aggregated gas statistics for a given chain.

⚠️

The date range between from and to must not exceed 90 days.

curl -X GET \
  "https://api.misti.app/v1/gas/blocks/hourly \
    ?chain_id=1 \
    &from=2025-01-01 \
    &to=2025-01-07" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:

Parameter	Type	Required	Description
`chain_id`	`number`	Yes	The EVM chain ID (e.g., `1` for Ethereum mainnet). Table chain id
`from`	`string`	No	Start date in `YYYY-MM-DD` format
`to`	`string`	No	End date in `YYYY-MM-DD` format

Headers:

Header	Description
`x-api-key`	Your API key (`msk_…`)

Response:

[
    {
        "hour": "2025-01-01T00:00:00Z",
        "block_count": 300,
        "avg_base_fee": "12345678901",
        "avg_gas_used": "15000000",
        "avg_gas_limit": "30000000",
        "utilization": 0.5,
        "tx_count": "45000",
        "avg_block_priority_fee_min": "0",
        "avg_block_priority_fee_max": "5000000000",
        "avg_priority_fee_top5_threshold": "2500000000",
        "avg_priority_fee_top5_avg": "3200000000",
        "avg_priority_fee_top10_threshold": "1800000000",
        "avg_priority_fee_top10_avg": "2400000000",
        "zero_tip_ratio": 0.08
    }
]

Block-level Fields:

Field	Type	Description
`hour`	`string`	The hour bucket (ISO 8601 timestamp, UTC)
`block_count`	`number`	Number of blocks produced during the hour
`avg_base_fee`	`string`	Average base fee per gas across blocks in the hour (wei)
`avg_gas_used`	`string`	Average gas used per block in the hour
`avg_gas_limit`	`string`	Average gas limit per block in the hour
`utilization`	`number`	Average block utilization ratio (`gas_used / gas_limit`)

Transaction-level Fields:

These fields summarize the priority fee (tip) distribution paid by transactions included in each block, averaged over all blocks in the hour. Tip is computed as effective_gas_price - base_fee_per_gas and is expressed in wei.

Field	Type	Description
`tx_count`	`string`	Total number of transactions included across all blocks in the hour
`avg_block_priority_fee_min`	`string`	Per-block minimum priority fee, averaged across blocks (wei)
`avg_block_priority_fee_max`	`string`	Per-block maximum priority fee, averaged across blocks (wei)
`avg_priority_fee_top5_threshold`	`string`	Priority fee needed to enter the top 5% of tips in a block, averaged across blocks (wei)
`avg_priority_fee_top5_avg`	`string`	Average priority fee paid by the top 5% of transactions in a block, averaged across blocks (wei)
`avg_priority_fee_top10_threshold`	`string`	Priority fee needed to enter the top 10% of tips in a block, averaged across blocks (wei)
`avg_priority_fee_top10_avg`	`string`	Average priority fee paid by the top 10% of transactions in a block, averaged across blocks (wei)
`zero_tip_ratio`	`number`	Fraction of transactions in the hour that paid a zero priority fee (`0` to `1`)

ℹ️

Priority fees are returned in wei. Divide by 1e9 to convert to gwei for display. A top5_threshold of 2500000000 means you needed a tip of at least 2.5 gwei to land in the top 5% of transactions in that block.

First Call API Tokens