🇮🇳India•IEX/Green Day-Ahead (GDAM)
Green Day-Ahead (GDAM) — Monthly Aggregate
Calendar-month weighted average green clearing prices and renewable volume trends.
⚡1 credit per requestMarket:IEX
GET/api/v1/iex/gdam/monthly/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 (6)
Set optional filters below to customize the queryyearinteger (YYYY)optional
Exact calendar year.
Accepted format:
2024Typical default: 2024monthinteger (1-12)optional
Month number (1-12).
Accepted format:
3start_yearinteger (YYYY)optional
Start year (inclusive).
Accepted format:
2023end_yearinteger (YYYY)optional
End year (inclusive).
Accepted format:
2024pageintegeroptional
Pagination page number.
Accepted format:
1Typical default: 1page_sizeintegeroptional
Records per page (max 100).
Accepted format:
12Typical default: 12Error 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 | {"year": ["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/monthly/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": 1,
"next": null,
"previous": null,
"results": [
{
"year": 2024,
"month": 3,
"mcv": "720000.00",
"fsv": "720000.00",
"fsv_solar": "540000.00",
"fsv_non_solar": "180000.00",
"mcp_mwh": "3300.00",
"weighted_mcp_mwh": "3280.00"
}
]
},
"status": "success"
}