{"uid":"cap_WNsD9unS0D4OfYQlDrR6r","slug":"petroleum-energy-data-api-x402-micropayment-cb485d1c","name":"Petroleum & Energy Data API (x402 micropayment)","description":"X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.","url":"https://x402helper.xyz/89e509/energy/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","required":[],"properties":{"metric":{"enum":["gas_prices","diesel_prices","crude_wti","crude_brent","crude_stocks","gasoline_stocks","distillate_stocks"],"type":"string","default":null,"description":"Which petroleum series to return (default gas_prices)"},"region":{"enum":["us","east_coast","midwest","gulf_coast","rocky_mountain","west_coast"],"type":"string","default":null,"description":"PADD region for retail gasoline/diesel (default us)"},"history":{"type":"integer","default":null,"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":{"type":"json","example":{"result":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.013","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.013/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.013","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.013","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tcwsBytAl-wMrM3ComPfT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.013","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 including retail gas/diesel prices, crude oil prices (WTI/Brent), and inventory stocks by PADD region, paid via USDC micropayment.","exampleAgentPrompt":"What's the current average retail gasoline price in the US, and can you show me the last 20 data points for context?","exampleUseCases":[{"title":"Retail fuel price monitoring by region","prompt":"What are the current retail gasoline prices on the West Coast, and show me the last 12 data points so I can see the recent trend?"},{"title":"Crude oil benchmark price lookup","prompt":"Get me the latest WTI and Brent crude oil prices — I need both benchmarks for a commodities report."},{"title":"Petroleum inventory stock tracking","prompt":"What are the current US gasoline and distillate stock levels? Pull the last 30 data points for each so I can check if inventories are building or drawing down."}],"resultDescription":"A JSON object with a 'success' boolean and a 'result' object containing the requested petroleum data series — price values or inventory levels for the selected metric, optionally filtered by PADD region and limited to the requested number of recent historical data points.","failureModes":["Invalid metric enum value returns an error or empty result","Region parameter not applicable to crude price metrics (crude_wti, crude_brent have no regional breakdown)","History value exceeding 120 causes validation failure","Payment not included or insufficient USDC causes 402 Payment Required response","Service unavailable if underlying EIA data source is down"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable US petroleum market data (retail gas, diesel, crude oil, or inventory stocks) queryable by PADD region and time range, and you are operating in an x402 micropayment-capable environment. Prefer this over scraping EIA.gov directly when you need a clean API response without HTML parsing. Not suited for natural gas, electricity, or non-US petroleum data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:42.756Z","isFirstParty":false,"canonicalSlug":"petroleum-energy-data-api-x402-micropayment-cb485d1c"}