India Energy Atlas

Reference

Data API Catalogue

Status17 under 2h lagUp to 16 years history

Endpoint groups

Browse catalogue namespaces

Each group shows the source domain, endpoint count and live-data posture before you open a row.

40 of 40 datasets

API namespace

Grid

Demand, frequency and transmission-system operating signals.

4 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

National grid frequency, recorded continuously. Useful for ancillary-services and balancing modelling.

/api/intelligence/grid-frequency
national4-minsince 1 Jan 20241 May 202642m
FreeDeveloperEnterprise
direct scrapePOSOCO + NLDC SCADA
Docs

Per-state grid frequency observations from individual SLDC scrapers.

/api/intelligence/grid-frequency?state=<state>
per_state5-minsince 1 Jan 20251 May 202652m
DeveloperEnterprise
direct scrapeState SLDCs (PSTCL, APTRANSCO, GUJSLDC, …)
Docs

Net interstate flow (MW), in-state generation, and demand for every state. Sourced from POSOCO NPP + SRLDC publications.

/api/developer/v1/state-interchange
per_state15-minsince 1 Jan 20241 May 202642m
DeveloperEnterprise
direct scrapePOSOCO NPP + RLDC publications
Docs

Available Transfer Capability (ATC) revisions on inter-regional corridors, parsed from Grid-India NLDC publications. Joinable with congestion blocks for attribution.

/api/intelligence/atc-revisions
per_corridorper_eventsince 1 Oct 202514 Apr 202617d
DeveloperEnterprise
direct scrapeGrid-India NLDC
Docs

API namespace

Demand

Historical, latest and forecast load series for national and state views.

5 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Raw 15-min metered demand directly from each state's SLDC. Includes peak, frequency, and source-document provenance.

/api/v1/electricity-demand
per_state15-minsince 1 Jan 20141 May 202652m
FreeDeveloperEnterprise
direct scrapeState SLDCs + POSOCO
Docs

LightGBM-modelled state demand for slots/states where the official SLDC source was unavailable. Explicitly labelled `modelled` so production users can filter.

/api/intelligence/demand-timeseries?mode=modeled
per_state15-minsince 1 Jan 20242 May 2026-518m
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

4-minute national demand from POSOCO/MERIT. Highest-cadence national demand series available.

/api/intelligence/demand/national-4min
national4-minsince 1 Jan 2024
DeveloperEnterprise
direct scrapePOSOCO MERIT
Docs

LightGBM 24-hour demand forecast for every state, refreshed hourly. Versioned forecast log accumulates from 2026-04 onwards for backtest use.

/api/intelligence/demand-forecast
per_state + nationalHourlysince 1 Jan 20262 May 2026-518m
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

Every demand-forecast vintage as it was published. Use for honest backtests against true as-of forecasts (no look-ahead).

/api/intelligence/demand-forecast/versions
per_state + nationalHourlysince 22 Apr 2026
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

API namespace

IEX

DAM, RTM, area MCP, congestion and exchange-clearing datasets.

5 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

The headline product. Per-area MCPs across all 13 IEX bid areas for every congested block, with provenance to Grid-India ATC PDFs and confidence scores. Only public source that ships this fused view.

/api/intelligence/iex/area-mcp
per-area (13 zones)15-minsince 2 Mar 2025
DeveloperEnterprise
inferredIEX × Grid-India NLDC
Docs

All Day-Ahead Market blocks across India: MCP, MCV, congestion flag, area split. The deepest IEX history available outside member-portal access.

/api/intelligence/iex/dam
national + per-area (13 zones)15-minsince 1 Jan 20141 May 2026-23m
FreeDeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

Real-Time Market clearing prices and volumes across India, with congestion flags. Updated within the same trading hour.

/api/intelligence/iex/rtm
national + per-area (13 zones)15-minsince 1 Jun 20201 May 202637m
FreeDeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

Green Day-Ahead Market clearing prices, volumes, and Renewable Energy Certificate trades.

/api/intelligence/iex/gdam
national15-minsince 1 Apr 20221 May 2026-23m
FreeDeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

Bid-area volumes (MW, buy + sell) for DAM, RTM, GDAM, and HP-DAM. Useful for liquidity/spread modelling.

/api/intelligence/iex/area-volumes
per-area (13 zones)15-minsince 1 Feb 2024
DeveloperEnterprise
direct scrapeIEX iexindia.com
Docs

API namespace

Market

Prices, spreads, open-access charges and commercial market context.

3 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Per-state retail tariff structures from SERC orders.

