{"uid":"cap_I4u8TEr4xv5ZL8STQbFq9","slug":"prereason-oil-producers-briefing-e7a1a2be","name":"PreReason Oil Producers Briefing","description":"Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.","url":"https://api.prereason.com/api/commodities/oil-producers?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":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metrics":{"oil-wti":{"name":"oil-wti"},"oil-brent":{"name":"oil-brent"},"brent-wti-spread":{"name":"brent-wti-spread"},"natural-gas-price":{"name":"natural-gas-price"},"oil-inventory-zscore":{"name":"oil-inventory-zscore"},"natgas-storage-zscore":{"name":"natgas-storage-zscore"}},"briefing_used":"commodities.oil-producers","briefing_metadata":{"name":"Oil and Its Producers","description":"Crude oil and the covered USA companies EDGAR codes tie to it, side by side: US oil and gas stocks against the five year norm (EIA), WTI and Brent spot, then each integrated major, producer and refiner, and two oil field service companies coded as producers, with its share price, its change over 1, 3 and 12 months beside WTI over the same windows, and the 90 day correlation of its daily changes with WTI, with the id of its own briefing for its filed figures. Each group in order of stored market capitalisation; it describes, it does not rank.","metrics_count":6,"correlations_count":1}}},"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_KwPlGcRFmc6GGcgvjM7At","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 WTI and Brent spot prices, US oil and gas inventory z-scores, and side-by-side stock data for covered US oil producers, integrated majors, refiners, and oilfield service companies vs WTI","exampleAgentPrompt":"Pull me today's crude oil briefing — WTI and Brent spot prices, US oil and gas inventory z-scores vs the 5-year EIA norm, and how the covered US producers, integrated majors, and refiners are tracking against WTI in markdown format.","exampleUseCases":[{"title":"Daily energy market snapshot for analyst","prompt":"Give me today's oil market overview — WTI and Brent prices, the Brent-WTI spread, US inventory z-scores, and how the major US oil producers and refiners are moving relative to crude, formatted as markdown."},{"title":"Historical oil sector performance lookup","prompt":"Pull the oil producers briefing for 2024-11-15 in JSON format — I want to see where WTI and Brent were that day and how the covered US oil stocks were positioned relative to crude."},{"title":"Monitor WTI correlation for energy portfolio","prompt":"Fetch the latest PreReason oil producers data so I can check the 90-day correlations of US integrated majors and refiners with WTI — I want to see which stocks are moving most in lockstep with crude right now."}],"resultDescription":"Returns a structured briefing with six commodity metrics (WTI, Brent, Brent-WTI spread, natural gas price, oil inventory z-score, natgas storage z-score), plus per-company data for each covered US oil producer, integrated major, refiner, and oilfield services company — including share price, 1/3/12-month performance vs WTI over the same windows, 90-day daily-return correlation with WTI, and a link ID to each company's own filed-figures briefing. Companies are grouped and ordered by stored market cap.","failureModes":["Date parameter not in YYYY-MM-DD format returns validation error","Requested historical date not in PreReason record returns empty or error response","Missing or invalid x402 payment header results in 402 Payment Required","Unsupported format enum value returns bad request error","Service unavailability or upstream EIA data lag may result in stale or partial data"],"whenToPreferThis":"Choose this endpoint when you need a combined view of crude oil benchmark prices (WTI, Brent), US energy inventory context (EIA z-scores), and US-listed oil company equity performance all in one call. It is ideal for energy sector analysis, portfolio monitoring, and AI agent briefings that need commodity and equity data together without separate API calls to price feeds and stock data providers. Prefer it over generic financial data APIs when you specifically want coverage of US oil producers, refiners, integrated majors, and oilfield services companies benchmarked against WTI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:44:39.233Z","isFirstParty":false,"canonicalSlug":"prereason-oil-producers-briefing-e7a1a2be"}