๐ฎ๐ณ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 headersAcceptstring (header)optional
Accept: application/jsonExpected response format (No API Key Required).
Query Parameters (3)
Set optional filters below to customize the querysectionstring (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
| Field | Type | Description |
|---|---|---|
| exchange | string | Power exchange name and designation (Indian Energy Exchange). |
| timezone | string | Operational grid timezone (Asia/Kolkata IST, UTC+05:30). |
| markets | array of objects | Supported market catalogs (DAM, GDAM, State DAM, State GDAM) with endpoint routes and metrics. |
| intervals | array of objects | Technical specifications for 15-minute, hourly, daily, monthly, and yearly intervals. |
| available_states | array of objects | List of all 36 Indian states and Union Territories available for state query filtering. |
| auction_mechanism | object | Auction 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"
}