🇮🇳India•IEX/Green Day-Ahead (GDAM)
Green Day-Ahead (GDAM) — 15-Minute Clearing
Sub-hourly renewable clearing prices and Solar, Wind, Hydro, and Non-Solar dispatch splits.
Contains granular sell_bid_solar, sell_bid_non_solar, sell_bid_hydro, sell_bid_wind, mcv_solar, fsv, fsv_solar, fsv_non_solar, fsv_hydro, fsv_wind, fsv_other_re, fsv_dre, etc.
⚡1 credit per requestMarket:IEX
GET/api/v1/iex/gdam/list/
Headers
Pass in HTTP request headersX-API-Keystring (header)required
X-API-Key: YOUR_API_KEYDeveloper API key starting with gm_live_. Passed in the X-API-Key HTTP header.
Security & Key Usage
API keys are secret credentials revealed only once upon creation in your dashboard. Store your key in an environment variable (e.g. GRIDMAP_API_KEY) on your server or device, and pass it in the x-api-key header with each request.
Acceptstring (header)optional
Accept: application/jsonExpected response format.
Query Parameters (7)
Set optional filters below to customize the querydatestring (YYYY-MM-DD)optional
Target date.
Accepted format:
2024-03-15Typical default: 2024-03-15start_datestringoptional
Start date.
Accepted format:
2024-03-01end_datestringoptional
End date.
Accepted format:
2024-03-15hourinteger (1-24)optional
Hour filter.
Accepted format:
12time_blockinteger (1-96)optional
Time block index.
Accepted format:
48pageintegeroptional
Pagination page.
Accepted format:
1Typical default: 1page_sizeintegeroptional
Records per page.
Accepted format:
24Typical default: 24Response Schema Attributes
| Field | Type | Description |
|---|---|---|
| market_date | string (date) | Target market delivery date. |
| hour | integer (1-24) | Hour of trading day. |
| time_block | integer (1-96) | 15-minute interval block index (1 to 96). |
| start_time | string | Interval start time (e.g. 11:45). |
| end_time | string | Interval end time (e.g. 12:00). |
| purchase_bid | string (decimal MW) | Aggregate demand purchase bids in MW. |
| sell_bid | string (decimal MW) | Total supply sell bids in MW (plus sell_bid_solar, sell_bid_non_solar, sell_bid_hydro, sell_bid_wind, sell_bid_other_re, sell_bid_dre). |
| mcv | string (decimal MW) | Market Clearing Volume in MW (plus mcv_solar, mcv_non_solar, mcv_hydro, mcv_wind, mcv_other_re, mcv_dre). |
| fsv | string (decimal MW) | Final Scheduled Volume in MW. |
| fsv_solar | string (decimal MW) | Final Scheduled Volume (Solar) in MW. |
| fsv_non_solar | string (decimal MW) | Final Scheduled Volume (Non-Solar) in MW. |
| fsv_hydro | string (decimal MW) | Final Scheduled Volume (Hydro) in MW. |
| fsv_wind | string (decimal MW) | Final Scheduled Volume (Wind) in MW. |
| fsv_other_re | string (decimal MW) | Final Scheduled Volume (Other RE) in MW. |
| fsv_dre | string (decimal MW) | Final Scheduled Volume (DRE) in MW. |
| mcp_mwh | string (decimal INR) | Market Clearing Price in INR per MWh. |
| mcp_kwh | string (decimal INR) | Market Clearing Price in INR per kWh. |
Error Responses & HTTP Status Codes
Full Error Spec| Status | Trigger / Reason | Response Envelope Schema |
|---|---|---|
| 400 Bad Request | Historical plan limit exceeded / invalid date or filter format | {"date": ["Your Free plan allows access..."]} |
| 401 Unauthorized | Missing credentials / Invalid gm_live_ API key / Inactive hash | {"detail": "Authentication credentials were not provided."} |
| 403 Forbidden | Expired subscription plan / Cancelled subscription | {"detail": "Your Developer plan expired on 2026-11-16. Pleas..."} |
| 429 Too Many Requests | Per-minute burst limit or daily quota exceeded (Header: Retry-After) | {"detail": "Per-minute rate limit of 30 requests exceeded..."} |
curl "http://52.66.240.39:8000/api/v1/iex/gdam/list/" \
-H "Accept: application/json" \
-H "x-api-key: YOUR_API_KEY"{
"total_credits": 100,
"used_credits": 1,
"remaining_credits": 99,
"credit_used": 1,
"data": {
"count": 96,
"next": null,
"previous": null,
"results": [
{
"market_date": "2024-03-15",
"hour": 12,
"time_block": 48,
"start_time": "11:45",
"end_time": "12:00",
"purchase_bid": "1250.00",
"sell_bid": "1980.50",
"sell_bid_solar": "1200.00",
"sell_bid_non_solar": "450.00",
"sell_bid_hydro": "180.50",
"sell_bid_wind": "150.00",
"sell_bid_other_re": "0.00",
"sell_bid_dre": "0.00",
"mcv": "1120.00",
"mcv_solar": "850.00",
"mcv_non_solar": "150.00",
"mcv_hydro": "80.00",
"mcv_wind": "40.00",
"mcv_other_re": "0.00",
"mcv_dre": "0.00",
"fsv": "1120.00",
"fsv_solar": "850.00",
"fsv_non_solar": "150.00",
"fsv_hydro": "80.00",
"fsv_wind": "40.00",
"fsv_other_re": "0.00",
"fsv_dre": "0.00",
"mcp_mwh": "3200.00",
"mcp_kwh": "3.20"
}
]
},
"status": "success"
}