State-Wise DAM — 15-Minute Drawals
State-level cleared buy/sell volumes (MW) and regional settlement prices across 36 States & UTs.
Headers
Pass in HTTP request headersX-API-Key: YOUR_API_KEYDeveloper API key starting with gm_live_. Passed in the X-API-Key HTTP header.
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.
Accept: application/jsonExpected response format.
Query Parameters (10)
Set optional filters below to customize the queryTwo-letter Indian State / UT code (e.g. MH for Maharashtra, GJ for Gujarat, KA for Karnataka, TN for Tamil Nadu, DL for Delhi). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.
MHTypical default: MHTarget market trading date.
2024-03-15Typical default: 2024-03-15Range query start date.
2024-03-01Range query end date.
2024-03-15Filter by specific trading hour.
14Filter by specific 15-minute block.
1Interval start time.
00:00Interval end time.
00:15Pagination page number.
1Typical default: 1Records per page (max 100).
24Typical default: 24Response Schema Attributes
| Field | Type | Description |
|---|---|---|
| state | object | State identity containing { code: "MH", identity: "Maharashtra" }. |
| 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. 00:00). |
| end_time | string | Interval end time (e.g. 00:15). |
| cleared_buy | string (decimal MW) | State cleared buy volume in MW. |
| cleared_sell | string (decimal MW) | State cleared sell volume in MW. |
| price_mwh | string (decimal INR) | Regional Market Clearing Price in INR per MWh. |
| price_kwh | string (decimal INR) | Regional 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/state-dam/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": "http://52.66.240.39:8000/api/v1/iex/state-dam/list/?page=2&state=MH",
"previous": null,
"results": [
{
"market_date": "2024-03-15",
"start_time": "00:00",
"end_time": "00:15",
"time_block": 1,
"hour": 1,
"state": {
"code": "MH",
"identity": "Maharashtra"
},
"cleared_buy": "1250.40",
"cleared_sell": "890.20",
"price_mwh": "4250.00",
"price_kwh": "4.25"
}
]
},
"status": "success"
}