{"uid":"cap_jkghGOPQkea1GwT7cB6-z","slug":"2s-energy-prices-api-bdc40125","name":"2s Energy Prices API","description":"US energy benchmark prices from the EIA (Energy Information Administration) open data API. Omit series for a one-call snapshot of the latest value of every benchmark; pass series for its recent time series (newest first). Benchmarks: wti_crude / brent_crude ($/barrel), henry_hub_gas ($/MMBtu), gasoline_regular / diesel ($/gallon), electricity_retail (cents/kWh). Each observation has date, value, units, and frequency. Public-domain US government data.","url":"https://2s.io/api/energy/prices","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":12,"maximum":100,"minimum":1,"description":"Observations to return in single-series mode (1-100). Default 12. Ignored in snapshot mode."},"series":{"enum":["wti_crude","brent_crude","henry_hub_gas","gasoline_regular","diesel","electricity_retail"],"type":"string","description":"Optional benchmark id. Omit for a snapshot of all benchmarks. One of: wti_crude, brent_crude, henry_hub_gas, gasoline_regular, diesel, electricity_retail."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":12,"series":"henry_hub_gas"}}},"response":{"data":{"ok":true,"meta":{"mode":"series","query":{"limit":12,"series":"henry_hub_gas"}},"items":[{"date":"2026-06-12","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":3.16,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-06-05","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":3.03,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-05-29","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":3.16,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-05-22","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":3.11,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-05-15","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.86,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-05-08","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.74,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-05-01","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.66,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-04-24","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.7,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-04-17","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.77,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-04-10","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.85,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-04-03","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.9,"series":"henry_hub_gas","frequency":"weekly"},{"date":"2026-03-27","label":"Henry Hub natural gas spot price","units":"$/MMBtu","value":2.95,"series":"henry_hub_gas","frequency":"weekly"}],"total":12,"source":{"url":"https://www.eia.gov/opendata/","license":"EIA open data — public domain (US Government work). Live-wrapped.","provider":"U.S. Energy Information Administration (EIA)"}},"meta":{"cost":{"usd":0.00288,"tier":0},"caller":"x402","version":null,"endpoint":"energy.prices","settlement":{"txHash":"0x4a9f047cc3798aff3844e53140a13e646ab7c30ea2403fc7fc9a3420d384e992","network":"eip155:8453","success":true}}}},"exampleRequest":{"limit":12,"series":"henry_hub_gas"},"tags":["x402"],"displayCostAmount":"0.00288","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00288/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z9rp4WdujkJ2B5yE6MKvF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0072","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current and historical benchmark energy prices (crude oil, natural gas, gasoline, diesel, electricity) as time-series or snapshot data.","exampleAgentPrompt":"What are the last 12 price readings for Henry Hub natural gas? I want the full time series.","exampleUseCases":null,"resultDescription":"A JSON object with an array of price observations, each containing the benchmark series ID, human-readable label, date, numeric value, units (e.g. USD/barrel), and reporting frequency. Also includes metadata about the query mode (snapshot or series), total row count, and data source provenance (provider name, URL, license).","failureModes":["Invalid series enum value returns a validation error","limit out of range (below 1 or above 100) returns a 400-level error","Upstream data provider unavailable may return stale or empty items array","Missing payment or insufficient USDC balance returns HTTP 402"],"whenToPreferThis":"Use this endpoint when you need ground-truth, regularly updated benchmark energy prices (WTI crude, Brent crude, Henry Hub gas, retail gasoline, diesel, electricity) without needing to sign up for an API key. Ideal for AI agents that need pay-per-call access to official energy price data for financial analysis, cost modeling, or market monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:06:42.852Z","isFirstParty":false}