{
  "x402Version": 2,
  "id": 72740,
  "slug": "saylorinnovations-api-chain-fee-history",
  "resource": "https://saylorinnovations.com/api/chain/fee-history",
  "description": "Gas fee history for 16 EVM chains over up to 100 recent blocks: base fee, block fullness and priority tip at chosen percentiles for each block.",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "chain": {
        "type": "string",
        "description": "the chain name that was queried"
      },
      "chain_id": {
        "type": "number",
        "description": "EIP-155 chain id of that network"
      },
      "blocks": {
        "type": "number",
        "description": "blocks in the history"
      },
      "oldest_block": {
        "type": "number",
        "description": "first block in the history"
      },
      "newest_block": {
        "type": "number",
        "description": "last block in the history"
      },
      "percentiles": {
        "description": "tip percentiles requested",
        "type": [
          "array",
          "null"
        ]
      },
      "next_block_base_fee_gwei": {
        "type": "number",
        "description": "protocol base fee for the next block, gwei"
      },
      "avg_base_fee_gwei": {
        "type": "number",
        "description": "average base fee over the history"
      },
      "min_base_fee_gwei": {
        "type": "number",
        "description": "lowest base fee in the history"
      },
      "max_base_fee_gwei": {
        "type": "number",
        "description": "highest base fee in the history"
      },
      "avg_gas_used_ratio": {
        "type": [
          "number",
          "null"
        ],
        "description": "average share of the gas limit used"
      },
      "avg_tip_gwei": {
        "type": [
          "number",
          "null"
        ],
        "description": "average priority tip at the middle percentile"
      },
      "tip_percentile_used": {
        "type": "string",
        "description": "percentile used for avg_tip_gwei"
      },
      "history": {
        "description": "one entry per block, oldest first",
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": "object",
          "properties": {
            "block": {
              "description": "block number",
              "type": [
                "number",
                "null"
              ]
            },
            "base_fee_gwei": {
              "description": "base fee of that block, gwei",
              "type": [
                "number",
                "null"
              ]
            },
            "gas_used_ratio": {
              "description": "share of the gas limit used",
              "type": [
                "number",
                "null"
              ]
            },
            "tip_p10_gwei": {
              "description": "10th percentile priority tip, gwei",
              "type": [
                "number",
                "null"
              ]
            },
            "tip_p50_gwei": {
              "description": "median priority tip, gwei",
              "type": [
                "number",
                "null"
              ]
            },
            "tip_p90_gwei": {
              "description": "90th percentile priority tip, gwei",
              "type": [
                "number",
                "null"
              ]
            }
          }
        }
      },
      "note": {
        "type": "string",
        "description": "plain-language reading of the result, including units"
      },
      "source": {
        "type": "string",
        "description": "where the data was read from"
      }
    },
    "required": [
      "chain",
      "chain_id",
      "blocks",
      "next_block_base_fee_gwei",
      "avg_base_fee_gwei",
      "history",
      "note",
      "source"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "blocks": "10",
            "chain": "ethereum"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "chain": "ethereum",
            "chain_id": 1,
            "blocks": 10,
            "oldest_block": 26238043,
            "newest_block": 26238052,
            "percentiles": [
              10,
              50,
              90
            ],
            "next_block_base_fee_gwei": 0.0395,
            "avg_base_fee_gwei": 0.041351,
            "min_base_fee_gwei": 0.037133,
            "max_base_fee_gwei": 0.044769,
            "avg_gas_used_ratio": 0.4802,
            "avg_tip_gwei": 0.007429,
            "tip_percentile_used": "p50",
            "history": [
              {
                "block": 26238043,
                "base_fee_gwei": 0.042112,
                "gas_used_ratio": 0.2804,
                "tip_p10_gwei": 0,
                "tip_p50_gwei": 0.006438,
                "tip_p90_gwei": 1.0062
              },
              {
                "block": 26238044,
                "base_fee_gwei": 0.0398,
                "gas_used_ratio": 0.9994,
                "tip_p10_gwei": 0.0002,
                "tip_p50_gwei": 0.0002,
                "tip_p90_gwei": 2
              },
              {
                "block": 26238045,
                "base_fee_gwei": 0.044769,
                "gas_used_ratio": 0.4025,
                "tip_p10_gwei": 0.000004,
                "tip_p50_gwei": 0.004013,
                "tip_p90_gwei": 1.43
              }
            ],
            "note": "Per-block base fee, how full the block was, and the priority tip paid at each percentile you asked for, newest block last. next_block_base_fee_gwei is the protocol-computed base fee for the next bloc…",
            "source": "Chain JSON-RPC (ethereum)"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "blocks": {
                    "type": "string",
                    "description": "optional number of recent blocks, 1 to 100 (default 20)"
                  },
                  "chain": {
                    "type": "string",
                    "description": "chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"
                  }
                },
                "required": [
                  "chain"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "description": "the chain name that was queried"
                  },
                  "chain_id": {
                    "type": "number",
                    "description": "EIP-155 chain id of that network"
                  },
                  "blocks": {
                    "type": "number",
                    "description": "blocks in the history"
                  },
                  "oldest_block": {
                    "type": "number",
                    "description": "first block in the history"
                  },
                  "newest_block": {
                    "type": "number",
                    "description": "last block in the history"
                  },
                  "percentiles": {
                    "description": "tip percentiles requested",
                    "type": [
                      "array",
                      "null"
                    ]
                  },
                  "next_block_base_fee_gwei": {
                    "type": "number",
                    "description": "protocol base fee for the next block, gwei"
                  },
                  "avg_base_fee_gwei": {
                    "type": "number",
                    "description": "average base fee over the history"
                  },
                  "min_base_fee_gwei": {
                    "type": "number",
                    "description": "lowest base fee in the history"
                  },
                  "max_base_fee_gwei": {
                    "type": "number",
                    "description": "highest base fee in the history"
                  },
                  "avg_gas_used_ratio": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "average share of the gas limit used"
                  },
                  "avg_tip_gwei": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "average priority tip at the middle percentile"
                  },
                  "tip_percentile_used": {
                    "type": "string",
                    "description": "percentile used for avg_tip_gwei"
                  },
                  "history": {
                    "description": "one entry per block, oldest first",
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "object",
                      "properties": {
                        "block": {
                          "description": "block number",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "base_fee_gwei": {
                          "description": "base fee of that block, gwei",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "gas_used_ratio": {
                          "description": "share of the gas limit used",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "tip_p10_gwei": {
                          "description": "10th percentile priority tip, gwei",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "tip_p50_gwei": {
                          "description": "median priority tip, gwei",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "tip_p90_gwei": {
                          "description": "90th percentile priority tip, gwei",
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    }
                  },
                  "note": {
                    "type": "string",
                    "description": "plain-language reading of the result, including units"
                  },
                  "source": {
                    "type": "string",
                    "description": "where the data was read from"
                  }
                },
                "required": [
                  "chain",
                  "chain_id",
                  "blocks",
                  "next_block_base_fee_gwei",
                  "avg_base_fee_gwei",
                  "history",
                  "note",
                  "source"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "gas fee history",
    "eth feehistory",
    "base fee trend",
    "priority fee percentiles",
    "block fullness history"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.988Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "blocks": {
          "type": "string",
          "description": "optional number of recent blocks, 1 to 100 (default 20)"
        },
        "chain": {
          "type": "string",
          "description": "chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"
        }
      },
      "required": [
        "chain"
      ]
    },
    "exampleResponse": {
      "chain": "ethereum",
      "chain_id": 1,
      "blocks": 10,
      "oldest_block": 26238043,
      "newest_block": 26238052,
      "percentiles": [
        10,
        50,
        90
      ],
      "next_block_base_fee_gwei": 0.0395,
      "avg_base_fee_gwei": 0.041351,
      "min_base_fee_gwei": 0.037133,
      "max_base_fee_gwei": 0.044769,
      "avg_gas_used_ratio": 0.4802,
      "avg_tip_gwei": 0.007429,
      "tip_percentile_used": "p50",
      "history": [
        {
          "block": 26238043,
          "base_fee_gwei": 0.042112,
          "gas_used_ratio": 0.2804,
          "tip_p10_gwei": 0,
          "tip_p50_gwei": 0.006438,
          "tip_p90_gwei": 1.0062
        },
        {
          "block": 26238044,
          "base_fee_gwei": 0.0398,
          "gas_used_ratio": 0.9994,
          "tip_p10_gwei": 0.0002,
          "tip_p50_gwei": 0.0002,
          "tip_p90_gwei": 2
        },
        {
          "block": 26238045,
          "base_fee_gwei": 0.044769,
          "gas_used_ratio": 0.4025,
          "tip_p10_gwei": 0.000004,
          "tip_p50_gwei": 0.004013,
          "tip_p90_gwei": 1.43
        }
      ],
      "note": "Per-block base fee, how full the block was, and the priority tip paid at each percentile you asked for, newest block last. next_block_base_fee_gwei is the protocol-computed base fee for the next bloc…",
      "source": "Chain JSON-RPC (ethereum)"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "blocks": "10",
              "chain": "ethereum"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "chain": "ethereum",
              "chain_id": 1,
              "blocks": 10,
              "oldest_block": 26238043,
              "newest_block": 26238052,
              "percentiles": [
                10,
                50,
                90
              ],
              "next_block_base_fee_gwei": 0.0395,
              "avg_base_fee_gwei": 0.041351,
              "min_base_fee_gwei": 0.037133,
              "max_base_fee_gwei": 0.044769,
              "avg_gas_used_ratio": 0.4802,
              "avg_tip_gwei": 0.007429,
              "tip_percentile_used": "p50",
              "history": [
                {
                  "block": 26238043,
                  "base_fee_gwei": 0.042112,
                  "gas_used_ratio": 0.2804,
                  "tip_p10_gwei": 0,
                  "tip_p50_gwei": 0.006438,
                  "tip_p90_gwei": 1.0062
                },
                {
                  "block": 26238044,
                  "base_fee_gwei": 0.0398,
                  "gas_used_ratio": 0.9994,
                  "tip_p10_gwei": 0.0002,
                  "tip_p50_gwei": 0.0002,
                  "tip_p90_gwei": 2
                },
                {
                  "block": 26238045,
                  "base_fee_gwei": 0.044769,
                  "gas_used_ratio": 0.4025,
                  "tip_p10_gwei": 0.000004,
                  "tip_p50_gwei": 0.004013,
                  "tip_p90_gwei": 1.43
                }
              ],
              "note": "Per-block base fee, how full the block was, and the priority tip paid at each percentile you asked for, newest block last. next_block_base_fee_gwei is the protocol-computed base fee for the next bloc…",
              "source": "Chain JSON-RPC (ethereum)"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "blocks": {
                      "type": "string",
                      "description": "optional number of recent blocks, 1 to 100 (default 20)"
                    },
                    "chain": {
                      "type": "string",
                      "description": "chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"
                    }
                  },
                  "required": [
                    "chain"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "the chain name that was queried"
                    },
                    "chain_id": {
                      "type": "number",
                      "description": "EIP-155 chain id of that network"
                    },
                    "blocks": {
                      "type": "number",
                      "description": "blocks in the history"
                    },
                    "oldest_block": {
                      "type": "number",
                      "description": "first block in the history"
                    },
                    "newest_block": {
                      "type": "number",
                      "description": "last block in the history"
                    },
                    "percentiles": {
                      "description": "tip percentiles requested",
                      "type": [
                        "array",
                        "null"
                      ]
                    },
                    "next_block_base_fee_gwei": {
                      "type": "number",
                      "description": "protocol base fee for the next block, gwei"
                    },
                    "avg_base_fee_gwei": {
                      "type": "number",
                      "description": "average base fee over the history"
                    },
                    "min_base_fee_gwei": {
                      "type": "number",
                      "description": "lowest base fee in the history"
                    },
                    "max_base_fee_gwei": {
                      "type": "number",
                      "description": "highest base fee in the history"
                    },
                    "avg_gas_used_ratio": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "average share of the gas limit used"
                    },
                    "avg_tip_gwei": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "average priority tip at the middle percentile"
                    },
                    "tip_percentile_used": {
                      "type": "string",
                      "description": "percentile used for avg_tip_gwei"
                    },
                    "history": {
                      "description": "one entry per block, oldest first",
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "type": "object",
                        "properties": {
                          "block": {
                            "description": "block number",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "base_fee_gwei": {
                            "description": "base fee of that block, gwei",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "gas_used_ratio": {
                            "description": "share of the gas limit used",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "tip_p10_gwei": {
                            "description": "10th percentile priority tip, gwei",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "tip_p50_gwei": {
                            "description": "median priority tip, gwei",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "tip_p90_gwei": {
                            "description": "90th percentile priority tip, gwei",
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "note": {
                      "type": "string",
                      "description": "plain-language reading of the result, including units"
                    },
                    "source": {
                      "type": "string",
                      "description": "where the data was read from"
                    }
                  },
                  "required": [
                    "chain",
                    "chain_id",
                    "blocks",
                    "next_block_base_fee_gwei",
                    "avg_base_fee_gwei",
                    "history",
                    "note",
                    "source"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/chain/fee-history?chain=ethereum&blocks=10",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "chain": "string",
    "chain_id": 0,
    "blocks": 0,
    "oldest_block": 0,
    "newest_block": 0,
    "percentiles": [
      "value"
    ],
    "next_block_base_fee_gwei": 0,
    "avg_base_fee_gwei": 0,
    "min_base_fee_gwei": 0,
    "max_base_fee_gwei": 0,
    "avg_gas_used_ratio": 0,
    "avg_tip_gwei": 0,
    "tip_percentile_used": "string",
    "history": [
      {
        "block": 0,
        "base_fee_gwei": 0,
        "gas_used_ratio": 0,
        "tip_p10_gwei": 0,
        "tip_p50_gwei": 0,
        "tip_p90_gwei": 0
      }
    ],
    "note": "string",
    "source": "string"
  }
}