API Reference

Fuel mix & carbon

Modelled fuel mix (coal, gas, hydro, nuclear, solar, wind, other) and grid carbon intensity. Both derived from the same upstream: demand + declared plant availability + IEX scheduling.

How the modelled mix is computed

We do not rely on a single centralised fuel-mix feed — India does not publish one in real time. Instead, the mix is reconstructed from SLDC demand, POSOCO declared availability, and IEX DAM/RTM schedules, calibrated weekly against CEA monthly totals. Expect ±3% error on national aggregates, ±6% on state-level.

GET/developer/v1/fuel-mix/latestpro+

Most recent fuel mix breakdown. National on all tiers; state-level on Pro and above.

Query parameters

statestring
Optional state slug. Requires Pro+. Omit for national mix.

json

{
  "as_of": "2026-04-20T14:30:00Z",
  "scope": "national",
  "mix_mw": {
    "coal": 138200,
    "gas": 6900,
    "hydro": 23800,
    "nuclear": 5100,
    "solar": 32400,
    "wind": 7800,
    "other": 4250
  },
  "mix_pct": {
    "coal": 0.633,
    "gas": 0.032,
    "hydro": 0.109,
    "nuclear": 0.023,
    "solar": 0.148,
    "wind": 0.036,
    "other": 0.019
  }
}

GET/developer/v1/carbon-intensity/latestpro+

Grid carbon intensity in gCO₂/kWh derived from the fuel mix with per-fuel emission factors.

Query parameters

statestring
Optional state slug. Requires Pro+.

Emission factors used: coal 1050 gCO₂/kWh, gas 490, oil 880, hydro/nuclear/solar/wind 0. Full factor table at /developer/v1/carbon-intensity/factors.

json

{
  "as_of": "2026-04-20T14:30:00Z",
  "scope": "national",
  "intensity_gco2_per_kwh": 692,
  "dominant_fuel": "coal"
}