API Reference

IEX market

Verified public paths for Indian Energy Exchange prices and derived analytics. DAM and RTM are available on the versioned developer surface; area prices and green-market analytics are currently mounted on the intelligence surface.

Use these paths, not the stale catalogue URLs

As of 4 May 2026, the slash-style catalogue paths such as /api/intelligence/iex/dam, /api/intelligence/iex/rtm, and /api/intelligence/iex/area-mcp return 404. The mounted production paths are listed below and are the ones new integrations should call.

Authentication and time zones

Send API keys in the X-API-Key header. Timestamps are returned in UTC; IEX delivery blocks are 15-minute IST blocks, so the 00:00 IST delivery block appears as 18:30 UTC on the previous date.

Verified public paths

Use case	Mounted path	Notes
Latest DAM blocks	`/developer/v1/market/iex/latest?market_type=DAM`	Stable v1 envelope: { data, meta }.
Latest RTM blocks	`/developer/v1/market/iex/latest?market_type=RTM`	Stable v1 envelope: { data, meta }.
DAM vs RTM spread	`/developer/v1/market/iex/spread`	Returns 96 delivery-date blocks when both markets are populated.
DAM price-duration curve	`/developer/v1/market/iex/price-duration`	Free keys are currently capped to the recent data window.
Per-area DAM MCP	`/api/intelligence/iex-area-prices`	Mounted intelligence route while the v1 area-price route is being finalized.
GDAM, REC, green premium	`/api/intelligence/iex-green-market`	Mounted intelligence route.
Canonical hourly IEX rollups	`/api/intelligence/iex-canonical`	Use uppercase market_type values: DAM or RTM.

GET/developer/v1/market/iex/latest

Latest cleared DAM or RTM prices per 15-minute block. Use this for current market monitoring, open-access comparisons, short-horizon BESS dispatch screens, and model features that need the most recent exchange prints.

Query parameters

limitintegerdefault: 96
Maximum rows to return, newest first.
market_typestring
Use DAM or RTM. Leave empty to return both.

bash

export ATLAS_API_KEY="..."

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/market/iex/latest?limit=3&market_type=DAM"

json

{
  "data": [
    {
      "timestamp": "2026-05-04T18:15:00+00:00",
      "market_type": "DAM",
      "region": "All India",
      "purchase_bid_mw": "14966.400",
      "sell_bid_mw": "10496.900",
      "mcv_mw": "8069.700",
      "mcp_rs_mwh": "5205.550",
      "source": "iex_dam_snapshot"
    }
  ],
  "meta": {
    "plan": "free",
    "count": 3,
    "freshness_lag_minutes": 15
  }
}

GET/developer/v1/market/iex/spread

DAM minus RTM spread for a delivery date. Positive values mean DAM cleared higher than RTM for that block; negative values mean RTM cleared higher.

Query parameters

datedateRequired
Delivery date in YYYY-MM-DD.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/market/iex/spread?date=2026-05-04"

json

{
  "data": [
    {
      "timestamp": "2026-05-03T18:30:00+00:00",
      "block_index": "0",
      "dam_mcp": "4920.720",
      "dam_mcv": "8124.700",
      "rtm_mcp": "3789.610",
      "rtm_mcv": "5451.500",
      "spread": "1131.110"
    }
  ],
  "meta": {
    "count": 96,
    "date": "2026-05-04"
  }
}

GET/developer/v1/market/iex/price-duration

Sorted DAM clearing prices over the recent data window. Useful for storage revenue screens, merchant-tail stress cases, and tariff-vs-market comparisons.

Query parameters

daysintegerdefault: 30
Requested lookback window. The plan data window may cap the returned days.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/market/iex/price-duration?days=7"

json

{
  "data": [
    {
      "mcp_rs_mwh": "10000.000",
      "timestamp": "2026-05-01T18:15:00+00:00",
      "exceedance_pct": 0.0
    }
  ],
  "meta": {
    "requested_days": 7,
    "returned_days": 5,
    "count": 488
  }
}

GET/api/intelligence/iex-area-prices

Per-area DAM MCP rows with national MCP and divergence. This is the mounted replacement for the stale /api/intelligence/iex/area-mcp catalogue path.

Query parameters

daysintegerdefault: 30
Recent rolling window.
datedate
Optional delivery date filter in YYYY-MM-DD.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/api/intelligence/iex-area-prices?days=1"

json

{
  "items": [
    {
      "timestamp": "2026-05-03T16:30:00+00:00",
      "area": "A1",
      "area_mcp": 3500.28,
      "area_mcv": null,
      "national_mcp": 3500.28,
      "divergence": 0.0
    }
  ],
  "count": 104,
  "area_summary": {
    "A1": {
      "avg_divergence": 0.0,
      "max_divergence": 0.0,
      "min_divergence": 0.0,
      "blocks": 8
    }
  }
}

