Beta — PolyNode RPC is in early access.
Overview
PolyNode’s Gas Oracle scans every block on Polygon to determine the exact gas price needed to achieve top-of-block positioning. Unlike standard eth_gasPrice which returns a network average, our oracle tells you what the competitive floor is — what the top-of-block bots are actually paying.
Endpoint
GET https://rpc.polynode.dev/v1/gas
Response
{
"recommendation": {
"recommended_gas_wei": 1986123386877,
"recommended_gas_gwei": 1986.1,
"avg_top_gas_gwei": 1547.4,
"max_top_gas_gwei": 1805.6,
"blocks_scanned": 20,
"safety_multiplier": 1.1,
"base_gas_gwei": 111.4,
"effective_multiplier": 17.8
},
"recent_blocks": [
{
"block_number": 84210810,
"top_gas_gwei": 1804.6,
"second_gas_gwei": 1804.6,
"median_gas_gwei": 168.5,
"tx_count": 252
}
]
}
Fields
| Field | Description |
|---|
recommended_gas_wei | Gas price in wei to beat current top-of-block competition |
recommended_gas_gwei | Same value in gwei for readability |
avg_top_gas_gwei | Average highest gas price across scanned blocks |
max_top_gas_gwei | Maximum top-of-block gas price observed |
blocks_scanned | Number of recent blocks analyzed |
safety_multiplier | Multiplier applied above max observed (default 1.1x) |
base_gas_gwei | Current network base gas price |
effective_multiplier | How many times above base gas the recommendation is |
Per-Block Data
The recent_blocks array provides gas data for each scanned block:
| Field | Description |
|---|
top_gas_gwei | Highest gas price in the block (TX #1) |
second_gas_gwei | Second highest gas price |
median_gas_gwei | Median gas price across all transactions |
tx_count | Total transactions in the block |
Usage
Use the gas oracle to set your transaction’s gas price for optimal block positioning:
import requests
# Get current recommendation
resp = requests.get('https://rpc.polynode.dev/v1/gas')
data = resp.json()
# Use recommended gas price for TX #1
gas_price = data['recommendation']['recommended_gas_wei']
# Build your transaction with this gas price
tx = {
'gasPrice': gas_price,
# ... rest of your transaction
}
Refresh Rate
The gas oracle updates every 30 seconds, scanning the most recent 20 blocks. Data reflects real-time market conditions on Polygon.
