Gas Fees

Ethereum Gas Fees API documentation

The /eth/v1/gasfees API returns an estimate of the next block gas fees in Gwei.

It determines this based on the calculated next block base fee and a linear regression prediction based on the last 5 blocks of fees.

Get Gas Fee Estimates

GET https://data.spiceai.io/eth/v1/gasfees

Returns an estimate of the next block Ethereum gas fees.

Query Parameters

Name	Type	Description
api_key	String	API key for higher rate limits.

200 Gas fees successfully returned.

{
	"time": 1641347300,
	"lastBlock": 13942618,
	"nextBlockBaseFee": 74.813667468,
	"slow": 82,
	"normal": 83,
	"fast": 85,
	"instant": 88
}

429: Too Many Requests Rate limit exceeded. Higher rate limits can be obtained using an API key.

{
    "message": "Rate limit exceeded."
}

The /eth/v1/gasfees?price=usd API returns an estimate of the next block gas fees in Gwei and the current price in the specified currency or token.

Get Gas Fee Estimates With Price

GET https://data.spiceai.io/eth/v1/gasfees?price=usd

Returns an estimate of the next block Ethereum gas fees with price in the given currency or token.

Query Parameters

Name	Type	Description
api_key	String	API key for higher rate limits.
price*	String	Currency or token for pricing conversion. Currently support USD.

200: OK Gas fees successfully returned.

{
	"time": 1641347526,
	"lastBlock": 13942641,
	"nextBlockBaseFee": 112.651926799,
	"ethPrice": 3794.462922013826,
	"slow": {
		"gwei": 116,
		"price": 9.205630794448966
	},
	"normal": {
		"gwei": 110,
		"price": 8.772699898734457
	},
	"fast": {
		"gwei": 105,
		"price": 8.351644878832529
	},
	"instant": {
		"gwei": 15,
		"price": 1.1621249972558882
	}
}

429: Too Many Requests Rate limit exceeded. Higher rate limits can be obtained using an API key.

{
    // Response
}

The /eth/v1/gasfees?period=1d API returns the historical gas used ratio and gas fees by block over the specified time period. If a period is not specified, it will default to 24 hours.

Get Historical Gas Used and Fees by Block

GET https://data.spiceai.io/eth/v1/gasfees?period=1d

Returns historical gas used and fees over time.

One of start or period is required.

Query Parameters

Name	Type	Description
api_key	String	API key for higher rate limits.
start	String	The beginning of the historical period. Will default to 24h ago if not provided.
period	String	The period specified as a Duration Literal . E.g. 5d. If not specified, will default from start until now, or 24 hours if start is also not provided.
granularity	String	The granularity of aggregation specified as a Duration Literal . E.g. 1d. If not specified, fees per block will be provided.

200: OK Gas fees successfully returned.

[
	{
		"time": 1638389086,
		"gasUsedRatio": 0.6453722692350096,
		"slow": 7,
		"normal": 32,
		"fast": 41,
		"instant": 68
	},
	{
		"time": 1638389108,
		"gasUsedRatio": 0.32565033107924796,
		"slow": 7,
		"normal": 24,
		"fast": 40,
		"instant": 205
	},
	{
		"time": 1638389118,
		"gasUsedRatio": 0.22219037765676844,
		"slow": 7,
		"normal": 38,
		"fast": 40,
		"instant": 72
	},
	{
		"time": 1638389126,
		"gasUsedRatio": 0.6348086333333334,
		"slow": 9,
		"normal": 35,
		"fast": 41,
		"instant": 51
	},
	{
		"time": 1638389140,
		"gasUsedRatio": 0.11676238513575173,
		"slow": 11,
		"normal": 11,
		"fast": 22,
		"instant": 79
	}
]

429: Too Many Requests Rate limit exceeded. Higher rate limits can be obtained using an API key.

{
    // Response
}

The /eth/v1/gasfees?period=1w&granularity=1d API returns the historical gas used ratio and gas fees by time granularity over the specified time period. If a period is not specified, it will default to 24 hours.

Get Historical Gas Used and Fees by Time Granularity

GET https://data.spiceai.io/eth/v1/gasfees?period=7d&granularity=1d

Returns historical gas used and fees over time.

One of start or period is required. granularity is required.

Query Parameters

Name	Type	Description
api_key	String	API key for higher rate limits.
start	String	The beginning of the historical period. Will default to 24h ago if not provided.
period	String	The period specified as a Duration Literal . E.g. 5d. If not specified, will default from start until now, or 24 hours if start is also not provided.
granularity*	String	The granularity of aggregation specified as a Duration Literal . E.g. 1d. If not specified, fees per block will be provided.

200: OK Gas fees successfully returned.

[
	{
		"time": 1638389086,
		"gasUsedRatio": 0.6453722692350096,
		"slow": 7,
		"normal": 32,
		"fast": 41,
		"instant": 68
	},
	{
		"time": 1638389108,
		"gasUsedRatio": 0.32565033107924796,
		"slow": 7,
		"normal": 24,
		"fast": 40,
		"instant": 205
	},
	{
		"time": 1638389118,
		"gasUsedRatio": 0.22219037765676844,
		"slow": 7,
		"normal": 38,
		"fast": 40,
		"instant": 72
	},
	{
		"time": 1638389126,
		"gasUsedRatio": 0.6348086333333334,
		"slow": 9,
		"normal": 35,
		"fast": 41,
		"instant": 51
	},
	{
		"time": 1638389140,
		"gasUsedRatio": 0.11676238513575173,
		"slow": 11,
		"normal": 11,
		"fast": 22,
		"instant": 79
	}
]

429: Too Many Requests Rate limit exceeded. Higher rate limits can be obtained using an API key.

{
    // Response
}