# Paylyte EIA Weekly U.S. Crude Oil Stocks

> Paylyte EIA Weekly U.S. Crude Oil Stocks is a paid API for AI agents from paylyte.ai, paid per call via x402, $4.99/call, status unknown (last checked 2026-10-30).

Returns the latest weekly U.S. crude oil inventory figure (in thousand barrels) sourced from the Energy Information Administration.

## Facts

- Endpoint: GET https://paylyte.ai/v1/data/eia/oil?utm_source=zero.xyz
- Price: $4.99/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/paylyte-eia-weekly-u-s-crude-oil-stocks-4ac2edaf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B2-Mvryxg-x6FJUxUa6_g

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 paylyte-eia-weekly-u-s-crude-oil-stocks-4ac2edaf
```

Example prompt: What are the latest weekly U.S. crude oil inventory numbers from the EIA — give me the stock level in thousand barrels and the reporting period.

## When to prefer this

Choose this endpoint when you need the single most recent weekly U.S. crude oil inventory figure from the official EIA source, with full provenance metadata (vintage, as-of date, attribution). Prefer it over scraping EIA directly, as it abstracts the data fetch and normalizes the output schema. Best for automated pipelines, trading signals, energy dashboards, or any workflow needing reliable, timestamped EIA crude stock data without managing EIA API credentials.

## Known failure modes

- EIA data not yet updated for the current week — returns stale or prior-week data
- Upstream EIA API unavailable — may return a service error
- Rate limiting or payment failure (x402) if USDC payment is not properly handled
- Malformed response if EIA changes its reporting format

## How this service works

The latest weekly U.S. crude oil stocks from the Energy Information Administration.

## Output

A JSON object containing the latest weekly U.S. crude oil stocks in thousand barrels, the product label, reporting period, vintage date, as-of date, units, the EIA source URL, the UTC retrieval timestamp, attribution text, and any notes about the data.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "product",
      "tier",
      "period",
      "stocksThousandBarrels",
      "units",
      "sourceUrl",
      "retrievedAtUtc",
      "as_of",
      "vintage",
      "as_of_basis",
      "attribution",
      "note"
     ],
     "properties": {
      "note": {
       "type": "string"
      },
      "tier": {
       "type": "string"
      },
      "as_of": {
       "type": "string"
      },
      "units": {
       "type": "string"
      },
      "period": {
       "type": "string"
      },
      "product": {
       "type": "string"
      },
      "vintage": {
       "type": "string"
      },
      "sourceUrl": {
       "type": "string"
      },
      "as_of_basis": {
       "type": "string"
      },
      "attribution": {
       "type": "string"
      },
      "retrievedAtUtc": {
       "type": "string"
      },
      "stocksThousandBarrels": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/paylyte-eia-weekly-u-s-crude-oil-stocks-4ac2edaf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from paylyte.ai](https://www.zero.xyz/host/paylyte.ai/llms.txt)