SERVICE / DETAILother

energy-petroleum

GET api.agentstools.dev/energy/petroleum

OPEN SERVICE ↗
SONAR SCORE0.728
LIVE PRICE0.010000
BAZAAR LIVEcompatible
CDP INDEXEDno
DECISION EVIDENCE

Why an agent can trust this route.

23 observations in the last 24h
HANDSHAKE SUCCESS91.3%402 challenge reachable
PAID DELIVERY0.0%settlement observed
P90 LATENCY2678msrecent response window
PRICE DRIFT0.0%advertised vs observed

Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.

SONAR PROBE HISTORY / 30D

Observed outcomes

JSON ↗
LIVE ENDPOINT METADATA

US petroleum prices and stocks from the EIA: retail gasoline and diesel by PADD region (weekly), WTI and Brent crude spot (daily), and weekly crude/gasoline/distillate inventories. Returns latest value, change vs prior period, short history, and a region-vs-US spread.

Resource: api.agentstools.dev/energy/petroleum

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493

Payment methods: — · Last validation: 2026-09-14 12:03:25.569+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET",
          "HEAD",
          "DELETE"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "properties": {
          "metric": {
            "enum": [
              "gas_prices",
              "diesel_prices",
              "crude_wti",
              "crude_brent",
              "crude_stocks",
              "gasoline_stocks",
              "distillate_stocks"
            ],
            "type": "string",
            "description": "Which petroleum series to return (default gas_prices)"
          },
          "region": {
            "enum": [
              "us",
              "east_coast",
              "midwest",
              "gulf_coast",
              "rocky_mountain",
              "west_coast"
            ],
            "type": "string",
            "description": "PADD region for retail gasoline/diesel (default us)"
          },
          "history": {
            "type": "integer",
            "maximum": 120,
            "minimum": 1,
            "description": "Number of recent data points to include"
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object"
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
        "amount": "10000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "10000"
    }
  ]
}
METADATA PROVENANCE

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.