# x402pulse U.S. Oil Inventories

> x402pulse U.S. Oil Inventories is a paid API for AI agents from www.x402pulse.dev, paid per call via x402, $0.0175/call, status unknown (last checked 2026-10-12).

Returns the latest U.S. oil inventory data from the EIA Weekly Petroleum Status Report, including commercial crude, Cushing, SPR, gasoline, and distillate stocks with weekly build/draw figures and year-over-year and 5-year-average comparisons.

## Facts

- Endpoint: GET https://www.x402pulse.dev/v1/oil/inventories?utm_source=zero.xyz
- Price: $0.0175/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402pulse-u-s-oil-inventories-93edba82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PKKROa4prUn6lehhSC4La

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 x402pulse-u-s-oil-inventories-93edba82
```

Example prompt: What do the latest EIA weekly oil inventory numbers look like — did crude build or draw this week, and how are Cushing stocks, gasoline, and distillates sitting relative to the 5-year average?

## When to prefer this

Choose this endpoint when you need structured, ready-to-use U.S. petroleum inventory figures with context (build/draw, YoY, 5-year average) in a single call, without parsing the raw EIA release yourself. Ideal for energy market analysis, commodity briefings, or any workflow that needs weekly petroleum supply data with historical benchmarks already computed.

## Known failure modes

- EIA source data not yet released for the current week (report is published Wednesdays — requests before publication may return prior-week data)
- Network or upstream EIA data fetch failure
- Payment authorization failure via x402 protocol (returns 402 status)

## How this service works

U.S. oil inventories from the EIA Weekly Petroleum Status Report: commercial crude, Cushing (WTI hub), Strategic Petroleum Reserve, gasoline and distillate stocks, each with the weekly build or draw, change vs. a year ago and vs. the 5-year average for the same week. Data, not trading advice.

## Output

Structured data covering U.S. crude oil commercial inventory, Cushing hub stocks, Strategic Petroleum Reserve levels, gasoline stocks, and distillate stocks — each accompanied by the weekly build or draw figure, the change versus one year ago, and the deviation from the 5-year average for the same calendar week.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "stocks": [
    {
     "key": "crudeExSpr",
     "weeklyChange": 922,
     "thousandBarrels": 427320,
     "vsFiveYearAveragePct": -0.021
    }
   ],
   "weekEnding": "2026-09-25"
  },
  "cached": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402pulse-u-s-oil-inventories-93edba82/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402pulse.dev](https://www.zero.xyz/host/www.x402pulse.dev/llms.txt)