Skip to main content

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

0.01 credits per call

eth_feeHistory on Ethereum: Returns historical fee market data over a range of blocks.

Endpoint

https://rpc.goldrushdata.com/v1/eth-mainnet
Authenticate with Authorization: Bearer <YOUR_GOLDRUSH_API_KEY>. See authentication.

Parameters

NameTypeRequiredDescriptionExample
blockCountQUANTITYyesHex-encoded number of blocks to inspect (max 1024)."0x4"
newestBlockQUANTITY | TAGyesHighest block to include."latest"
rewardPercentilesArray<Number>noReward percentiles to compute. Empty array skips reward computation.[25, 50, 75]

Returns

Object: {oldestBlock, baseFeePerGas[], gasUsedRatio[], reward[][]}
{"oldestBlock":"0x14a3b89","baseFeePerGas":["0x3b9aca00"],"gasUsedRatio":[0.42]}

Examples

curl https://rpc.goldrushdata.com/v1/eth-mainnet \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_feeHistory",
    "params": ["0x4", "latest", [25, 50, 75]]
  }'

Errors

Standard JSON-RPC errors: -32600 invalid request, -32601 method not found, -32602 invalid params.

Also available on