{"uid":"cap_QcIAyQyhaGT2XD45g5BpS","slug":"prereason-energy-basket-5e76332f","name":"PreReason Energy Basket","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/energy-basket?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"},"oil-wti-realized-vol-30d":{"name":"oil-wti-realized-vol-30d"}},"briefing_used":"commodities.energy-basket","briefing_metadata":{"name":"Energy Basket","description":"US oil and gas stocks against the five year norm, with what changed and what comes next: EIA weekly commercial crude stocks and Lower 48 gas storage, each placed against the same week in the prior five years; WTI, Brent and Henry Hub spot prices; the Brent to WTI spread; WTI 30 day realised volatility (computed from EIA spot prices, backward looking); the dates of the next EIA reports.","metrics_count":7,"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_9hm9w4ZmDeA0ftkgdZA9p","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 US oil and gas market data including EIA crude/gas inventory z-scores versus 5-year norms, WTI/Brent/Henry Hub spot prices, Brent-WTI spread, and 30-day WTI realized volatility","exampleAgentPrompt":"Pull the current energy basket briefing — I want to see where US crude oil and natural gas inventories stand versus their 5-year norms, today's WTI and Brent prices, the Brent-WTI spread, and the 30-day realized volatility on WTI, formatted as markdown.","exampleUseCases":[{"title":"Weekly EIA report energy context","prompt":"It's Thursday after the EIA release — can you grab the energy basket and tell me whether US crude stocks are above or below the 5-year norm and what the z-score looks like?"},{"title":"Energy briefing for commodity trader","prompt":"I need today's full energy market snapshot: WTI and Brent spot prices, the spread between them, Henry Hub gas price, and whether oil and gas inventories are statistically high or low versus the past five years."},{"title":"Historical energy inventory analysis","prompt":"Pull the energy basket data for 2024-01-19 so I can see where crude and natural gas storage stood relative to their 5-year seasonal norms on that date, along with the realized volatility figure."}],"resultDescription":"A structured briefing (JSON or token-optimized markdown) containing 7 metrics: WTI crude price, Brent crude price, Brent-WTI spread, Henry Hub natural gas price, oil inventory z-score vs 5-year seasonal norm, natural gas storage z-score vs 5-year seasonal norm, and WTI 30-day realized volatility computed from EIA spot prices — plus upcoming EIA report dates and one cross-metric correlation.","failureModes":["Requested historical date not on record returns an error or empty dataset","Invalid date format (not YYYY-MM-DD) returns a validation error","EIA data not yet released for the current week may return stale or unavailable inventory readings","Payment failure (x402) results in 402 response before data is served"],"whenToPreferThis":"Choose this endpoint when you need a pre-contextualized, multi-metric energy commodities snapshot that places EIA weekly crude and gas inventory data against 5-year seasonal norms with z-scores — rather than raw price feeds or single-metric lookups. Ideal when an agent needs to answer 'is the market tight or loose?' without computing historical comparisons itself. Prefer over generic commodity price APIs when the user wants inventory context, volatility, and spread data in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:31:11.168Z","isFirstParty":false,"canonicalSlug":"prereason-energy-basket-5e76332f"}