Query state- and sector-level coal production, consumption, and quality data from the EIA API v2 coal route
domain: api.eia.gov · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Use the same api_key and route/facets/data pattern as other EIA v2 categories, rooted at api.eia.gov/v2/coal/.
Browse the API Dashboard at eia.gov/opendata/browser/coal to find current sub-route names and facet options before hardcoding paths, since coal sub-routes are reorganized more often than the flagship electricity routes.
Filter by state, sector, or coal-rank facet as exposed by the route's own metadata.
Always terminate the request path with /data to get actual rows rather than metadata.
Page through results with length/offset, respecting the 5,000-row-per-call cap.
Known gotchas
Exact coal sub-route path segments have changed between EIA API revisions — confirm the live path in the API browser rather than trusting older references.
Some coal series (e.g. heat content, sulfur/ash content) are only available at annual or quarterly frequency, not monthly — check the frequency facet before assuming granularity.
As with all EIA v2 routes, omitting /data silently returns metadata instead of an error.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?