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

result

object

Fee history result object

oldestBlock

string

Lowest block number in the returned range, hex-encoded

baseFeePerGas

array

Array of per-block base fee values in wei, hex-encoded. Includes one extra entry for the block immediately after the newest returned block

gasUsedRatio

array

Array of per-block gas used ratios (gasUsed / gasLimit) as floats

reward

array

Optional array of per-block priority fee samples in wei, hex-encoded. Each inner array corresponds to the requested reward percentiles for that block; returns zeros for empty blocks

baseFeePerBlobGas

array

Optional array of per-block blob base fee values in wei, hex-encoded. Includes one extra entry for the block immediately after the newest returned block

blobGasUsedRatio

array

Optional array of per-block blob gas used ratios as floats

Request

1
curl https://docs-demo.moca-testnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"eth_feeHistory","params":["0x5", "latest", [25, 75]],"id":1,"jsonrpc":"2.0"}'

1
curl https://docs-demo.moca-testnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"method":"eth_feeHistory","params":["0x5", "latest", [25, 75]],"id":1,"jsonrpc":"2.0"}'

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.moca-testnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_feeHistory",
7
    "params":["0x5", "latest", [25, 75]],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.moca-testnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_feeHistory",
7
    "params":["0x5", "latest", [25, 75]],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider(
4
    "https://docs-demo.moca-testnet.quiknode.pro/"
5
  );
6
  const response = await provider.send("eth_feeHistory", [4, "latest", [25, 75]]);
7
  console.log(response);
8
})();

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider(
4
    "https://docs-demo.moca-testnet.quiknode.pro/"
5
  );
6
  const response = await provider.send("eth_feeHistory", [4, "latest", [25, 75]]);
7
  console.log(response);
8
})();

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_feeHistory",
6
  "params":["0x5", "latest", [25, 75]
7
  ],
8
  "id": 1,
9
  "jsonrpc": "2.0"
10
});
11

12
var requestOptions = {
13
  method: 'POST',
14
  headers: myHeaders,
15
  body: raw,
16
  redirect: 'follow'
17
};
18

19
fetch("https://docs-demo.moca-testnet.quiknode.pro/", requestOptions)
20
  .then(response => response.text())
21
  .then(result => console.log(result))
22
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_feeHistory",
6
  "params":["0x5", "latest", [25, 75]
7
  ],
8
  "id": 1,
9
  "jsonrpc": "2.0"
10
});
11

12
var requestOptions = {
13
  method: 'POST',
14
  headers: myHeaders,
15
  body: raw,
16
  redirect: 'follow'
17
};
18

19
fetch("https://docs-demo.moca-testnet.quiknode.pro/", requestOptions)
20
  .then(response => response.text())
21
  .then(result => console.log(result))
22
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

4
url = "https://docs-demo.moca-testnet.quiknode.pro/"
5

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

17
response = requests.request("POST", url, headers=headers, data=payload)
18

19
print(response.text)
20

1
import requests
2
import json
3

4
url = "https://docs-demo.moca-testnet.quiknode.pro/"
5

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

17
response = requests.request("POST", url, headers=headers, data=payload)
18

19
print(response.text)
20

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

5
url = URI("https://docs-demo.moca-testnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_feeHistory",
14
  "params":["0x5", "latest", [25, 75]
15
  ],
16
  "id": 1,
17
  "jsonrpc": "2.0"
18
})
19

20
response = https.request(request)
21
puts response.read_body
22

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

5
url = URI("https://docs-demo.moca-testnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_feeHistory",
14
  "params":["0x5", "latest", [25, 75]
15
  ],
16
  "id": 1,
17
  "jsonrpc": "2.0"
18
})
19

20
response = https.request(request)
21
puts response.read_body
22

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

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free