Parameters

blockCount

string/integer

REQUIRED

The number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. It will return less than the requested range if not all blocks are available

newestBlock

string

REQUIRED

The highest number block of the requested range in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

rewardPercentiles

integer

REQUIRED

A list of percentile values with a monotonic increase in value. The transactions will be ranked by effective tip per gas for each block in the requested range, and the corresponding effective tip for the percentile will be calculated while taking gas consumption into consideration

Returns

oldestBlock

string

The lowest number block of the returned range encoded in hexadecimal format

baseFeePerGas

array

An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks

baseFeePerBlobGas

array

An array of block base fees per blob gas. This includes the next block after the newest of the returned range.

gasUsedRatio

array

An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit

blobGasUsedRatio

array

An array of blob gas used ratios for the returned blocks.

reward

array

(Optional) An array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty

Request

1
curl -X POST "https://docs-demo.base-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_feeHistory",
6
  "params": [
7
    4,
8
    "latest",
9
    [
10
      25,
11
      75
12
    ]
13
  ],
14
  "id": 1
15
}'

1
curl -X POST "https://docs-demo.base-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_feeHistory",
6
  "params": [
7
    4,
8
    "latest",
9
    [
10
      25,
11
      75
12
    ]
13
  ],
14
  "id": 1
15
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.base-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_feeHistory", [
6
    4,
7
    "latest",
8
    [
9
        25,
10
        75
11
    ]
12
]);
13
    console.log(response);
14
}
15

16
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.base-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_feeHistory", [
6
    4,
7
    "latest",
8
    [
9
        25,
10
        75
11
    ]
12
]);
13
    console.log(response);
14
}
15

16
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.base-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_feeHistory", [4,"latest",[25,75]])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.base-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_feeHistory", [4,"latest",[25,75]])
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.base-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_feeHistory',
10
        params: [
11
          4,
12
          "latest",
13
          [
14
            25,
15
            75
16
          ]
17
        ]
18
    })
19

20
    console.log(result)
21
}
22

23
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.base-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_feeHistory',
10
        params: [
11
          4,
12
          "latest",
13
          [
14
            25,
15
            75
16
          ]
17
        ]
18
    })
19

20
    console.log(result)
21
}
22

23
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_feeHistory',
7
  [
8
  4,
9
  "latest",
10
  [
11
    25,
12
    75
13
  ]
14
],
15
  undefined,
16
  'https://docs-demo.base-mainnet.quiknode.pro/'
17
)
18

19
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_feeHistory',
7
  [
8
  4,
9
  "latest",
10
  [
11
    25,
12
    75
13
  ]
14
],
15
  undefined,
16
  'https://docs-demo.base-mainnet.quiknode.pro/'
17
)
18

19
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_feeHistory",
8
        [
9
            4,
10
            "latest",
11
            [
12
                25,
13
                75
14
            ]
15
        ],
16
        endpoint_url="https://docs-demo.base-mainnet.quiknode.pro/",
17
    )
18
    print(result)
19

20
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_feeHistory",
8
        [
9
            4,
10
            "latest",
11
            [
12
                25,
13
                75
14
            ]
15
        ],
16
        endpoint_url="https://docs-demo.base-mainnet.quiknode.pro/",
17
    )
18
    print(result)
19

20
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_feeHistory",
7
  params: [
8
    4,
9
    "latest",
10
    [
11
      25,
12
      75
13
    ]
14
  ],
15
  endpoint_url: "https://docs-demo.base-mainnet.quiknode.pro/"
16
)
17

18
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_feeHistory",
7
  params: [
8
    4,
9
    "latest",
10
    [
11
      25,
12
      75
13
    ]
14
  ],
15
  endpoint_url: "https://docs-demo.base-mainnet.quiknode.pro/"
16
)
17

18
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_feeHistory",
10
            Some(serde_json::json!([
11
    4,
12
    "latest",
13
    [
14
        25,
15
        75
16
    ]
17
])),
18
            None,
19
            Some("https://docs-demo.base-mainnet.quiknode.pro/".into()),
20
        )
21
        .await?;
22

23
    println!("{result}");
24
    Ok(())
25
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_feeHistory",
10
            Some(serde_json::json!([
11
    4,
12
    "latest",
13
    [
14
        25,
15
        75
16
    ]
17
])),
18
            None,
19
            Some("https://docs-demo.base-mainnet.quiknode.pro/".into()),
20
        )
21
        .await?;
22

23
    println!("{result}");
24
    Ok(())
25
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_feeHistory',
4
    params: [4,"latest",[25,75]],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.base-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_feeHistory',
4
    params: [4,"latest",[25,75]],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.base-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.base-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_feeHistory",
9
  "params": [
10
    4,
11
    "latest",
12
    [
13
      25,
14
      75
15
    ]
16
  ],
17
  "id": 1
18
})
19
headers = {
20
  'Content-Type': 'application/json'
21
}
22

23
response = requests.request("POST", url, headers=headers, data=payload)
24

25
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.base-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_feeHistory",
9
  "params": [
10
    4,
11
    "latest",
12
    [
13
      25,
14
      75
15
    ]
16
  ],
17
  "id": 1
18
})
19
headers = {
20
  'Content-Type': 'application/json'
21
}
22

23
response = requests.request("POST", url, headers=headers, data=payload)
24

25
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.base-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_feeHistory",
11
  params: [4,"latest",[25,75]]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.base-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_feeHistory",
11
  params: [4,"latest",[25,75]]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "oldestBlock": "0x27221ab",
6
    "reward": [
7
      [
8
        "0x2553",
9
        "0xf4240"
10
      ],
11
      [
12
        "0x32",
13
        "0xf4240"
14
      ],
15
      [
16
        "0x2553",
17
        "0xf42a4"
18
      ],
19
      [
20
        "0x1",
21
        "0x10c8e0"
22
      ]
23
    ],
24
    "baseFeePerGas": [
25
      "0x20abbe",
26
      "0x20b16c",
27
      "0x20d2de",
28
      "0x20af94",
29
      "0x209b5a"
30
    ],
31
    "gasUsedRatio": [
32
      0.17232705333333334,
33
      0.19997097066666666,
34
      0.131668232,
35
      0.146519456
36
    ],
37
    "baseFeePerBlobGas": [
38
      "0x1",
39
      "0x1",
40
      "0x1",
41
      "0x1",
42
      "0x1"
43
    ],
44
    "blobGasUsedRatio": [
45
      0,
46
      0,
47
      0,
48
      0
49
    ]
50
  }
51
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "oldestBlock": "0x27221ab",
6
    "reward": [
7
      [
8
        "0x2553",
9
        "0xf4240"
10
      ],
11
      [
12
        "0x32",
13
        "0xf4240"
14
      ],
15
      [
16
        "0x2553",
17
        "0xf42a4"
18
      ],
19
      [
20
        "0x1",
21
        "0x10c8e0"
22
      ]
23
    ],
24
    "baseFeePerGas": [
25
      "0x20abbe",
26
      "0x20b16c",
27
      "0x20d2de",
28
      "0x20af94",
29
      "0x209b5a"
30
    ],
31
    "gasUsedRatio": [
32
      0.17232705333333334,
33
      0.19997097066666666,
34
      0.131668232,
35
      0.146519456
36
    ],
37
    "baseFeePerBlobGas": [
38
      "0x1",
39
      "0x1",
40
      "0x1",
41
      "0x1",
42
      "0x1"
43
    ],
44
    "blobGasUsedRatio": [
45
      0,
46
      0,
47
      0,
48
      0
49
    ]
50
  }
51
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free