๐Ÿ‡ฎ๐Ÿ‡ณIndiaโ€ขIEX/Exchange Metadata & Regional Registry

Exchange Metadata & Regional Registry

Retrieve valid state codes, bid area mappings, dataset identifiers, and available date bounds.

Provides complete metadata for Indian electricity markets. Filter by ?section (states, intervals, markets, auction), ?market (dam, gdam, state_dam, state_gdam), or ?type/?scope (national, state). Select choices below to customize query parameters.
โšกFree Discovery (No Rate Limit Cost)Market:IEX
GET/api/v1/iex/meta/

Headers

Pass in HTTP request headers
Acceptstring (header)optional
Accept: application/json

Expected response format (No API Key Required).

Query Parameters (3)

Set optional filters below to customize the query
sectionstring (choice)optional

Isolate a specific metadata category. Leave on "All Sections" to receive the complete consolidated discovery payload.

Accepted Options:Click to filter (none selected by default)
marketstring (choice)optional

Filter market catalog by specific market code or alias. Filters the markets list in full response or when ?section=markets.

Accepted Options:Click to filter (none selected by default)
typestring (choice)optional

Filter markets by operational geographic scope: national (All-India) vs. state (Regional). Also accepts ?scope= alias.

Accepted Options:Click to filter (none selected by default)

Response Schema Attributes

