Get historical fee data

POST

https://vinu.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.

Changed in the 29 August 2026 network upgrade.

gasUsedRatio is computed per block as gasUsed / gasLimit, clamped to [0, 1]. Before that upgrade it was the hard-coded constant 0.99 for every entry, which made the field useless for fee estimation. Because gasLimit is the synthetic constant 0xffffffffffff, the new values will be very small numbers rather than 0.99 - any client thresholding on gasUsedRatio needs re-tuning.
rewardPercentiles is now capped at 100 entries; a longer list returns -32000 rewardPercentiles list exceeds maximum length of 100.
blockCount is still clamped to 1024.

reward remains a repeated constant per block - VinuChain has a flat tip structure - and baseFeePerGas remains flat.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | integer | Array<number>>required

Parameters:

blockCount — number of blocks in the requested range.
newestBlock — highest block number in the requested range (can be "latest").
rewardPercentiles — list of percentile values to sample priority fees from each block (optional).

Show child attributes

Any of

string

integer

Array<number>

idintegerrequired

Response

200OK

JSON-RPC Response with fee history data

405Method Not Allowed

Method not served by this endpoint. The body is the plain-text string Method Not Allowed, not JSON.

422Unprocessable Entity

Missing API key - the api-key header was absent. The body is the plain-text string Missing API_key, not JSON.

Get historical fee data

curl -X POST 'https://vinu.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY' \
  -d '{"jsonrpc": "2.0", "method": "eth_feeHistory", "params": ["0x4", "latest", [25, 50, 75]], "id": 1}'

import { FetchRequest, JsonRpcProvider } from "ethers";

const request = new FetchRequest("https://vinu.nownodes.io/");
request.setHeader("api-key", "YOUR_API_KEY");

const provider = new JsonRpcProvider(request);
const result = await provider.send("eth_feeHistory", ["0x4", "latest", [25, 50, 75]]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_feeHistory", "params": ["0x4", "latest", [25, 50, 75]], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider(
    "https://vinu.nownodes.io/",
    request_kwargs={"headers": {"api-key": "YOUR_API_KEY"}},
))

response = w3.provider.make_request("eth_feeHistory", [
    "0x4",
    "latest",
    [
        25,
        50,
        75,
    ],
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://vinu.nownodes.io/", {
    fetchOptions: { headers: { "api-key": "YOUR_API_KEY" } },
  }),
});

const result = await client.request({
  method: "eth_feeHistory",
  params: ["0x4", "latest", [25, 50, 75]],
});

console.log(result);

const endpoint = "https://vinu.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "eth_feeHistory", params: [
  "0x4",
  "latest",
  [
    25,
    50,
    75
  ]
], id: 1 });
console.log(result);

const response = await fetch('https://vinu.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_feeHistory",
    "params": [
      "0x4",
      "latest",
      [
        25,
        50,
        75
      ]
    ],
    "id": 1
  }),
});

const data = await response.json();

import requests

payload = {
    "jsonrpc": "2.0",
    "method": "eth_feeHistory",
    "params": [
        "0x4",
        "latest",
        [
            25,
            50,
            75,
        ],
    ],
    "id": 1,
}

response = requests.post(
    "https://vinu.nownodes.io/",
    json=payload,
    headers={"api-key": "YOUR_API_KEY"},
)

print(response.json())

require 'net/http'
require 'json'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_feeHistory", "params": ["0x4", "latest", [25, 50, 75]], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x4",
    "latest",
    [
      25,
      50,
      75
    ]
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0x10d4f",
    "baseFeePerGas": [
      "0x1dcd65000"
    ],
    "gasUsedRatio": [
      0.85
    ],
    "reward": [
      [
        "0x59682f00"
      ]
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Method Not Allowed

Missing API_key