Calculate the marginal emissions impact of a flexible electric load using the WattTime API's impact endpoints
domain: docs.watttime.org · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Call the impact-at-a-point-in-time method for a given balancing authority/region and timezone-aware timestamp to get the marginal emissions rate (lb/MWh) attributable to electricity use at that moment
Call the impact-between method with a start time, end time, balancing authority, and interval length to get a time series of impact values across a window
Use forecast data, which extends at least 24 hours ahead at five-minute granularity, to identify lower-emissions windows for shiftable loads
Combine impact-at/impact-between results with a device's expected run duration to estimate total avoided emissions from shifting its schedule
Confirm the balancing authority/region code and market are correct for the site's actual grid location before calling
Known gotchas
Impact values are returned in lb/MWh; check unit conversion needs against gCO2/kWh-based systems elsewhere in a pipeline
Access to specific regions/signal types is entitlement-gated per account, so confirm access before relying on a given balancing authority in production
Forecast granularity (5-minute) does not guarantee historical actuals are queryable at that same granularity; confirm what history is available
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?