Skip to main content

v1/{chainName}/event/{eventType}/gas_prices/ REST API Endpoint

Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transaction costs and confirmation times.

Updated on
Jan 09, 2025

v1/{chainName}/event/{eventType}/gas_prices/ REST API Endpoint

Path Parameters

chainName
string
The blockchain name for which data is being queried (e.g., eth-mainnet, bsc)
eventType
string
The type of event being queried. Supports erc20 transfer events, uniswapv3 swap events and nativetokens transfers

Query Parameters

quote-currency
string
The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP

Returns

data
object
The main response object containing gas price details and metadata
updated_at
string
The timestamp of the last update in ISO 8601 format
chain_id
integer
The unique identifier for the blockchain (e.g., 1 for Ethereum)
chain_name
string
The name of the blockchain (e.g., eth-mainnet)
event_type
string
The type of event queried (e.g., uniswapv3)
gas_quote_rate
integer
The gas price in the quoted currency
quote_currency
string
The currency in which gas prices are quoted (e.g., USD)
base_fee
string
The base fee for gas in wei
items
array
An array of gas price details for specific intervals
gas_price
string
The gas price in wei for the specific interval
gas_spent
string
The amount of gas spent during the specific interval
gas_quote
integer
The cost of the gas in the quoted currency
other_fees
object
Additional fees incurred during the transaction
l1_gas_quote
string
The Layer 1 gas quote, if applicable
total_gas_quote
integer
The total cost of gas in the quoted currency
pretty_total_gas_quote
string
The total gas cost in a human-readable format
interval
string
The time interval for which the gas price data applies
error
boolean
Indicates whether there was an error in the response
error_message
string
The error message, if any
error_code
integer
The error code, if any
Request
1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/event/uniswapv3/gas_prices/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free