Ethereum API method that returns an estimate of the current priority fee per gas. This fee is the tip that users may pay miners,post-merge, to validators on top of the base fee to incentivize the inclusion of their transactions in a block. This method helps users adjust their transaction fees in a dynamic market, ensuring transactions are processed promptly without overpaying.


Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.


  • none


  • quantity — the estimated priority fee per gas needed, represented as a hexadecimal string.

eth_maxPriorityFeePerGas code examples

const { Web3, Web3PluginBase } = require("web3");
const web3 = new Web3(NODE_URL);

// Define the MaxPriorityFeePerGas class
class MaxPriorityFeePerGas extends Web3PluginBase {
    pluginNamespace = 'ethFee';

    async getMaxPriorityFeePerGas() {
        return this.requestManager.send({
            method: 'eth_maxPriorityFeePerGas',
            params: [],

// Register the plugin with Web3
web3.registerPlugin(new MaxPriorityFeePerGas());

// Function to get the max priority fee per gas using the custom plugin
async function getMaxPriorityFeePerGas() {
    try {
        const maxPriorityFeePerGas = await web3.ethFee.getMaxPriorityFeePerGas();
        console.log(`Estimated max priority fee per gas: ${maxPriorityFeePerGas}`);
    } catch (error) {
        console.error("Error fetching max priority fee per gas:", error);

// Call the function
const ethers = require('ethers');
const provider = new ethers.JsonRpcProvider(NODE_URL);

const estimatePriorityFee = async () => {
  const priorityFeePerGas = await provider.getFeeData();
  console.log(`Estimated priority fee per gas: ${priorityFeePerGas.maxPriorityFeePerGas}`);

const { Web3 } = require("web3");
const web3 = new Web3(NODE_URL);

eth_max_priority_fee_per_gas = web3.make_request('eth_maxPriorityFeePerGas', [])

Use Case

A practical use case for eth_maxPriorityFeePerGas using ethers.js is to calculate transaction fees dynamically for applications and wallets to accurately estimate the cost of transactions, especially during periods of high network congestion. This method ensures transactions are confirmed in a timely manner without overpaying. By fetching the current priority fee (maxPriorityFeePerGas) and the maximum fee per gas (maxFeePerGas), applications can dynamically calculate the total transaction fee required for prompt processing under the current network conditions.

const ethers = require('ethers');
const provider = new ethers.JsonRpcProvider(NODE_URL);

async function simulateTransaction(fromAddress, toAddress, amountEther) {
    const amountWei = ethers.utils.parseEther(amountEther.toString());
    const feeData = await provider.getFeeData();
    console.log('Full gas fee data:', feeData);

    const tx = {
        from: fromAddress,
        to: toAddress,
        value: amountWei,
        maxPriorityFeePerGas: feeData.maxPriorityFeePerGas,
        maxFeePerGas: feeData.maxFeePerGas,

    console.log('Simulating transaction:', tx);

    try {
        const estimatedGas = await provider.estimateGas(tx);
        console.log(`Estimated gas for transaction: ${estimatedGas.toString()}`);
    } catch (error) {
        console.error(`Error simulating transaction: ${error}`);

const fromAddress = "0xae2Fc483527B8EF99EB5D9B44875F005ba1FaE13";
const toAddress = "0xF135B9eD84E0AB08fdf03A744947cb089049bd79";
const amountEther = 1; // Simulating sending 1 Ether for this example

simulateTransaction(fromAddress, toAddress, amountEther);

The simulateTransaction function showcases how to build a transaction with dynamically calculated fees based on the current network state, including the base and priority fees. This approach provides a more nuanced and accurate method for estimating the total transaction fee, ensuring users pay a fair amount based on real-time network conditions. It simulates the transaction's execution to estimate gas usage without actually broadcasting it to the network, allowing for cost-effective transaction planning and testing. This simulation is particularly useful for applications that require a balance between transaction cost and confirmation speed, providing a comprehensive picture of the fees needed for timely transaction processing.

Try the eth_maxPriorityFeePerGas RPC method yourself

Click Try It! to start a request and see the response here!