{
  "$comment": "GENERATED FROM api/_tools/<slug>/route.mjs — do not edit by hand",
  "type": "https://eips.ethereum.org/EIPS/eip-8257#tool-manifest-v1",
  "name": "gas-oracle",
  "description": "Base chain gas oracle with timing recommendations. Returns current gas price, base fee, block utilization, priority fee suggestions (slow/normal/fast), recent-block aggregates, trend, and a best-time-to-transact heuristic. 15s cache. $0.01 USDC per call; AXIOM Tool Pass holders bypass via SIWE.",
  "endpoint": "https://www.clawbots.org/api/tools/gas-oracle",
  "inputs": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "outputs": {
    "type": "object",
    "properties": {
      "chain": {
        "type": "string"
      },
      "fetchedAt": {
        "type": "string",
        "format": "date-time"
      },
      "blockNumber": {
        "type": [
          "integer",
          "null"
        ]
      },
      "blockTimestamp": {
        "type": [
          "string",
          "null"
        ],
        "format": "date-time"
      },
      "current": {
        "type": "object",
        "properties": {
          "gasPriceGwei": {
            "type": "number"
          },
          "baseFeeGwei": {
            "type": [
              "number",
              "null"
            ]
          },
          "blockUtilization": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "gasPriceGwei"
        ]
      },
      "suggestions": {
        "type": "object",
        "properties": {
          "slow": {
            "type": "object",
            "properties": {
              "maxFeeGwei": {
                "type": "number"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "maxFeeGwei",
              "label"
            ]
          },
          "normal": {
            "type": "object",
            "properties": {
              "maxFeeGwei": {
                "type": "number"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "maxFeeGwei",
              "label"
            ]
          },
          "fast": {
            "type": "object",
            "properties": {
              "maxFeeGwei": {
                "type": "number"
              },
              "label": {
                "type": "string"
              }
            },
            "required": [
              "maxFeeGwei",
              "label"
            ]
          }
        },
        "required": [
          "slow",
          "normal",
          "fast"
        ]
      },
      "recentBlocks": {
        "type": [
          "object",
          "null"
        ],
        "properties": {
          "avgBaseFeeGwei": {
            "type": "number"
          },
          "minBaseFeeGwei": {
            "type": "number"
          },
          "maxBaseFeeGwei": {
            "type": "number"
          }
        }
      },
      "trend": {
        "type": "string",
        "enum": [
          "stable",
          "rising",
          "falling"
        ]
      },
      "timing": {
        "type": "string",
        "enum": [
          "excellent",
          "good",
          "wait",
          "congested"
        ]
      },
      "timingExplanation": {
        "type": "string"
      },
      "l1DataFeeEstimate": {
        "type": "string"
      }
    },
    "required": [
      "chain",
      "fetchedAt",
      "current",
      "suggestions",
      "trend",
      "timing",
      "timingExplanation",
      "l1DataFeeEstimate"
    ]
  },
  "creatorAddress": "0xef2cc7d15d3421629f93ffa39727f14179f31c75",
  "tags": [
    "gas",
    "oracle",
    "base",
    "timing",
    "fees"
  ],
  "pricing": [
    {
      "amount": "0.01",
      "asset": "USDC",
      "recipient": "0xef2cc7d15d3421629f93ffa39727f14179f31c75",
      "protocol": "x402"
    }
  ],
  "authentication": [
    {
      "type": "siwe",
      "description": "Sign In With Ethereum. Holders of the Axiom Tool Pass NFT get free unlimited access. Sign a SIWE message proving wallet ownership; the server verifies your wallet holds the pass on-chain.",
      "header": "Authorization: SIWE <base64url(message)>.<0xsignature>",
      "passContract": "0xfc9ce3990f85fA1A3a0eE51a710642396a6Cad82",
      "chain": "base",
      "chainId": 8453,
      "collection": "https://opensea.io/collection/axiom-tool-pass"
    },
    {
      "type": "x402",
      "description": "Pay per call in USDC on Base via the x402 protocol. No account or API key needed.",
      "header": "x-payment: <x402 authorization>"
    }
  ],
  "onChain": {
    "registry": "0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1",
    "chainId": 8453,
    "toolId": 22
  }
}