GET
$0.0011 default
/v1/base/gasDescription
Base gas oracle / gas price API for AI agents and bots — get the gas price for a transaction on Base in one x402 call. Real-time slow/standard/fast EIP-1559 fee tiers from a live eth_feeHistory call, returned as DROP-IN maxFeePerGas + maxPriorityFeePerGas in wei — plug straight into a viem/ethers transaction, no gwei conversion. Plus base fee, head block, and network fullness. Call it before every Base tx to set a fair fee or wait out congestion.
Pricing
$0.0011 default
Parameters
{
"properties": {
"blocks": {
"description": "Recent blocks to sample for percentile reward (1..50, clamped). Wider = smoother tiers, narrower = more reactive.",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"blocks"
],
"type": "object"
}Example response
{
"base_fee_gwei": 0.0042,
"base_fee_wei": "4200000",
"block_number": 16842103,
"network": "base-mainnet",
"stats": {
"blocks_sampled": 20,
"median_fullness_pct": 31.5,
"ts": "2026-05-28T15:42:30.000Z"
},
"tiers": {
"fast": {
"maxFeePerGas": "16300000",
"maxPriorityFeePerGas": "10000000",
"max_fee_gwei": 0.0163,
"max_priority_gwei": 0.01
},
"slow": {
"maxFeePerGas": "8300000",
"maxPriorityFeePerGas": "2000000",
"max_fee_gwei": 0.0083,
"max_priority_gwei": 0.002
},
"standard": {
"maxFeePerGas": "10300000",
"maxPriorityFeePerGas": "4000000",
"max_fee_gwei": 0.0103,
"max_priority_gwei": 0.004
}
}
}