/api/v1/electricity-tariffs
per_stateper_eventsince 1 Jan 2018
FreeDeveloperEnterprise
direct scrapeSERC tariff orders
Docs

Per-state open-access wheeling, transmission, and cross-subsidy surcharges. Critical for IEX bilateral cost-stack modelling.

/api/intelligence/open-access-charges
per_stateper_eventsince 1 Jan 2020
DeveloperEnterprise
derivedSERC tariff orders + Atlas curation
Docs

Tracked public investment announcements with state, sector, value, and timeline.

/api/v1/energy-investments
per_state + nationalper_eventsince 1 Jan 2020
FreeDeveloperEnterprise
direct scrapePublic announcements
Docs

API namespace

Generation

Fuel mix, plant output and source-level generation records.

3 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

4-minute fuel-wise generation (coal, gas, hydro, nuclear, renewables) for the national grid.

/api/intelligence/fuel-mix/national-4min
national4-minsince 1 Jan 20241 May 202652m
DeveloperEnterprise
direct scrapePOSOCO MERIT
Docs

Per-state fuel mix at hourly cadence. Constrained allocator (not LightGBM) — splits national fuel mix across states by installed-capacity weights anchored to state-level metered totals.

/api/intelligence/fuel-mix
per_stateHourlysince 1 Jun 20241 May 202652m
DeveloperEnterprise
modelledEnergymap modelled layer
Docs

Plant-level and state-level generation history from NPP + CEA publications.

/api/v1/generation-timeseries
per_state + nationalDailysince 1 Jan 20181 May 20261h
FreeDeveloperEnterprise
direct scrapeNPP + CEA
Docs

API namespace

Carbon

Carbon-intensity estimates, factors and fuel-linked emissions views.

1 endpoint
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Per-state hourly carbon intensity (gCO2/kWh) derived from fuel-mix and emission factors.

/api/intelligence/carbon-intensity
per_stateHourlysince 1 Jun 20241 May 202652m
FreeDeveloperEnterprise
derivedDerived (Energymap)
Docs

API namespace

Operations

Freshness, health, PSP and reliability signals for production monitoring.

2 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

5-year daily power supply position per state and region: peak demand, peak met, energy met, shortage. Sourced from POSOCO PSP PDFs.

/api/intelligence/posoco-psp
per_state + per_regionDailysince 1 Jan 201422 Apr 20269d
FreeDeveloperEnterprise
direct scrapePOSOCO daily PSP report
Docs

Daily CEA power supply position table.

/api/v1/power-supply-position
per_state + per_regionDailysince 1 Jan 201830 Nov 2025152d
FreeDeveloperEnterprise
direct scrapeCEA
Docs

API namespace

Assets

Plant registers, renewable capacity and infrastructure reference data.

4 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Installed-capacity inventory of power plants across India with location, fuel, commissioning year, and operator.

/api/v1/power-plants
per_state + nationalper_eventsince 1 Jan 20101 May 202647m
FreeDeveloperEnterprise
direct scrapeNPP + CEA installed capacity
Docs

Tabular transmission-line inventory by state. Separate from the geospatial Atlas map tiles.

/api/v1/transmission-lines
per_state + nationalper_eventsince 1 Jan 20181 May 202647m
FreeDeveloperEnterprise
direct scrapeNPP + Atlas imports
Docs

Operational substations by state with kV class.

/api/v1/substations
per_stateper_eventsince 1 Jan 20181 May 202647m
FreeDeveloperEnterprise
direct scrapeNPP + Atlas imports
Docs

Tracked renewable project pipeline by state.

/api/v1/renewable-projects
per_stateper_eventsince 1 Jan 2020
FreeDeveloperEnterprise
direct scrapeTracked project datasets
Docs

API namespace

Weather

Weather-linked features used by forecasts and grid-demand models.

1 endpoint
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Hourly temperature, humidity, precipitation across 11+ states. Critical exogenous feature for demand forecasts.

/api/intelligence/weather
per_stateHourlysince 1 Jan 20241 May 2026-308m
DeveloperEnterprise
direct scrapeIMD + Open-Meteo
Docs

API namespace

Derived

Modelled or joined datasets produced from multiple upstream sources.

4 endpoints
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

Derived stress score combining demand, generation headroom, and frequency deviation.

/api/v1/derived/grid-stress-index
national + per_stateDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

State and regional renewable-constraint proxy combining generation, transmission capacity, and investment.

/api/v1/derived/renewable-bottleneck-score
per_state + per_regionDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

