🇮🇳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 headers
X-API-Keystring (header)required
X-API-Key: YOUR_API_KEY

Developer 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/json

Expected response format.

Query Parameters (7)

Set optional filters below to customize the query
datestring (YYYY-MM-DD)optional

Target date.

Accepted format: 2024-03-15Typical default: 2024-03-15
start_datestringoptional

Start date.

Accepted format: 2024-03-01
end_datestringoptional

End date.

Accepted format: 2024-03-15
hourinteger (1-24)optional

Hour filter.

Accepted format: 12
time_blockinteger (1-96)optional

Time block index.

Accepted format: 48
pageintegeroptional

Pagination page.

Accepted format: 1Typical default: 1
page_sizeintegeroptional

Records per page.

Accepted format: 24Typical default: 24

Response Schema Attributes

FieldTypeDescription
market_datestring (date)Target market delivery date.
hourinteger (1-24)Hour of trading day.
time_blockinteger (1-96)15-minute interval block index (1 to 96).
start_timestringInterval start time (e.g. 11:45).
end_timestringInterval end time (e.g. 12:00).
purchase_bidstring (decimal MW)Aggregate demand purchase bids in MW.
sell_bidstring (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).
mcvstring (decimal MW)Market Clearing Volume in MW (plus mcv_solar, mcv_non_solar, mcv_hydro, mcv_wind, mcv_other_re, mcv_dre).
fsvstring (decimal MW)Final Scheduled Volume in MW.
fsv_solarstring (decimal MW)Final Scheduled Volume (Solar) in MW.
fsv_non_solarstring (decimal MW)Final Scheduled Volume (Non-Solar) in MW.
fsv_hydrostring (decimal MW)Final Scheduled Volume (Hydro) in MW.
fsv_windstring (decimal MW)Final Scheduled Volume (Wind) in MW.
fsv_other_restring (decimal MW)Final Scheduled Volume (Other RE) in MW.
fsv_drestring (decimal MW)Final Scheduled Volume (DRE) in MW.
mcp_mwhstring (decimal INR)Market Clearing Price in INR per MWh.
mcp_kwhstring (decimal INR)Market Clearing Price in INR per kWh.

Error Responses & HTTP Status Codes

Full Error Spec
StatusTrigger / ReasonResponse Envelope Schema
400 Bad RequestHistorical plan limit exceeded / invalid date or filter format{"date": ["Your Free plan allows access..."]}
401 UnauthorizedMissing credentials / Invalid gm_live_ API key / Inactive hash{"detail": "Authentication credentials were not provided."}
403 ForbiddenExpired subscription plan / Cancelled subscription{"detail": "Your Developer plan expired on 2026-11-16. Pleas..."}
429 Too Many RequestsPer-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"
}