FieldTypeDescription
exchangestringPower exchange name and designation (Indian Energy Exchange).
timezonestringOperational grid timezone (Asia/Kolkata IST, UTC+05:30).
marketsarray of objectsSupported market catalogs (DAM, GDAM, State DAM, State GDAM) with endpoint routes and metrics.
intervalsarray of objectsTechnical specifications for 15-minute, hourly, daily, monthly, and yearly intervals.
available_statesarray of objectsList of all 36 Indian states and Union Territories available for state query filtering.
auction_mechanismobjectAuction structure, 10:00-12:00 IST bidding window, and 16:00 IST clearing schedule.
curl "http://52.66.240.39:8000/api/v1/iex/meta/" \
  -H "Accept: application/json"
{
  "data": {
    "exchange": "Indian Energy Exchange (IEX)",
    "timezone": "Asia/Kolkata (IST, UTC+05:30)",
    "markets": [
      {
        "identity": "Day-Ahead Market (DAM)",
        "market_code": "iex_dam",
        "alias": "dam",
        "scope": "national",
        "source": {
          "identity": "Indian Energy Exchange",
          "code": "IEX",
          "website": "https://www.iexindia.com"
        },
        "dataset": {
          "identity": "Day Ahead Market",
          "code": "DAM",
          "website": "https://www.iexindia.com/market-data/day-ahead-market/market-snapshot"
        },
        "coverage": {
          "earliest_date": "2012-04-01",
          "latest_date": "2026-10-13",
          "current_date_ist": "2026-10-13",
          "current_time_ist": "00:05:47 IST",
          "total_days_available": 5309,
          "is_next_day_delivery_cleared": false,
          "auction_clearing_status": "Pre-Auction Window (T+1 data clears at 16:00 IST)"
        },
        "description": "National physical electricity market operating on a day-ahead basis for next-day delivery. Contracts are traded in 15-minute time blocks with closed double-sided uniform price auctions, generating official Market Clearing Price (MCP) and Market Clearing Volume (MCV).",
        "key_metrics": {
          "purchase_bid": "Total buy bid volume in MW",
          "sell_bid": "Total sell bid volume in MW",
          "mcv": "Market Clearing Volume in MW",
          "fsv": "Final scheduled physical volume in MW",
          "mcp_mwh": "Market Clearing Price in Rs / MWh",
          "mcp_kwh": "Market Clearing Price in Rs / kWh"
        },
        "endpoints": {
          "15min": "/api/v1/iex/dam/list/",
          "hourly": "/api/v1/iex/dam/hourly/list/",
          "daily": "/api/v1/iex/dam/daily/list/",
          "monthly": "/api/v1/iex/dam/monthly/list/",
          "yearly": "/api/v1/iex/dam/yearly/list/"
        }
      },
      {
        "identity": "Green Day-Ahead Market (GDAM)",
        "market_code": "iex_gdam",
        "alias": "gdam",
        "scope": "national",
        "source": {
          "identity": "Indian Energy Exchange",
          "code": "IEX",
          "website": "https://www.iexindia.com"
        },
        "dataset": {
          "identity": "Green Day Ahead Market",
          "code": "GDAM",
          "website": "https://www.iexindia.com/market-data/green-day-ahead-market/market-snapshot"
        },
        "coverage": {
          "earliest_date": "2021-11-01",
          "latest_date": "2026-10-13",
          "current_date_ist": "2026-10-13",
          "current_time_ist": "00:05:47 IST",
          "total_days_available": 1808,
          "is_next_day_delivery_cleared": false,
          "auction_clearing_status": "Pre-Auction Window (T+1 data clears at 16:00 IST)"
        },
        "description": "Dedicated day-ahead marketplace for renewable energy generators and obligated entities. Provides granular volume breakdowns across renewable generation sources (Solar, Non-Solar, Hydro, Wind, Other RE, and Distributed RE).",
        "renewable_segments": [
          "Solar",
          "Non-Solar",
          "Hydro",
          "Wind",
          "Other RE (Renewable Energy)",
          "DRE (Distributed Renewable Energy)"
        ],
        "endpoints": {
          "15min": "/api/v1/iex/gdam/list/",
          "hourly": "/api/v1/iex/gdam/hourly/list/",
          "daily": "/api/v1/iex/gdam/daily/list/",
          "monthly": "/api/v1/iex/gdam/monthly/list/",
          "yearly": "/api/v1/iex/gdam/yearly/list/"
        }
      },
      {
        "identity": "State Day-Ahead Market (State DAM)",
        "market_code": "iex_state_dam",
        "alias": "state_dam",
        "scope": "state",
        "source": {
          "identity": "Indian Energy Exchange",
          "code": "IEX",
          "website": "https://www.iexindia.com"
        },
        "dataset": {
          "identity": "State Day Ahead Market",
          "code": "STATE_DAM",
          "website": "https://iexrtmprice.com/DSM_Data/"
        },
        "coverage": {
          "earliest_date": "2012-04-01",
          "latest_date": "2026-10-13",
          "current_date_ist": "2026-10-13",
          "current_time_ist": "00:05:47 IST",
          "total_days_available": 5309,
          "is_next_day_delivery_cleared": false,
          "auction_clearing_status": "Pre-Auction Window (T+1 data clears at 16:00 IST)"
        },
        "description": "State-disaggregated Day-Ahead Market data providing regional cleared buy/sell volumes and localized weighted prices for all Indian states and Union Territories. Requires the mandatory ?state= query parameter.",
        "key_metrics": {
          "cleared_buy": "Cleared buy volume for state in MW",
          "cleared_sell": "Cleared sell volume for state in MW",
          "price_mwh": "State weighted price in Rs / MWh",
          "price_kwh": "State weighted price in Rs / kWh"
        },
        "required_query_param": "state (e.g. ?state=MH or ?state=GJ)",
        "endpoints": {
          "15min": "/api/v1/iex/state-dam/list/",
          "hourly": "/api/v1/iex/state-dam/hourly/list/",
          "daily": "/api/v1/iex/state-dam/daily/list/",
          "monthly": "/api/v1/iex/state-dam/monthly/list/",
          "yearly": "/api/v1/iex/state-dam/yearly/list/"
        }
      },
      {
        "identity": "State Green Day-Ahead Market (State GDAM)",
        "market_code": "iex_state_gdam",
        "alias": "state_gdam",
        "scope": "state",
        "source": {
          "identity": "Indian Energy Exchange",
          "code": "IEX",
          "website": "https://www.iexindia.com"
        },
        "dataset": {
          "identity": "State Green Day Ahead Market",
          "code": "STATE_GDAM",
          "website": "https://iexrtmprice.com/DSM_Data/"
        },
        "coverage": {
          "earliest_date": "2021-11-01",
          "latest_date": "2026-10-13",
          "current_date_ist": "2026-10-13",
          "current_time_ist": "00:05:47 IST",
          "total_days_available": 1808,
          "is_next_day_delivery_cleared": false,
          "auction_clearing_status": "Pre-Auction Window (T+1 data clears at 16:00 IST)"
        },
        "description": "State-disaggregated Green Day-Ahead Market data providing renewable cleared buy/sell volumes and state-level weighted prices. Requires the mandatory ?state= query parameter.",
        "required_query_param": "state (e.g. ?state=MH or ?state=TN)",
        "endpoints": {
          "15min": "/api/v1/iex/state-gdam/list/",
          "hourly": "/api/v1/iex/state-gdam/hourly/list/",
          "daily": "/api/v1/iex/state-gdam/daily/list/",
          "monthly": "/api/v1/iex/state-gdam/monthly/list/",
          "yearly": "/api/v1/iex/state-gdam/yearly/list/"
        }
      }
    ],
    "intervals": [
      {
        "name": "15-Minute (Time Block)",
        "code": "fifteen_minute",
        "units_per_day": 96,
        "description": "The primary operational unit of the Indian electricity grid under CERC regulations. The 24-hour trading day (00:00 to 24:00 IST) is discretized into exactly 96 individual 15-minute time blocks (4 blocks per hour x 24 hours = 96 blocks).",
        "block_indexing": {
          "block_1": "00:00 - 00:15 (Hour 1)",
          "block_2": "00:15 - 00:30 (Hour 1)",
          "block_3": "00:30 - 00:45 (Hour 1)",
          "block_4": "00:45 - 01:00 (Hour 1)",
          "block_96": "23:45 - 24:00 (Hour 24)"
        },
        "applicable_filters": [
          "date (YYYY-MM-DD)",
          "start_date (YYYY-MM-DD)",
          "end_date (YYYY-MM-DD)",
          "time_block (1-96)",
          "hour (1-24)",
          "start_time (HH:MM)",
          "end_time (HH:MM)",
          "state (State code, e.g. MH - for state endpoints)"
        ]
      },
      {
        "name": "Hourly",
        "code": "hourly",
        "units_per_day": 24,
        "description": "Volume-weighted hourly aggregation spanning hours 1 to 24. Calculated as sum(MCV * MCP) / sum(MCV) across the four 15-minute blocks in each hour.",
        "applicable_filters": [
          "date",
          "start_date",
          "end_date",
          "hour (1-24)",
          "state"
        ]
      },
      {
        "name": "Daily",
        "code": "daily",
        "units_per_day": 1,
        "description": "Daily summary providing total traded volumes and the day's volume-weighted average price.",
        "applicable_filters": [
          "date",
          "start_date",
          "end_date",
          "state"
        ]
      },
      {
        "name": "Monthly",
        "code": "monthly",
        "units_per_day": null,
        "description": "Monthly summary indexed by year and month (1-12) with cumulative volume totals and volume-weighted prices.",
        "applicable_filters": [
          "year",
          "month (1-12)",
          "start_year",
          "end_year",
          "state"
        ]
      },
      {
        "name": "Yearly",
        "code": "yearly",
        "units_per_day": null,
        "description": "Annual macro summary indexed by calendar year with annual aggregate volumes and annual volume-weighted prices.",
        "applicable_filters": [
          "year",
          "start_year",
          "end_year",
          "state"
        ]
      }
    ],
    "available_states": [
      {
        "code": "AP",
        "identity": "Andhra Pradesh",
        "label": "Andhra Pradesh"
      },
      {
        "code": "AR",
        "identity": "Arunachal Pradesh",
        "label": "Arunachal Pradesh"
      },
      {
        "code": "AS",
        "identity": "Assam",
        "label": "Assam"
      },
      {
        "code": "BR",
        "identity": "Bihar",
        "label": "Bihar"
      },
      {
        "code": "CG",
        "identity": "Chhattisgarh",
        "label": "Chhattisgarh"
      },
      {
        "code": "CH",
        "identity": "Chandigarh",
        "label": "Chandigarh"
      },
      {
        "code": "DD",
        "identity": "Daman and Diu",
        "label": "Daman and Diu"
      },
      {
        "code": "DL",
        "identity": "Delhi",
        "label": "Delhi"
      },
      {
        "code": "DNH",
        "identity": "Dadra and Nagar Haveli",
        "label": "Dadar and Nagar Haveli"
      },
      {
        "code": "GJ",
        "identity": "Gujarat",
        "label": "Gujarat"
      },
      {
        "code": "GOA_S",
        "identity": "Goa (South)",
        "label": "Goa (South)"
      },
      {
        "code": "GOA_W",
        "identity": "Goa (West)",
        "label": "Goa (West)"
      },
      {
        "code": "HP",
        "identity": "Himachal Pradesh",
        "label": "Himachal Pradesh"
      },
      {
        "code": "HR",
        "identity": "Haryana",
        "label": "Haryana"
      },
      {
        "code": "JH",
        "identity": "Jharkhand",
        "label": "Jharkhand"
      },
      {
        "code": "JK",
        "identity": "Jammu and Kashmir",
        "label": "J&K"
      },
      {
        "code": "KA",
        "identity": "Karnataka",
        "label": "Karnataka"
      },
      {
        "code": "KL",
        "identity": "Kerala",
        "label": "Kerala"
      },
      {
        "code": "MH",
        "identity": "Maharashtra",
        "label": "Maharashtra"
      },
      {
        "code": "ML",
        "identity": "Meghalaya",
        "label": "Meghalaya"
      },
      {
        "code": "MN",
        "identity": "Manipur",
        "label": "Manipur"
      },
      {
        "code": "MP",
        "identity": "Madhya Pradesh",
        "label": "MP"
      },
      {
        "code": "MZ",
        "identity": "Mizoram",
        "label": "Mizoram"
      },
      {
        "code": "NL",
        "identity": "Nagaland",
        "label": "Nagaland"
      },
      {
        "code": "OD",
        "identity": "Odisha",
        "label": "Odisha"
      },
      {
        "code": "PB",
        "identity": "Punjab",
        "label": "Punjab"
      },
      {
        "code": "PY",
        "identity": "Puducherry",
        "label": "Puducherry"
      },
      {
        "code": "RJ",
        "identity": "Rajasthan",
        "label": "Rajasthan"
      },
      {
        "code": "SK",
        "identity": "Sikkim",
        "label": "Sikkim"
      },
      {
        "code": "TG",
        "identity": "Telangana",
        "label": "Telangana"
      },
      {
        "code": "TN",
        "identity": "Tamil Nadu",
        "label": "Tamil Nadu"
      },
      {
        "code": "TR",
        "identity": "Tripura",
        "label": "Tripura"
      },
      {
        "code": "UK",
        "identity": "Uttarakhand",
        "label": "Uttarakhand"
      },
      {
        "code": "UP",
        "identity": "Uttar Pradesh",
        "label": "UP"
      },
      {
        "code": "WB",
        "identity": "West Bengal",
        "label": "West Bengal"
      }
    ],
    "auction_mechanism": {
      "market_structure": "Double-sided closed uniform price auction",
      "bidding_window": "10:00 to 12:00 IST daily",
      "delivery_cycle": "Day-Ahead (T+1), physical delivery from 00:00 to 24:00 hrs IST",
      "post_4pm_behavior": "At 16:00 IST every day, IEX calculates and releases clearing prices and obligations for the following day (T+1). All endpoints immediately update with T+1 data upon completion of the 16:00 IST ingest."
    }
  },
  "status": "success"
}