{"uid":"cap_HihQMC3HfZlBFhwxMxbr_","slug":"sitecheck-trade-energy-eia-weekly-petroleum-status-report-30cdd337","name":"SiteCheck Trade & Energy — EIA Weekly Petroleum Status Report","description":"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, %).","url":"https://api.tradeenergy-api.workers.dev/api/energy/eia-weekly-petroleum?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QDZYVCARN8uq1RZtV_uIG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Weekly crude inventory briefing","prompt":"Give me this week's EIA petroleum report — I want crude stocks, Cushing stocks, and the SPR, with week-over-week changes and 4 weeks of history."},{"title":"Gasoline demand and supply tracking","prompt":"What are the latest EIA numbers on gasoline stocks and gasoline product supplied? Show me the last 6 weeks so I can see if demand is picking up."},{"title":"Refinery utilization monitoring","prompt":"What's the current US refinery utilization rate from the EIA weekly report, and how has it trended over the past 12 weeks?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:24.120Z","isFirstParty":false,"canonicalSlug":"sitecheck-trade-energy-eia-weekly-petroleum-status-report-30cdd337"}