API Reference

Forecasts

Forward-looking carbon intensity and IEX forward price curves. Available on Pro and above.

Pro tier required

Both endpoints on this page return 402 feature_not_in_plan for Trial and Starter keys. Upgrade to Pro to enable — see Pricing.

GET/developer/v1/forecast/carbon-intensitypro+

Hour-by-hour carbon intensity forecast over the next 48 hours. Built from a weather-adjusted demand forecast and declared availability curves.

Query parameters

horizon_hintegerdefault: 24
Forecast horizon in hours. Max 48.
statestring
Optional state slug (Pro+ can use).

json

{
  "as_of": "2026-04-20T14:30:00Z",
  "scope": "national",
  "horizon_h": 24,
  "forecast": [
    { "ts": "2026-04-20T15:00:00Z", "intensity_gco2_per_kwh": 688, "confidence": 0.91 },
    { "ts": "2026-04-20T16:00:00Z", "intensity_gco2_per_kwh": 701, "confidence": 0.89 }
  ]
}

GET/developer/v1/forecast/iex-forward-curvepro+

Expected DAM clearing price curve over the next 7 days, block by block. Built from historical patterns conditioned on the current weather and holiday calendar.

Query parameters

horizon_daysintegerdefault: 3
Forecast horizon in days. Max 7.
marketenumdefault: dam
dam (default) or rtm.

json

{
  "as_of": "2026-04-20T14:30:00Z",
  "market": "dam",
  "horizon_days": 3,
  "curve": [
    { "ts": "2026-04-20T15:00:00Z", "block": 61, "price": 4920, "p10": 3820, "p90": 6180 },
    { "ts": "2026-04-20T15:15:00Z", "block": 62, "price": 4880, "p10": 3780, "p90": 6090 }
  ],
  "unit": "INR/MWh"
}

p10 and p90 bound an 80% prediction interval. Use these for risk-aware bidding and BESS dispatch optimisation rather than the point forecast alone.