Roundhouse AI

energy-petroleum

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.

TradingLiveeip155:8453Exactvia cdp
https://api.agentstools.dev/energy/petroleum
EnergyPetroleumOilGasolineDiesel
Calls · 30d
1↓ 46%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far.
$42.97
Verified settled volume
3,793 settlements proven x402 by their on-chain EIP-3009 marker.
$0.010
Listed price
As published in the catalog. Always read the live 402 before paying.
1
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-08-27 04:46Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493

The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.

Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Provider

The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 300
    }
  ],
  "resource": {
    "url": "https://api.agentstools.dev/energy/petroleum",
    "tags": [
      "energy",
      "petroleum",
      "oil",
      "gasoline",
      "diesel",
      "crude",
      "wti",
      "brent",
      "eia",
      "prices",
      "inventory"
    ],
    "mimeType": "application/json",
    "description": "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.",
    "serviceName": "energy-petroleum"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "metric": "gas_prices",
            "region": "west_coast",
            "history": 8
          }
        },
        "output": {
          "type": "json",
          "example": {
            "unit": "$/gal",
            "as_of": "2026-06-29",
            "change": {
              "change": -0.08,
              "change_pct": -1.78
            },
            "latest": {
              "units": "$/GAL",
              "value": 4.42,
              "period": "2026-06-29"
            },
            "metric": "gas_prices",
            "region": "west_coast",
            "regional_spread": {
              "vs": "us",
              "spread": 0.59
            }
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "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"
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

0.01USDC≈ $0.01 USD
on Base · exact scheme

Pay 0.01 USDC on Base to 0xF22e…Ff493. The signed payment is good for 5 minutes.

Paid to
0xF22e…Ff493
USD Coin contract
0x8335…02913
Payment window
5 minutes
As published
10000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
    "amount": "10000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "metric": "gas_prices",
          "region": "west_coast",
          "history": 8
        }
      },
      "output": {
        "type": "json",
        "example": {
          "unit": "$/gal",
          "as_of": "2026-06-29",
          "change": {
            "change": -0.08,
            "change_pct": -1.78
          },
          "latest": {
            "units": "$/GAL",
            "value": 4.42,
            "period": "2026-06-29"
          },
          "metric": "gas_prices",
          "region": "west_coast",
          "regional_spread": {
            "vs": "us",
            "spread": 0.59
          }
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "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"
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog
2026-08-27 04:46Z
Last indexed by Roundhouse
2026-09-24 15:00Z
Last enriched (probe, favicon, geo)
2026-09-14 02:45Z
x402 version
2
Max timeout
300s
Liveness probe
HTTP 402
Report

Hand this page to an agent

Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.

GET api.roundhouseai.io/v0/endpoints

This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.

Open skill.md
Show the prompt
Using Roundhouse, look up the x402 service energy-petroleum and tell me whether it is
worth paying: what a call costs, whether the endpoint answered when last probed, and what
its payment record actually shows.

curl -s 'https://api.roundhouseai.io/v0/endpoints?q=energy-petroleum'
curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>'

Then call it: read the price from the live 402 at https://api.agentstools.dev/energy/petroleum, never from
a cached figure, and pay with an x402 client.

The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except
/v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402,
or use an organization key from https://roundhouseai.io/dashboard/team.

If you do not have Roundhouse tools or skills installed, read
https://roundhouseai.io/skill.md first — it is the whole procedure.