{"uid":"cap_eq9moUD13FyleUa11LgiN","slug":"market-intelligence-api-eia-weekly-oil-inventories-ab76e993","name":"Market Intelligence API – EIA Weekly Oil Inventories","description":"Oil inventories and crude stocks, weekly (EIA Weekly Petroleum Status Report, Wednesdays): US commercial crude, Cushing, SPR, gasoline and distillate stocks with weekly change and the 5-year average for the same week, plus crude production, refinery utilization, imports and exports. Use for the weekly oil supply picture.","url":"https://api.marketintelligenceapi.com/api/v1/markets/oil-inventories?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AY2nFzN7UTF32RlNSc9nJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest EIA Weekly Petroleum Status Report data including US commercial crude, Cushing, SPR, gasoline and distillate stocks with weekly changes, 5-year averages, plus crude production, refinery utilization, imports, and exports.","exampleAgentPrompt":"Pull this week's EIA oil inventory report — I want to see US commercial crude stocks, Cushing levels, gasoline and distillate inventories, the weekly changes, how they compare to the 5-year average, plus refinery utilization and crude production.","exampleUseCases":[{"title":"Weekly crude inventory briefing for traders","prompt":"Give me this week's EIA petroleum status numbers — commercial crude stocks, the Cushing figure, weekly changes, and how everything compares to the 5-year average so I can see if we're over or under-supplied."},{"title":"Oil price move explanation check","prompt":"Crude just dropped 2% this morning — can you pull the latest EIA weekly inventory data to see if there was a surprise build in commercial crude or SPR that might explain the move?"},{"title":"Macro energy dashboard update","prompt":"Update my energy dashboard with the latest weekly EIA data: US crude production, refinery utilization rate, import and export volumes, and total petroleum stocks including gasoline and distillates."}],"resultDescription":"A JSON object containing the most recent EIA Weekly Petroleum Status Report figures: US commercial crude oil stocks (barrels), Cushing Oklahoma crude stocks, Strategic Petroleum Reserve level, gasoline stocks, distillate stocks, each with the weekly change and the 5-year average for the same reporting week, plus US crude production, refinery utilization percentage, crude imports, and crude exports.","failureModes":["EIA data not yet released for the current week (report releases Wednesdays — calls before release return prior week data or an error)","API payment failure if x402 micropayment is not properly handled","Upstream EIA data delay or revision causing stale figures","No query parameters accepted — passing parameters returns an error or they are silently ignored"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced weekly US petroleum inventory data in a single structured call. It consolidates the full EIA Weekly Petroleum Status Report into one response, making it superior to scraping EIA's website or parsing their spreadsheets. Ideal for energy traders, macro analysts, or any agent that needs to contextualize oil price moves, assess supply/demand balance, or update a commodity dashboard on a Wednesday cadence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T18:35:08.932Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-eia-weekly-oil-inventories-ab76e993"}