# SiteCheck Trade & Energy — EIA Weekly Petroleum Status Report

> SiteCheck Trade & Energy — EIA Weekly Petroleum Status Report is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns US EIA Weekly Petroleum Status Report data including crude, SPR, gasoline, distillate, jet fuel, propane stocks, production, imports, exports, demand, and refinery utilization with week-over-week changes and recent history.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/energy/eia-weekly-petroleum?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-eia-weekly-petroleum-status-report-30cdd337
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HihQMC3HfZlBFhwxMxbr_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-trade-energy-eia-weekly-petroleum-status-report-30cdd337
```

Example prompt: Pull the latest EIA weekly petroleum status report for crude stocks, SPR, gasoline, and refinery utilization with the past 8 weeks of history so I can see the trend.

## When to prefer this

Use this endpoint when you need authoritative, official US petroleum inventory and production data from the EIA, including crude stocks, SPR levels, Cushing hub storage, refined product inventories, and refinery utilization. Prefer this over unofficial sources or price APIs when you specifically need weekly supply/demand balance data rather than spot prices. It is ideal for energy market analysis, commodity research, or automated monitoring of US oil market fundamentals.

## Known failure modes

- EIA API key rate limit exceeded (DEMO_KEY has low rate limits) — response may return an error or empty data
- Requested series name not recognized — invalid series names are ignored or return empty
- EIA upstream API unavailable or slow — endpoint may return stale or error response
- weeks parameter out of range (not 1-52) — may return default or error
- No data available for the requested week if EIA has not yet published the report

## How this service works

US EIA Weekly Petroleum Status Report data from the official EIA Open Data API: commercial crude, SPR, Cushing, gasoline, distillate, jet fuel and propane stocks, crude production, imports, exports, total and gasoline product supplied (demand) and refinery utilization. Latest week, week-over-week change and recent history per series; units as published (thousand barrels, thousand b/d, %).

## Output

A JSON object containing an array of petroleum series, each with its name, EIA series ID, description, units (thousand barrels or thousand b/d or %), the latest week's value, week-over-week change, and an array of historical weekly data points. Also includes the source URL, the API key used, and the timestamp the data was checked.

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "weeks": {
       "type": "string",
       "description": "Weeks of history per series, 1-52 (default 4)"
      },
      "series": {
       "type": "string",
       "description": "Comma list of crudeStocks, sprStocks, gasolineStocks, distillateStocks, jetFuelStocks, propaneStocks, crudeProduction, crudeImports, crudeExports, productSupplied, gasolineSupplied, refineryUtilization, cushingStocks (default: all), or raw EIA series ids like WCESTUS1"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "series": [
   {
    "name": "crudeStocks",
    "units": "MBBL",
    "latest": {
     "week": "2026-10-16",
     "value": 412517
    },
    "history": [
     {
      "week": "2026-10-16",
      "value": 412517
     },
     {
      "week": "2026-10-09",
      "value": 415577
     }
    ],
    "seriesId": "WCESTUS1",
    "description": "U.S. Ending Stocks excluding SPR of Crude Oil (Thousand Barrels)",
    "weeklyChange": -3060
   },
   {
    "name": "sprStocks",
    "units": "MBBL",
    "latest": {
     "week": "2026-10-16",
     "value": 282683
    },
    "history": [
     {
      "week": "2026-10-16",
      "value": 282683
     },
     {
      "week": "2026-10-09",
      "value": 282983
     }
    ],
    "seriesId": "WCSSTUS1",
    "description": "U.S. Ending Stocks of Crude Oil in SPR (Thousand Barrels)",
    "weeklyChange": -300
   }
  ],
  "source": "https://api.eia.gov/v2/petroleum/sum/sndw/data/",
  "keyUsed": "DEMO_KEY",
  "checkedAt": "2026-10-23T09:38:09.501Z",
  "weekEnding": "2026-10-16"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-eia-weekly-petroleum-status-report-30cdd337/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)