base-gas-x402-production.up.railway.app

{
  "properties": {
    "chain": {
      "example": "base-mainnet",
      "type": "string"
    },
    "chainId": {
      "example": 8453,
      "type": "integer"
    },
    "coverage": {
      "description": "How much history actually backs this response.",
      "properties": {
        "hoursCovered": {
          "example": 24,
          "type": "number"
        },
        "retentionHours": {
          "example": 168,
          "type": "integer"
        },
        "samples": {
          "example": 288,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "currentGasPrice": {
      "example": 0.006,
      "type": "number"
    },
    "fetchedAt": {
      "format": "date-time",
      "type": "string"
    },
    "requestedHours": {
      "example": 24,
      "type": "integer"
    },
    "samples": {
      "description": "Time series, oldest first.",
      "items": {
        "properties": {
          "baseFee": {
            "example": 0.005,
            "type": "number"
          },
          "gasPrice": {
            "example": 0.006,
            "type": "number"
          },
          "priorityMedium": {
            "example": 0.001,
            "type": "number"
          },
          "t": {
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "spreadPercent": {
      "description": "Width of the window's range as a percentage of its minimum. Below 1% the verdict is reported as `flat`.",
      "example": 0.0067,
      "type": "number"
    },
    "summary": {
      "properties": {
        "avg": {
          "example": 0.009,
          "type": "number"
        },
        "max": {
          "example": 0.031,
          "type": "number"
        },
        "median": {
          "example": 0.007,
          "type": "number"
        },
        "min": {
          "example": 0.005,
          "type": "number"
        }
      },
      "type": "object"
    },
    "units": {
      "example": "gwei",
      "type": "string"
    },
    "verdict": {
      "description": "Where the current gas price sits within the window's range. Returns `flat` when the window's spread is under 1%, which on Base is common: the chain sits on its fee floor for hours and there is nothing to time.",
      "enum": [
        "cheap",
        "normal",
        "expensive",
        "flat"
      ],
      "example": "flat",
      "type": "string"
    },
    "verdictNote": {
      "description": "Plain-language explanation of the verdict, including the observed spread.",
      "example": "Gas has not moved meaningfully in this window (spread 0.0067%, below the 1% threshold). There is nothing to wait for.",
      "type": "string"
    }
  },
  "type": "object"
}