{"uid":"cap_jUjiYxnOPOHARX39HXofn","slug":"eia-petroleum-prices-stocks-api-2e68da94","name":"EIA Petroleum Prices & Stocks API","description":"US petroleum prices and stocks from the EIA: retail gasoline and diesel by PADD region (weekly), WTI and Brent crude spot (daily), and weekly crude/gasoline/distillate inventories. Returns latest value, change vs prior period, short history, and a region-vs-US spread.","url":"https://api.agentstools.dev/energy/petroleum","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"metric":{"enum":["gas_prices","diesel_prices","crude_wti","crude_brent","crude_stocks","gasoline_stocks","distillate_stocks"],"type":"string","description":"Which petroleum series to return (default gas_prices)"},"region":{"enum":["us","east_coast","midwest","gulf_coast","rocky_mountain","west_coast"],"type":"string","description":"PADD region for retail gasoline/diesel (default us)"},"history":{"type":"integer","maximum":120,"minimum":1,"description":"Number of recent data points to include"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_mjYubqTaFnrx0IDodKtJX","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 US petroleum market data from EIA including retail gasoline/diesel prices by PADD region, WTI/Brent crude spot prices, and weekly crude/gasoline/distillate inventory levels.","exampleAgentPrompt":"What's the current retail gasoline price on the West Coast compared to the US average — can you pull the last 8 weeks of data so I can see the trend?","exampleUseCases":[{"title":"Track crude oil inventory trends for supply analysis","prompt":"Can you check the latest US crude oil inventory levels and show me how they've changed over the past few weeks? I need to understand if supplies are tightening or building up."},{"title":"Monitor Brent and WTI spread for trading insights","prompt":"What are today's WTI and Brent crude spot prices, and can you show me how the spread between them has moved over the last couple of months? I'm trying to spot any arbitrage patterns."},{"title":"Compare regional diesel costs for logistics planning","prompt":"Pull the current diesel prices for the Gulf Coast and Rocky Mountain regions compared to the national average, and give me the last 10 weeks so I can see which region is trending cheaper for our fuel procurement."}],"resultDescription":"Returns the latest value for the requested petroleum metric, the change vs the prior period, a short history of recent data points (up to 120), and for regional gasoline/diesel metrics a spread showing the region's price versus the US national average.","failureModes":["Invalid metric enum value returns 400 with validation error","Invalid region enum value for non-price metrics returns 400","History parameter out of range (>120 or <1) returns 400","EIA data source temporarily unavailable returns 503","No data available for requested region/metric combination"],"whenToPreferThis":"Use this endpoint when you need authoritative US petroleum market data from the EIA — retail pump prices by PADD region, WTI or Brent crude benchmarks, or weekly inventory snapshots — especially when you need the built-in period-over-period change and regional spread without doing your own calculations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:12:15.589Z","isFirstParty":false}