Gas Oracle - PolyNode

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.