# EnergyCatalyst – US Energy Inventory Signal & EIA Calendar

> EnergyCatalyst – US Energy Inventory Signal & EIA Calendar is a paid API for AI agents from energy.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns BULLISH/NEUTRAL/BEARISH signals for petroleum and natural gas based on current US EIA inventory data versus 5-year seasonal norms, plus the schedule of upcoming EIA report releases

## Facts

- Endpoint: GET https://energy.lonestaroracle.xyz/energy
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/energycatalyst-us-energy-inventory-signal-eia-calendar-5e20b3f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8ze1WpzQRIlU6w71w5HA9

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 energycatalyst-us-energy-inventory-signal-eia-calendar-5e20b3f5
```

Example prompt: What's the current inventory signal for crude oil — is it bullish or bearish versus the 5-year seasonal average — and when is the next EIA Weekly Petroleum Status Report?

## When to prefer this

Choose this endpoint when you need a ready-made directional trading signal (BULLISH/NEUTRAL/BEARISH) derived from US EIA inventory data rather than raw data you'd have to interpret yourself. It combines real-time inventory levels, 5-year seasonal comparisons, weekly draw/build figures, and the EIA report calendar in a single call — ideal for pre-trade setup checks, energy-focused portfolio monitoring, or automated trading workflows that need to act ahead of EIA release catalysts. Prefer it over general financial data APIs when the specific question is about whether US energy inventories are tight or loose relative to seasonal norms.

## Known failure modes

- EIA data not yet updated for the current week — may return prior week's data
- Invalid report parameter value returns an error or falls back to full dashboard
- Service unavailable if underlying EIA data feed is down
- x402 payment failure if USDC balance insufficient or wallet not configured
- Rate limiting if too many calls made in a short window

## How this service works

US energy inventory catalyst signal + EIA report calendar (optional ?report=)

## Output

Returns a JSON object with: BULLISH/NEUTRAL/BEARISH signals for petroleum and natural gas separately; current inventory levels in MMbbl or BCF with the as-of date; weekly change (draw or build); percentage deviation from the 5-year seasonal average and year-ago levels; an interpretation sentence explaining the price implications; and an array of upcoming EIA catalyst events with exact UTC release times and the securities each event is expected to move (e.g. WTI, Brent, USO, XLE, XOM/CVX).

## Request schema (JSON Schema)

```json
{
 "name": "EnergyCatalyst",
 "tags": [
  "energy",
  "oil",
  "natural-gas",
  "eia",
  "catalyst"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "energy",
 "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": {
      "report": {
       "type": "string",
       "example": "crude",
       "description": "Optional. Focus one report: crude (or oil/petroleum), gasoline, distillate (diesel), or natgas (natural gas). Omit for the full energy dashboard. Aliases: commodity, r."
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "source": "US Energy Information Administration",
     "crude_oil": {
      "unit": "MMbbl",
      "as_of": "2026-07-31",
      "value": 407,
      "weekly_change": 2.5,
      "vs_5yr_avg_pct": -6.2,
      "vs_year_ago_pct": -3.9
     },
     "natural_gas": {
      "unit": "BCF",
      "as_of": "2026-07-31",
      "value": 3117,
      "weekly_change": 33,
      "vs_5yr_avg_pct": 6
     },
     "natgas_signal": "BEARISH",
     "interpretation": "Petroleum inventories are tight versus the 5-year seasonal norm (crude -6.2% vs 5-yr avg) — price-supportive. Natural-gas storage is +6.0% versus the 5-year average — ample, a price headwind.",
     "next_catalysts": [
      {
       "event": "EIA Weekly Petroleum Status Report",
       "moves": "WTI, Brent, USO, XLE, XOM/CVX",
       "days_out": 4.1,
       "next_release": "2026-08-12T14:30:00+00:00"
      }
     ],
     "petroleum_signal": "BULLISH"
    }
   }
  }
 },
 "description": "Use this when you need to trade or assess US energy around a scheduled inventory report. It answers: 'are crude oil, gasoline, or natural-gas inventories tight or loose right now?', 'is the setup bullish or bearish for oil and gas prices?', and 'when is the next EIA report and what will it move?'. One x402 call returns a BULLISH / NEUTRAL / BEARISH signal for petroleum and for natural gas — from current stocks versus the 5-year seasonal average and the latest weekly draw/build — plus the exact date and time of the next EIA Weekly Petroleum Status and N
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/energycatalyst-us-energy-inventory-signal-eia-calendar-5e20b3f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from energy.lonestaroracle.xyz](https://www.zero.xyz/host/energy.lonestaroracle.xyz/llms.txt)