{"uid":"cap_Dc2uO1AwaiTKXPFE2lSLi","slug":"2s-energy-generation-mix-7bfba3a8","name":"2s Energy Generation Mix","description":"Electricity generation mix by fuel type for a US state (2-letter) or \"US\", from EIA — the most recent monthly net generation (thousand MWh) broken out by fuel (natural gas, coal, nuclear, solar, wind, hydro, etc.) with each fuel's percent share and the all-fuels total. Public-domain, live-wrap. Use for grid carbon-intensity, decarbonization, and energy-policy reasoning. (For benchmark energy prices use energy.prices; for retail electricity rates by state/sector use energy.electricity-rates.)","url":"https://2s.io/api/energy/generation-mix","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":{"required":["location"],"properties":{"location":{"type":"string","description":"2-letter US state code, or \"US\"."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yh1evjZnWnwD0sFFPldzI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the electricity generation breakdown by fuel type (natural gas, solar, wind, etc.) for a US state or the entire US, sourced from EIA open data.","exampleAgentPrompt":"What's the current electricity generation mix for California — break it down by fuel type with percentages and total megawatthours?","exampleUseCases":null,"resultDescription":"A JSON object containing an array of generation records, each with a location, period (e.g. 2026-03), total generation in thousand MWh, and a list of fuel types with their share percentage, fuel type ID, and generation volume. Includes source metadata from EIA open data.","failureModes":["Invalid or unsupported location code returns an error or empty items array","Missing required 'location' query parameter returns a 400-level error","EIA upstream data unavailable may result in stale or empty response","Non-US location codes (e.g. country codes outside US) are unsupported"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced electricity generation data broken down by fuel type for a US state or nationally. Prefer this over general web search when you need structured, machine-readable energy data with specific MWh figures and percentages directly from EIA.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:33.085Z","isFirstParty":false}