REST API Endpoint

ETH Fee Forecaster (Beta) API Endpoint

get-forecast Endpoint

The get-forecast endpoint returns Unix-timestamped optimal gas fee rate suggestions (gwei) for 3 probability levels over a 6-hour forecast horizon in the following abstracted structure:

{
   "Unix timestamp":{
      "base (Base fee of block)":[ 
         "10th percentile base (in gwei)", 
         "mean of base (in gwei)",
         "90th percentile base (in gwei)"
      ],
      "fee96 (99.99% probability max fee)":[
         "10th percentile fee96 (in gwei)", 
         "mean of fee96 (in gwei)",
         "90th percentile fee96 (in gwei)"
      ],
      "fee115 (99% probability max fee)":[         
         "10th percentile fee115 (in gwei)", 
         "mean of fee115 (in gwei)",
         "90th percentile fee115 (in gwei)"
      ],
      "fee129 (90% probability max fee)":[         
         "10th percentile fee129 (in gwei)", 
         "mean of fee129 (in gwei)",
         "90th percentile fee129 (in gwei)"
      ],
      "tip96 (99.99% probability priority tip)":[        
         "10th percentile tip96 (in gwei)", 
         "mean of tip96 (in gwei)",
         "90th percentile tip96 (in gwei)"
      ],
      "tip115 (99% probability max priority tip)":[
         "10th percentile tip115 (in gwei)", 
         "mean of tip115 (in gwei)",
         "90th percentile tip115 (in gwei)"
      ],
      "tip129 (90% probability max priority tip)":[
         "10th percentile tip129 (in gwei)", 
         "mean of tip129 (in gwei)",
         "90th percentile tip129 (in gwei)"
      ]
   },

To be more precise, the 99.99%, 99%, and 90% probability levels represent the probability of a transaction being verified at that Unix timestamp with the provided gas fee rates, assuming a block is published. An example response for the get-forecast endpoint is provided below:

Gets optimal fee rate suggestions [25% percentile, Mean, 75% percentile] (gwei) for 3 probability levels

GET https://analytics.aquanow.io/eth/v1/get-forecast

200: OK

{
   "1690479060000":{
      "base":[
         59,
         64,
         68
      ],
      "fee96":[
         76,
         83,
         88
      ],
      "fee115":[
         74,
         78,
         86
      ],
      "fee129":[
         66,
         73,
         80
      ],
      "tip96":[
         19,
         20,
         22
      ],
      "tip115":[
         16,
         18,
         19
      ],
      "tip129":[
         15,
         16,
         17
      ]
   },
   "1690479120000":{
      "base":[
         58,
         63,
         68
      ],
      "fee96":[
         76,
         83,
         88
      ],
      "fee115":[
         70,
         76,
         83
      ],
      "fee129":[
         62,
         71,
         80
      ],
      "tip96":[
         19,
         20,
         22
      ],
      "tip115":[
         16,
         17,
         18
      ],
      "tip129":[
         15,
         16,
         17
      ]
   },
   "1690479180000":{
      "base":[
         55,
         61,
         66
      ],
      "fee96":[
         73,
         79,
         88
      ],
      "fee115":[
         66,
         74,
         83
      ],
      "fee129":[
         66,
         71,
         79
      ],
      "tip96":[
         18,
         20,
         22
      ],
      "tip115":[
         16,
         17,
         19
      ],
      "tip129":[
         15,
         16,
         17
      ]
   },
...