Get Gas Fee
Returns a network's current gas price at three confirmation speeds (safe, propose, fast), from the gas oracle of the network's chain family (the Etherscan gas oracle for EVM networks). Prices are decimal strings in the network's native currency per unit of gas, not in Gwei: multiply by 1000000000 to get Gwei.
A quote is reused per network for 15 seconds, so updated_at (when the quote was read from the oracle) can be up to 15 seconds older than the response. To receive quotes as they change instead of polling, subscribe to the real-time gas fee channel.
The endpoint requires authentication like the rest of the chain layer: every quote spends the platform's gas-oracle allowance.
Required permission: node:summary:view
Request
GET /v2/blockchain/gas-fee?network_id={network_id}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
network_id | integer | query | Required. EVM chain id of the network (e.g. 137 for Polygon), greater than 0. This is the network_id field of a Get Networks row, not its id. There is no default network |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Example
curl --request GET \
--url '{{baseUrl}}/v2/blockchain/gas-fee?network_id=137' \
--header 'Authorization: Bearer <access_token>'
Response
{
"network_id": 137,
"safe_gas_price": "0.00000003",
"propose_gas_price": "0.000000031",
"fast_gas_price": "0.000000035",
"native_currency_symbol": "POL",
"updated_at": "2026-11-09T10:15:42.318274Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
network_id | integer | EVM chain id of the quoted network |
safe_gas_price | string | Gas price for a slow, low-cost confirmation, in native currency per gas |
propose_gas_price | string | Gas price for a standard confirmation, in native currency per gas |
fast_gas_price | string | Gas price for a fast confirmation, in native currency per gas |
native_currency_symbol | string | Native currency the prices are expressed in (e.g. POL, ETH) |
updated_at | string | ISO 8601 time the quote was read from the oracle |
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | network_id is missing or not greater than 0 (see details), or is not a number |
| 400 | 10015 | No network in the catalog has this EVM chain id (message network not found), or the network has no chain (message network has no chain) |
| 400 | 21001 | The network's chain has no gas price provider (domain 12). Only EVM networks are quoted today |
| 400 | 21002 | The oracle answered a price that is not a positive decimal (domain 12) |
| 400 | 10000 | The oracle refused the request, for example because it does not serve this network or its rate limit was hit. The message starts with etherscan gas oracle |
| 500 | 10000 / -1 | The oracle answered with an HTTP error (10000) or could not be reached (-1) |
See Errors for the error format and common codes.