GET/api/intelligence/iex-green-market

GDAM block prices, REC trades, and green premium versus DAM. This route currently lives under the intelligence namespace.

Query parameters

daysintegerdefault: 30
Recent lookback window.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/api/intelligence/iex-green-market?days=5"

json

{
  "gdam": {
    "items": [
      {
        "timestamp": "2026-04-29T16:30:00+00:00",
        "mcp_rs_mwh": 10000.0,
        "mcv_mw": 313.69,
        "purchase_bid_mw": 6993.8,
        "sell_bid_mw": 313.7
      }
    ],
    "count": 488
  },
  "rec": {
    "items": [
      {
        "session_date": "2026-04-29",
        "rec_type": "combined",
        "clearing_price_rs": 370.0,
        "volume_traded": 71014.0
      }
    ],
    "count": 1
  },
  "green_premium": {
    "gdam_avg_mcp": 4869.25,
    "dam_avg_mcp": 3599.24,
    "premium_rs_mwh": 1270.01,
    "premium_pct": 35.3
  }
}

GET/api/intelligence/iex-canonical

Canonical hourly IEX rollups used by dashboards and model features. Use uppercase market type filters.

Query parameters

market_typestring
Optional. Use uppercase DAM or RTM.
regionstring
Optional region filter.
metricstring
Optional metric filter such as mcp_rs_mwh or mcv_mw.
hoursintegerdefault: 48
Lookback window.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/api/intelligence/iex-canonical?market_type=DAM&hours=48"

json

{
  "items": [
    {
      "timestamp": "2026-05-02T17:00:00+00:00",
      "market_type": "DAM",
      "region": "all india",
      "metric": "mcp_rs_mwh",
      "value": 10000.0,
      "source": "metered_iex",
      "confidence": 0.95,
      "inputs_json": { "blocks_in_hour": 4 }
    }
  ],
  "count": 94
}

Paths not to use

Earlier catalogue rows advertised slash-style IEX routes. They are not mounted in production today. Use the replacements below.

Stale path	Current replacement
`/api/intelligence/iex/dam`	`/developer/v1/market/iex/latest?market_type=DAM`
`/api/intelligence/iex/rtm`	`/developer/v1/market/iex/latest?market_type=RTM`
`/api/intelligence/iex/gdam`	`/api/intelligence/iex-green-market`
`/api/intelligence/iex/area-mcp`	`/api/intelligence/iex-area-prices`
`/api/intelligence/iex/area-volumes`	No public replacement is mounted yet. Request a sample while the v1 route is being finalized.

Verified public paths

Use case	Mounted path	Notes
Latest DAM blocks	`/developer/v1/market/iex/latest?market_type=DAM`	Stable v1 envelope: { data, meta }.
Latest RTM blocks	`/developer/v1/market/iex/latest?market_type=RTM`	Stable v1 envelope: { data, meta }.
DAM vs RTM spread	`/developer/v1/market/iex/spread`	Returns 96 delivery-date blocks when both markets are populated.
DAM price-duration curve	`/developer/v1/market/iex/price-duration`	Free keys are currently capped to the recent data window.
Per-area DAM MCP	`/api/intelligence/iex-area-prices`	Mounted intelligence route while the v1 area-price route is being finalized.
GDAM, REC, green premium	`/api/intelligence/iex-green-market`	Mounted intelligence route.
Canonical hourly IEX rollups	`/api/intelligence/iex-canonical`	Use uppercase market_type values: DAM or RTM.

GET/developer/v1/market/iex/latest

Query parameters

limitintegerdefault: 96
Maximum rows to return, newest first.
market_typestring
Use DAM or RTM. Leave empty to return both.

bash

export ATLAS_API_KEY="..."

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/market/iex/latest?limit=3&market_type=DAM"

json

{
  "data": [
    {
      "timestamp": "2026-05-04T18:15:00+00:00",
      "market_type": "DAM",
      "region": "All India",
      "purchase_bid_mw": "14966.400",
      "sell_bid_mw": "10496.900",
      "mcv_mw": "8069.700",
      "mcp_rs_mwh": "5205.550",
      "source": "iex_dam_snapshot"
    }
  ],
  "meta": {
    "plan": "free",
    "count": 3,
    "freshness_lag_minutes": 15
  }
}

GET/developer/v1/market/iex/spread

DAM minus RTM spread for a delivery date. Positive values mean DAM cleared higher than RTM for that block; negative values mean RTM cleared higher.

Query parameters

