Gas Endpoints

Overview

This section describes Anyblock gas endpoints. Each of them returns a JSON object with the corresponding gas metrics for all Ethereum-based networks we serve.

Gas is the unit measuring the amount of computational effort that is required to conduct a transaction or execute a contract on the Ethereum blockchain platform. Gas prices are denoted in Gwei, which are small fractions of the cryptocurrency Ether (ETH).

gasprice (Gas Fee Estimates)

GET /{technology}/{blockchain}/{network}/gasprice
GET /{technology}/{blockchain}/{network}/latest-minimum-gasprice (alias, deprecated)

As shown in the sections below, the calculation method and the output depend on whether a given network supports Ethereum’s EIP-1559 update.

EIP-1559 Networks

For the networks supporting the EIP-1559 update, our endpoint outputs the estimated priority fee, maximum priority fee, and effective gas price as well as other metrics.

Depending on the metric, the latest 20 or 200 blocks are taken into account for the calculation.

A sample query (Ethereum Mainnet):

https://api.anyblock.tools/ethereum/ethereum/mainnet/gasprice

The output:

{
    "health": true,
    "blockNumber": 13556603,
    "blockTime": 14.28643216080402,
    "slow": 102.41,
    "standard": 113.923499284,
    "fast": 136.074253706,
    "instant": 173.935867462,
    "latestBlockBaseFee": 111.176308673,
    "latestBlockMinFee": 111.176308673,
    "eip1559": {
        "slow": {
            "probability": "30%",
            "priorityFee": 0,
            "maxFee": 222.352617346
        },
        "standard": {
            "probability": "60%",
            "priorityFee": 1,
            "maxFee": 223.352617346
        },
        "fast": {
            "probability": "90%",
            "priorityFee": 1.5,
            "maxFee": 223.852617346
        },
        "faster": {
            "probability": "96%",
            "priorityFee": 2,
            "maxFee": 224.352617346
        },
        "instant": {
            "probability": "99%",
            "priorityFee": 3,
            "maxFee": 225.352617346
        }
    }
}

Output fields:

Legacy Networks

For the networks not supporting the EIP-1559 update, our endpoint outputs the estimated gas price as well as other metrics.

The latest 200 blocks are taken into account for the calculation.

A sample query (Ethereum POA xDai):

https://api.anyblock.tools/ethereum/poa/xdai/gasprice

The output:

{
	"health": true,
	"blockNumber": 18964666,
	"blockTime": 5,
	"slow": 1,
	"standard": 1,
	"fast": 1.219999999,
	"instant": 1.219999999
}

Output fields:

gasprice (Address History)

GET /{technology}/{blockchain}/{network}/{address}/gasprice

This endpoint retrieves the gas price statistics for a given destination contract address and triple of technology, blockchain, and network.

A maximum of 1000 transactions is taken into account for the calculation.
To use this endpoint, you need to specify the destination contract address, for example: 0x89d24A6b4CcB1B6fAA2625fE562bDD9a23260359

A sample query (Ethereum Mainnet):

https://api.anyblock.tools/ethereum/ethereum/mainnet/0x89d24A6b4CcB1B6fAA2625fE562bDD9a23260359/gasprice

The output:

{
   	"mean": 10.328411770318,
   	"median": 8,
   	"percentile95": 25,
   	"min": 1,
   	"max": 198.4
}

Output fields:

gasusage (Address History)

GET /{technology}/{blockchain}/{network}/{address}/gasusage

This endpoint retrieves the gas usage statistics for a given destination contract address and triple of technology, blockchain, and network.

A maximum of 1000 transactions is taken into account for the calculation.

To use this endpoint, you need to specify the destination contract address, for example: 0x89d24A6b4CcB1B6fAA2625fE562bDD9a23260359

A sample query (Ethereum Mainnet):

https://api.anyblock.tools/ethereum/ethereum/mainnet/0x89d24A6b4CcB1B6fAA2625fE562bDD9a23260359/gasusage

The output:

{
   	"mean": 41177.621,
   	"median": 45273,
   	"percentile95": 52426,
   	"min": 14945,
   	"max": 53406
}

Output fields: