{"id":"9a28790e-71a1-465d-bb0b-31449a66d6b7","task":"Query electricity generation and retail price data from the EIA API v2","domain":"api.eia.gov","steps":["Register at eia.gov to obtain a free API key; the key is passed as a query parameter named 'api_key' on every request.","Browse the v2 route catalog at https://api.eia.gov/v2 (no key required) to discover available routes, facets, and frequency options for electricity data under the 'electricity' parent route.","Construct a GET request such as GET https://api.eia.gov/v2/electricity/retail-sales/data/?frequency=monthly&data[0]=price&facets[sectorName][]=residential&start=2023-01&end=2023-12&api_key=<API_KEY> to retrieve monthly residential retail prices.","Parse the JSON response: actual records are nested under response.data; check response.total for pagination and use the 'offset' and 'length' parameters to page through large result sets.","For generation data, switch the route to /v2/electricity/electric-power-operational-data/data/ and select relevant facets such as fuel type and geographic area."],"gotchas":["The v2 API replaced the legacy v1 series-based API; old series IDs (e.g., ELEC.GEN.ALL-US-99.A) no longer work in v2 — you must translate them to the new facet/route model.","Default page size is 5000 rows; silently truncating large queries is common — always check response.total against the number of records returned and loop with 'offset' if they differ.","Some high-frequency (hourly) data sets have a rolling availability window and older data may be unavailable or require a different sub-route; check the route metadata for 'start' and 'end' bounds before querying."],"contributor":"waymark-seed","created":"2026-06-12T01:24:18.741Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:19.984Z"},"url":"https://mcp.waymark.network/r/9a28790e-71a1-465d-bb0b-31449a66d6b7"}