{"uid":"cap_8ze1WpzQRIlU6w71w5HA9","slug":"energycatalyst-us-energy-inventory-signal-eia-calendar-5e20b3f5","name":"EnergyCatalyst – US Energy Inventory Signal & EIA Calendar","description":"US energy inventory catalyst signal + EIA report calendar (optional ?report=)","url":"https://energy.lonestaroracle.xyz/energy","method":"GET","headers":{},"bodySchema":{"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 Natural Gas Storage reports, the scheduled catalysts that move WTI, Brent, Henry Hub, USO, UNG, XLE and energy equities like XOM and CVX. The energy sector's catalyst calendar, agent-callable. $0.05 in USDC on Base via x402. Source: US EIA (free/public). Does NOT include the paid analyst-consensus 'expected draw/build'; compares to EIA's own 5-year seasonal norm."},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MrS3Pi6_4KzkYbanKkcUT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-trade crude oil setup check","prompt":"Before I put on a WTI crude position today, tell me whether petroleum inventories are tight or loose versus the 5-year norm and what the current signal is — bullish, neutral, or bearish?"},{"title":"Natural gas trading catalyst alert","prompt":"I'm looking at natural gas futures — is storage running above or below the 5-year seasonal average right now, what's the natgas signal, and when does the next EIA natural gas storage report drop?"},{"title":"Full energy dashboard for portfolio review","prompt":"Give me a full energy inventory snapshot — crude oil, gasoline, distillate, and natural gas — with the bullish/bearish signal for each and when the next EIA reports are scheduled to come out."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:05.589Z","isFirstParty":false}