Developer Docs

Provenance

Where the India Energy Atlas data comes from, how it is classified, and how often each raw pool or derived dataset is refreshed.

EnergyMap separates direct public-source pulls into the Raw Data Pool, then builds Energy Atlas Intelligence datasets on top with canonicalisation, reconciliation, modelling, joins and source tags.

Frequency means the production refresh cadence used by Atlas. Where the upstream source publishes faster or slower than Atlas pulls it, the cell calls that out explicitly.

Raw Data Pool

Data name	Associated API	Source link	Raw Data Pool frequency
State SLDC demand and frequency	`/api/v1/electricity-demand` `/api/intelligence/grid-frequency` `/api/intelligence/state-interchange-canonical`	UPSLDC realtime summary KPTCL SLDC snapshot APTRANSCO realtime Gujarat SLDC Delhi SLDC HP ALDC Punjab SLDC dynamic API APDCL daily power PDF UPCL power position index Kerala SLDC system statistics	Raw Data Pool runs hourly for Atlas; source cadence ranges from live / 5-min feeds to daily summaries.
All-India demand and fuel mix	`/api/intelligence/national-demand-4min` `/api/intelligence/national-fuelmix-4min`	NPP MERIT realtime demand NPP MERIT realtime fuel-wise generation MERIT India	NPP MERIT quick refresh every 15 minutes; source publishes at about 4-minute cadence.
IEX DAM, RTM, GDAM, REC and area prices	`/developer/v1/market/iex/latest?market_type=DAM` `/developer/v1/market/iex/latest?market_type=RTM` `/api/intelligence/iex-area-prices` `/api/intelligence/iex-green-market`	IEX DAM market snapshot IEX RTM market snapshot IEX area prices IEX GDAM market snapshot	15-minute market-block cadence; Atlas canonical refresh runs hourly.
Grid-India ATC corridor revisions	`/api/intelligence/atc-revisions`	Grid-India ATC revisions Grid-India communique API	Daily Raw Data Pool run; upstream changes whenever Grid-India publishes a revision.
Power Supply Position	`/api/intelligence/posoco-psp` `/api/v1/power-supply-position`	Grid-India / POSOCO daily reports CEA API catalogue CEA peak API CEA energy API	Daily.
Generation timeseries and plant inventory	`/api/v1/generation-timeseries` `/api/v1/power-plants`	NPP dashboard CEA power generation API CEA installed capacity publications	NPP DGR2 station-level ingest daily; plant and capacity records update periodically as source publications change.
Transmission lines and substations	`/api/v1/transmission-lines` `/api/v1/substations`	OpenStreetMap India extract NPP dashboard CEA API catalogue State transmission utility source documents	Periodic; refreshed when source inventories or map extracts are updated.
Weather observations	`/api/intelligence/weather`	Open-Meteo forecast API Open-Meteo licence	Hourly for trained demand-model states; daily all-state refresh for dashboards and correlations.
State tariff orders and open-access inputs	`/api/v1/electricity-tariffs` `/api/intelligence/open-access-charges`	State SERC tariff orders Ministry of Power SERC directory	Periodic; refreshed when tariff orders or open-access charge schedules change.
Energy investments and renewable project trackers	`/api/v1/energy-investments` `/api/v1/renewable-projects`	Public project announcements Government and exchange publications	Event-based / periodic.

Energy Atlas Intelligence

Data name	Associated API	Source link	Raw Data Pool frequency
Atlas demand timeseries	`/api/intelligence/demand-timeseries`	State SLDC Raw Data Pool NPP MERIT CEA Power Supply Position APIs	Derived hourly from sub-hourly and daily raw pools; ML inference runs every 15 minutes.
State fuel mix allocator	`/api/intelligence/fuel-mix-timeseries`	NPP MERIT fuel-wise generation NPP DGR2 reports CEA generation datasets MNRE / CEA capacity publications	Derived hourly; inputs refresh every 15 minutes for MERIT, daily for DGR2, and periodically for capacity.
Carbon intensity	`/api/intelligence/carbon-intensity` `/api/intelligence/carbon-intensity/latest`	Atlas canonical fuel mix CEA CO2 Baseline Database IPCC AR6 lifecycle factors	Derived hourly from canonical fuel mix; emission-factor updates are periodic.
Demand forecast	`/api/intelligence/demand-forecast`	Atlas demand timeseries Open-Meteo forecast API	Forecast rows refresh hourly; near-term inference runs every 15 minutes.
Demand reconciliation	`/api/intelligence/demand-reconciliation` `/api/intelligence/demand-accuracy`	State SLDC actuals Atlas modeled demand	Hourly reconciliation over 24h, 7d and 30d windows.
Weather-load correlation	`/api/intelligence/weather-load-correlation`	Open-Meteo weather observations Atlas demand timeseries	Daily, after the overnight all-state weather refresh.
Canonical state interchange and power flows	`/api/intelligence/state-interchange-canonical` `/api/intelligence/power-flows`	State SLDC operational feeds Grid-India / POSOCO reports Atlas modeled state balance	Canonical tables refresh hourly; fallbacks fill recent gaps on the same cycle.
IEX congestion corridor attribution	`/api/intelligence/iex-congestion-corridor-attributions`	Grid-India ATC revisions IEX area prices Atlas corridor-area map	Derived after ATC and IEX area-price inputs refresh.
Open-access charges	`/api/intelligence/open-access-charges`	State SERC tariff orders Atlas curation layer	Periodic; refreshed when tariff-order inputs change.
Grid stress, renewable bottleneck and investment indices	`/api/v1/derived/grid-stress-index` `/api/v1/derived/renewable-bottleneck-score` `/api/v1/derived/energy-investment-index`	Demand, generation and investment raw pools NPP dashboard CEA API catalogue	Daily or periodic, depending on the slowest input dataset.