Rollup index of investment momentum by state.

/api/v1/derived/energy-investment-index
per_stateDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

MAPE between modelled state demand and official metered demand. Quality assurance for the modelled fill.

/api/intelligence/demand-reconciliation
per_stateDailysince 1 Jun 2024
DeveloperEnterprise
derivedDerived (Energymap)
Docs

On the roadmap

8 planned
DatasetScopeCadenceCoverageLatestLagTiersMethodSource

High-Price DAM segment block-level prices and volumes. Currently only area-volumes are scraped; block-level MCP/MCV adds ~1 day of collector work.

/api/intelligence/iex/hp-dam
per-area15-minQ2 2026 — 1 week
DeveloperEnterprise
direct scrapeIEX iexindia.complanned

Term-Ahead Market trades — weekly/monthly contracts. Not yet ingested.

/api/intelligence/iex/tam
nationalper_eventQ3 2026
DeveloperEnterprise
direct scrapeIEX iexindia.complanned

Per-category GDAM split (solar, non-solar, hydro) — currently the IEIO collector persists only aggregate columns.

/api/intelligence/iex/gdam-categories
national15-minQ2 2026 — 2 days collector work
DeveloperEnterprise
direct scrapeIEX iexindia.complanned

Dense daily TTC and ATC values for every inter-regional corridor — backfilled from Grid-India daily PDFs.

/api/intelligence/ttc-atc
per_corridorDailyQ2 2026 — slug discovery in progress
DeveloperEnterprise
direct scrapeGrid-India daily VDI/TTC publicationsplanned

Plant-level forced and planned outages from Grid-India publications.

/api/intelligence/plant-outages
per_plantper_eventQ3 2026 — 8-12 weeks
DeveloperEnterprise
direct scrapeGrid-India outage noticesplanned

Forecast solar/wind generation per state with confidence intervals.

/api/intelligence/re-forecast
per_stateHourlyQ3 2026 — 6-10 weeks
DeveloperEnterprise
modelledEnergymap modelled layerplanned

Spinning, secondary, and tertiary reserves with deployment events.

/api/intelligence/reserves
national + per_region15-minQ3 2026 — 4-6 weeks
Enterprise
direct scrapePOSOCO ancillary publicationsplanned

Domestic coal price tracker and natural gas APM/HPHT prices. Useful for unit-commitment cost stacks.

/api/intelligence/fuel-proxies
nationalDailyQ2 2026 — 4-8 weeks
DeveloperEnterprise
direct scrapeMoP, MoPNG publicationsplanned

About this catalogue

Catalogue metadata and live coverage

The India Energy Atlas API powers every dataset on this page — covering all-India and state-level demand, fuel mix, frequency, IEX per-area MCP across all 13 zones, plant-level outages, ancillary reserves, and modelled fills with explicit provenance tags. Each row carries coverage windows, source provenance, freshness probes, and tier eligibility so you know exactly what you can serve into production.

Catalogue refreshed every 60 seconds · Generated 1 May 2026, 11:22 pm

Live datasets

30

2 in beta

Healthy now

17/30

under 2h lag

Median freshness

47m

p50 lag across live datasets

Deepest history

16+ yr

since 2010

Free

$0

Prototype, academic work, personal dashboards.

  • Unlimited alert rules
  • 3 notifications per day
  • Email + In-app channels
  • All 7 alert domains
  • 1,000 API calls/day (15-min delay)
  • Community support
Most popular

Starter

$19/ month

Production apps and teams on all-India aggregates.

  • Everything in Free
  • Unlimited daily notifications
  • Priority delivery + WhatsApp alerts
  • 10,000 API calls/day at 60/min
  • Real-time data (no delay), 90-day history
  • 3 API keys + IP allow-list
  • Email support, 99.0% SLA

Pro

$3,000/ year

State-level analytics, forecasting, carbon-aware workflows.

  • Everything in Starter
  • State-level data access
  • Forecasts (carbon, forward curve)
  • 100,000 API calls/day at 300/min
  • 3 years of historical data
  • 10 API keys
  • Email + chat support, 99.5% SLA

Enterprise

CustomContact sales

Custom data delivery, signed SLAs, dedicated support.

  • Everything in Pro
  • Unlimited API quota
  • Custom endpoints & data delivery (Kafka, parquet)
  • 10 years of historical data
  • Dedicated Slack support
  • Signed 99.9% SLA

Next step

Build against the catalogue

Generate an API key, test endpoint behaviour in the interactive reference, or review how the current namespaces map to the versioned API.