{"uid":"cap_uS8_hGc3bQJDax4hXov1f","slug":"agents-x402stock-xyz-x402stock-energy-benchmark-price-history-7c1796c5","name":"x402stock Energy Benchmark Price History","description":"Price history for one energy benchmark — `wti` (WTI crude, $/bbl), `brent` (Brent crude, $/bbl), `natural-gas` (Henry Hub, $/MMBtu), or `gasoline` (US regular retail, $/gal) — with the latest value, prior reading, change, and recent history. Tune with `?limit=` (default 30, max 365). The catalog's commodities feed. Source: U.S. Energy Information Administration (EIA). From x402stock","url":"https://agents.x402stock.xyz/api/v1/energy/{product}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["product"],"properties":{"limit":{"type":"integer","default":30,"maximum":365,"exclusiveMinimum":0},"product":{"type":"string","description":"Energy benchmark slug: wti, brent, natural-gas, or gasoline."}}},"responseSchema":{"type":"object","required":["product","series_id","name","unit","eia_units","frequency","latest","prior","change","change_percent","source","as_of","history","attribution"],"properties":{"name":{"type":"string"},"unit":{"type":"string"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"prior":{"anyOf":[{"type":"object","required":["date","value"],"properties":{"date":{"type":"string"},"value":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"latest":{"anyOf":[{"type":"object","required":["date","value"],"properties":{"date":{"type":"string"},"value":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"source":{"type":"string","const":"eia"},"history":{"type":"array","items":{"type":"object","required":["date","value"],"properties":{"date":{"type":"string"},"value":{"type":"number"}},"additionalProperties":false}},"product":{"type":"string"},"eia_units":{"anyOf":[{"type":"string"},{"type":"null"}]},"frequency":{"type":"string"},"series_id":{"type":"string"},"attribution":{"type":"string"},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vMnQebu_BJ-EcUHjlnq6C","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns latest price, prior reading, change, and up to 365 days of history for WTI crude, Brent crude, Henry Hub natural gas, or US retail gasoline, sourced from the EIA.","exampleAgentPrompt":"What's the current WTI crude oil price and how has it trended over the last 60 days? Pull the EIA data including the latest value, prior reading, and change.","exampleUseCases":[{"title":"Daily energy price briefing","prompt":"Give me today's WTI crude price from the EIA, including the prior reading and how much it's changed, so I can include it in my morning market summary."},{"title":"Natural gas market trend analysis","prompt":"Pull the last 90 days of Henry Hub natural gas price history from EIA — I want to see the trend and where prices stand today versus a few months ago."},{"title":"Gasoline price monitoring for logistics","prompt":"What's the latest US retail gasoline price per gallon according to the EIA, and how does it compare to the previous reading? Show me the last 30 data points."}],"resultDescription":"A JSON object containing the product slug, EIA series ID, human-readable name, unit (e.g. $/bbl), EIA units string, reporting frequency, latest price point (date + value), prior price point (date + value), absolute change, percent change, as-of timestamp, an array of historical {date, value} pairs up to the requested limit, data source identifier ('eia'), and an attribution string.","failureModes":["Invalid product slug returns an error — only 'wti', 'brent', 'natural-gas', 'gasoline' are accepted","limit parameter exceeding 365 or set to 0/negative returns a validation error","EIA data source unavailable or delayed may return stale as-of dates or null for latest/prior","Payment failure (insufficient USDC balance) returns a 402 response and no data","Network timeout if EIA upstream is slow"],"whenToPreferThis":"Choose this endpoint when you need EIA-sourced energy commodity price data (WTI crude, Brent crude, Henry Hub natural gas, or US retail gasoline) with historical context, prior reading, and change metrics in a single call. Prefer this over general financial data APIs when authoritative government (EIA) sourcing is required, or when your agent needs pay-per-use access without API key management. Best suited for market briefings, energy cost monitoring, macroeconomic analysis, and logistics cost tracking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T12:30:01.916Z","isFirstParty":false}