datedateRequired
Delivery date in YYYY-MM-DD.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/market/iex/spread?date=2026-05-04"

json

{
  "data": [
    {
      "timestamp": "2026-05-03T18:30:00+00:00",
      "block_index": "0",
      "dam_mcp": "4920.720",
      "dam_mcv": "8124.700",
      "rtm_mcp": "3789.610",
      "rtm_mcv": "5451.500",
      "spread": "1131.110"
    }
  ],
  "meta": {
    "count": 96,
    "date": "2026-05-04"
  }
}

GET/developer/v1/market/iex/price-duration

Sorted DAM clearing prices over the recent data window. Useful for storage revenue screens, merchant-tail stress cases, and tariff-vs-market comparisons.

Query parameters

daysintegerdefault: 30
Requested lookback window. The plan data window may cap the returned days.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/developer/v1/market/iex/price-duration?days=7"

json

{
  "data": [
    {
      "mcp_rs_mwh": "10000.000",
      "timestamp": "2026-05-01T18:15:00+00:00",
      "exceedance_pct": 0.0
    }
  ],
  "meta": {
    "requested_days": 7,
    "returned_days": 5,
    "count": 488
  }
}

GET/api/intelligence/iex-area-prices

Per-area DAM MCP rows with national MCP and divergence. This is the mounted replacement for the stale /api/intelligence/iex/area-mcp catalogue path.

Query parameters

daysintegerdefault: 30
Recent rolling window.
datedate
Optional delivery date filter in YYYY-MM-DD.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/api/intelligence/iex-area-prices?days=1"

json

{
  "items": [
    {
      "timestamp": "2026-05-03T16:30:00+00:00",
      "area": "A1",
      "area_mcp": 3500.28,
      "area_mcv": null,
      "national_mcp": 3500.28,
      "divergence": 0.0
    }
  ],
  "count": 104,
  "area_summary": {
    "A1": {
      "avg_divergence": 0.0,
      "max_divergence": 0.0,
      "min_divergence": 0.0,
      "blocks": 8
    }
  }
}

GET/api/intelligence/iex-green-market

GDAM block prices, REC trades, and green premium versus DAM. This route currently lives under the intelligence namespace.

Query parameters

daysintegerdefault: 30
Recent lookback window.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/api/intelligence/iex-green-market?days=5"

json

{
  "gdam": {
    "items": [
      {
        "timestamp": "2026-04-29T16:30:00+00:00",
        "mcp_rs_mwh": 10000.0,
        "mcv_mw": 313.69,
        "purchase_bid_mw": 6993.8,
        "sell_bid_mw": 313.7
      }
    ],
    "count": 488
  },
  "rec": {
    "items": [
      {
        "session_date": "2026-04-29",
        "rec_type": "combined",
        "clearing_price_rs": 370.0,
        "volume_traded": 71014.0
      }
    ],
    "count": 1
  },
  "green_premium": {
    "gdam_avg_mcp": 4869.25,
    "dam_avg_mcp": 3599.24,
    "premium_rs_mwh": 1270.01,
    "premium_pct": 35.3
  }
}

GET/api/intelligence/iex-canonical

Canonical hourly IEX rollups used by dashboards and model features. Use uppercase market type filters.

Query parameters

market_typestring
Optional. Use uppercase DAM or RTM.
regionstring
Optional region filter.
metricstring
Optional metric filter such as mcp_rs_mwh or mcv_mw.
hoursintegerdefault: 48
Lookback window.

bash

curl -sS \
  -H "X-API-Key: $ATLAS_API_KEY" \
  "https://api.energymap.in/api/intelligence/iex-canonical?market_type=DAM&hours=48"

json

{
  "items": [
    {
      "timestamp": "2026-05-02T17:00:00+00:00",
      "market_type": "DAM",
      "region": "all india",
      "metric": "mcp_rs_mwh",
      "value": 10000.0,
      "source": "metered_iex",
      "confidence": 0.95,
      "inputs_json": { "blocks_in_hour": 4 }
    }
  ],
  "count": 94
}

Paths not to use

Earlier catalogue rows advertised slash-style IEX routes. They are not mounted in production today. Use the replacements below.

Stale path	Current replacement
`/api/intelligence/iex/dam`	`/developer/v1/market/iex/latest?market_type=DAM`
`/api/intelligence/iex/rtm`	`/developer/v1/market/iex/latest?market_type=RTM`
`/api/intelligence/iex/gdam`	`/api/intelligence/iex-green-market`
`/api/intelligence/iex/area-mcp`	`/api/intelligence/iex-area-prices`
`/api/intelligence/iex/area-volumes`	No public replacement is mounted yet. Request a sample while the v1 route is being finalized.