Overview

Gas is a way to measure the computation required to execute write operations on EVM-based blockchains, such as sending a transaction, executing a smart contract function, swapping tokens, etc. For instance, sending a transaction might require 21,000 units of gas, while executing a complex smart contract function could require several million units of gas.

The price of gas varies based on the network traffic. In this Function example, we will estimate the gas price by averaging the gas prices of a few transactions of a block and return the average gas price in Wei and Gwei.

What We Will Do

For this example, we will take the average of gas prices across several transactions in a block. We will demonstrate this in two ways:

1. By using a standalone Function which can be called/invoked via API.
2. By placing a filter on Streams.

Sample Function

The following is the code for the Function to get the average gas price in JavaScript Node.js v20 runtime using the block dataset:

// Initialize the main function
function main(params) {
    // Extract dataset and network from metadata in params
    const block = params.data[0];
    const dataset = params.metadata.dataset;
    const network = params.metadata.network;
    
    const transactions = block.transactions; // Get transactions of the block
    const blockNumber = parseInt(block.number, 16); // Convert block number from hex to int
    
    // Variable to define the maximum number of transactions to consider
    const numberOfTransactions = params.user_data.noOfTX; // Get number of transactions from user
    
    // Calculate the average gas price for the first 'numberOfTransactions' transactions
    let totalGasPrice = 0;
    const totalTransactions = Math.min(transactions.length, numberOfTransactions);

   // Loop to get gas prices of transactions and add them to totalGasPrice
    for (let i = 0; i < totalTransactions; i++) {
        const gasPriceInWei = parseInt(transactions[i].gasPrice, 16);
        totalGasPrice += gasPriceInWei;
    }
    
    const averageGasPriceInWei = totalGasPrice / totalTransactions; // Get average gas price in Wei
    const averageGasPriceInGwei = averageGasPriceInWei / 1e9; // Convert Wei to Gwei

   // Return average gas price in Wei and Gwei along with block number
    return { 
        averageGasPriceInWei,
        averageGasPriceInGwei,
        blockNumber
    };
}

Request

We will invoke the function with the following cURL command. Be sure to replace the YOUR_API_KEY with your own QuickNode API key and the POST URL with the URL of your Function. You can send the request with any number of transactions to check.

curl -X POST "https://api.quicknode.com/functions/rest/v1/functions/{functionId}/call?result_only=true" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "network": "ethereum-mainnet",
    "dataset": "block",
    "block": "latest",
    "user_data": {
      "noOfTX": 100
    }
  }'

Response

Resulting in the following response:

{
  "averageGasPriceInWei": 31516142429.5,
  "averageGasPriceInGwei": 31.5161424295,
  "blockNumber": 21194250
}

Learn more about QuickNode Functions.

Sample Stream Transformation

The following is a Streams Filter example:

Try it yourself by deploying the filtered Stream to your account.

// Initialize the main function of the filter
function main(data) {
  const block = data.streamData; // Get the block data from Stream
  const transactions = block.transactions; // Get transactions of the block
  const blockNumber = parseInt(block.number, 16); // Convert block number from hex to int
    
    // Variable to define the maximum number of transactions to consider
    const numberOfTransactions = 100; // You can change this value as needed
    
    // Calculate the average gas price for the first 'numberOfTransactions' transactions
    let totalGasPrice = 0;
    const totalTransactions = Math.min(transactions.length, numberOfTransactions);

   // Loop to get gas prices of transactions and add them to totalGasPrice
    for (let i = 0; i < totalTransactions; i++) {
        const gasPriceInWei = parseInt(transactions[i].gasPrice, 16);
        totalGasPrice += gasPriceInWei;
    }
    
    const averageGasPriceInWei = totalGasPrice / totalTransactions; // Get average gas price in Wei
    const averageGasPriceInGwei = averageGasPriceInWei / 1e9; // Convert Wei to Gwei

   // Return average gas price in Wei and Gwei along with block number
    return { 
        averageGasPriceInWei,
        averageGasPriceInGwei,
        blockNumber
    };
}

Output

Resulting in the following output:

{
  "averageGasPriceInGwei": 9.74463070515,
  "averageGasPriceInWei": 9744630705.15,
  "blockNumber": 20177831
}

Learn more about modifying Stream output.

We ❤️ Feedback!

Let us know if you have any feedback or requests for new topics. We'd love to hear from you.