{"openapi":"3.0.3","info":{"title":"GridMap IEX Market Telemetry & Settlement REST API","version":"1.0.0","description":"Institutional IEX electricity spot market analytics and 96-block interval clearing telemetry."},"servers":[{"url":"https://api.gridmap.in","description":"Production API Gateway"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1/iex/meta/":{"get":{"summary":"Exchange Metadata & Regional Registry","description":"Retrieve valid state codes, bid area mappings, dataset identifiers, and available date bounds.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"section","in":"query","required":false,"description":"Isolate a specific metadata category. Leave on \"All Sections\" to receive the complete consolidated discovery payload.","schema":{"type":"string"}},{"name":"market","in":"query","required":false,"description":"Filter market catalog by specific market code or alias. Filters the markets list in full response or when ?section=markets.","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Filter markets by operational geographic scope: national (All-India) vs. state (Regional). Also accepts ?scope= alias.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"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=<code> 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=<code> 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"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/dam/list/":{"get":{"summary":"Day-Ahead Market (DAM) — 15-Minute Clearing","description":"96-block national spot clearing prices (MCP), purchase/sell bids, and scheduled volumes (FSV).","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":false,"description":"Target market trading date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Filter by specific trading hour.","schema":{"type":"integer"}},{"name":"time_block","in":"query","required":false,"description":"Filter by specific 15-minute block.","schema":{"type":"integer"}},{"name":"start_time","in":"query","required":false,"description":"Interval start time.","schema":{"type":"string"}},{"name":"end_time","in":"query","required":false,"description":"Interval end time.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":96,"next":"https://api.gridmap.in/api/v1/iex/dam/list/?page=2","previous":null,"results":[{"market_date":"2024-03-15","start_time":"00:00","end_time":"00:15","time_block":1,"hour":1,"purchase_bid":"5420.50","sell_bid":"4890.20","mcv":"4210.00","fsv":"4210.00","mcp_mwh":"3850.00","mcp_kwh":"3.85"},{"market_date":"2024-03-15","start_time":"00:15","end_time":"00:30","time_block":2,"hour":1,"purchase_bid":"5380.00","sell_bid":"4920.00","mcv":"4190.00","fsv":"4190.00","mcp_mwh":"3820.00","mcp_kwh":"3.82"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/dam/hourly/list/":{"get":{"summary":"Day-Ahead Market (DAM) — Hourly Rollup","description":"24-hour volume-weighted clearing prices and aggregated national auction liquidity.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":false,"description":"Target date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Filter by specific trading hour.","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":24,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","hour":14,"purchase_bid":"6120.00","sell_bid":"5200.00","mcv":"4980.00","fsv":"4980.00","mcp_mwh":"4210.00","mcp_kwh":"4.21","weighted_mcp_mwh":"4198.50","weighted_mcp_kwh":"4.1985"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/dam/daily/list/":{"get":{"summary":"Day-Ahead Market (DAM) — Daily Settlement","description":"End-of-day volume-weighted MCP (₹/MWh & ₹/kWh) and cumulative cleared market volume.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":false,"description":"Exact market date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":15,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","purchase_bid":"138400.00","sell_bid":"121000.00","mcv":"108500.00","fsv":"108500.00","mcp_mwh":"3940.00","mcp_kwh":"3.94","weighted_mcp_mwh":"3912.40","weighted_mcp_kwh":"3.9124"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/dam/monthly/list/":{"get":{"summary":"Day-Ahead Market (DAM) — Monthly Aggregate","description":"Calendar-month weighted average clearing prices and total cleared volume trends.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"year","in":"query","required":false,"description":"Exact calendar year.","schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"description":"Month number (1-12).","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":1,"next":null,"previous":null,"results":[{"year":2024,"month":3,"purchase_bid":"4200000.00","sell_bid":"3900000.00","mcv":"3450000.00","fsv":"3450000.00","mcp_mwh":"4120.00","mcp_kwh":"4.12","weighted_mcp_mwh":"4089.10","weighted_mcp_kwh":"4.0891"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/dam/yearly/list/":{"get":{"summary":"Day-Ahead Market (DAM) — Annual Archive","description":"Multi-year annual spot price benchmarks and cumulative exchange volume (2012–Present).","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"year","in":"query","required":false,"description":"Exact calendar year.","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive, earliest 2012).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":1,"next":null,"previous":null,"results":[{"year":2024,"purchase_bid":"52000000.00","sell_bid":"48500000.00","mcv":"42100000.00","fsv":"42100000.00","mcp_mwh":"4050.00","mcp_kwh":"4.05","weighted_mcp_mwh":"4022.00","weighted_mcp_kwh":"4.0220"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/gdam/list/":{"get":{"summary":"Green Day-Ahead (GDAM) — 15-Minute Clearing","description":"Sub-hourly renewable clearing prices and Solar, Wind, Hydro, and Non-Solar dispatch splits.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":false,"description":"Target date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"End date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Hour filter.","schema":{"type":"integer"}},{"name":"time_block","in":"query","required":false,"description":"Time block index.","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"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"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/gdam/hourly/list/":{"get":{"summary":"Green Day-Ahead (GDAM) — Hourly Rollup","description":"24-hour volume-weighted renewable clearing prices and green auction liquidity.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":false,"description":"Target date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Hour filter.","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":24,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","hour":12,"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","weighted_mcp_mwh":"3185.50","weighted_mcp_kwh":"3.1855"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/gdam/daily/list/":{"get":{"summary":"Green Day-Ahead (GDAM) — Daily Settlement","description":"End-of-day volume-weighted green MCP and cleared renewable fuel volume.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":false,"description":"Exact market date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"End date.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":15,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","purchase_bid":"28000.00","sell_bid":"34500.00","mcv":"24100.00","mcv_solar":"18200.00","mcv_non_solar":"5900.00","fsv":"24100.00","fsv_solar":"18200.00","fsv_non_solar":"5900.00","fsv_hydro":"0.00","fsv_wind":"0.00","fsv_other_re":"0.00","fsv_dre":"0.00","mcp_mwh":"3250.00","mcp_kwh":"3.25","weighted_mcp_mwh":"3210.00","weighted_mcp_kwh":"3.2100"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/gdam/monthly/list/":{"get":{"summary":"Green Day-Ahead (GDAM) — Monthly Aggregate","description":"Calendar-month weighted average green clearing prices and renewable volume trends.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"year","in":"query","required":false,"description":"Exact calendar year.","schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"description":"Month number (1-12).","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"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"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/gdam/yearly/list/":{"get":{"summary":"Green Day-Ahead (GDAM) — Annual Archive","description":"Multi-year annual green spot price benchmarks and cumulative renewable volume.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"year","in":"query","required":false,"description":"Exact calendar year.","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive, earliest 2021).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":1,"next":null,"previous":null,"results":[{"year":2024,"mcv":"8900000.00","fsv":"8900000.00","fsv_solar":"6400000.00","fsv_non_solar":"2500000.00","weighted_mcp_mwh":"3350.00"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-dam/list/":{"get":{"summary":"State-Wise DAM — 15-Minute Drawals","description":"State-level cleared buy/sell volumes (MW) and regional settlement prices across 36 States & UTs.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-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.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Target market trading date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Filter by specific trading hour.","schema":{"type":"integer"}},{"name":"time_block","in":"query","required":false,"description":"Filter by specific 15-minute block.","schema":{"type":"integer"}},{"name":"start_time","in":"query","required":false,"description":"Interval start time.","schema":{"type":"string"}},{"name":"end_time","in":"query","required":false,"description":"Interval end time.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":96,"next":"https://api.gridmap.in/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"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-dam/hourly/list/":{"get":{"summary":"State-Wise DAM — Hourly Rollup","description":"24-hour state-level aggregated drawals, injection volumes, and weighted regional prices.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-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.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Target market trading date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Hour of trading day (1 to 24).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":24,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","hour":18,"state":{"code":"MH","identity":"Maharashtra"},"cleared_buy":"5400.00","cleared_sell":"4100.00","price_mwh":"5840.00","price_kwh":"5.84","weighted_price_mwh":"5812.50","weighted_price_kwh":"5.8125"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-dam/daily/list/":{"get":{"summary":"State-Wise DAM — Daily Settlement","description":"End-of-day state-level cleared buy/sell volumes (MW) and regional settlement prices across 36 States & UTs.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-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.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Exact date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":1,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","state":{"code":"MH","identity":"Maharashtra"},"cleared_buy":"112000.00","cleared_sell":"91500.00","price_mwh":"4580.00","price_kwh":"4.58","weighted_price_mwh":"4620.80","weighted_price_kwh":"4.6208"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-dam/monthly/list/":{"get":{"summary":"State-Wise DAM — Monthly Aggregate","description":"Calendar-month state-wise cleared volumes and regional settlement price trends.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-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.","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Calendar year.","schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"description":"Month number (1-12).","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":12,"next":null,"previous":null,"results":[{"year":2024,"month":3,"state":{"code":"MH","identity":"Maharashtra"},"cleared_buy":"3250000.00","cleared_sell":"2810000.00","price_mwh":"4480.20","price_kwh":"4.48","weighted_price_mwh":"4510.40","weighted_price_kwh":"4.5104"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-dam/yearly/list/":{"get":{"summary":"State-Wise DAM — Annual Archive","description":"Annual state-level energy consumption benchmarks and regional settlement history.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-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.","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Exact calendar year.","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive, earliest 2012).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":3,"next":null,"previous":null,"results":[{"year":2024,"state":{"code":"MH","identity":"Maharashtra"},"cleared_buy":"39000000.00","cleared_sell":"33500000.00","price_mwh":"4350.00","price_kwh":"4.35","weighted_price_mwh":"4390.10","weighted_price_kwh":"4.3901"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-gdam/list/":{"get":{"summary":"State-Wise Green DAM — 15-Minute Drawals","description":"State-level cleared renewable buy/sell volumes (MW) and green settlement prices across 36 States & UTs.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter Indian State / UT code (e.g. KA for Karnataka, MH for Maharashtra, GJ for Gujarat, RJ for Rajasthan, TN for Tamil Nadu). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Target market trading date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Filter by trading hour.","schema":{"type":"integer"}},{"name":"time_block","in":"query","required":false,"description":"Filter by specific 15-minute block.","schema":{"type":"integer"}},{"name":"start_time","in":"query","required":false,"description":"Interval start time.","schema":{"type":"string"}},{"name":"end_time","in":"query","required":false,"description":"Interval end time.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":96,"next":"https://api.gridmap.in/api/v1/iex/state-gdam/list/?page=2&state=KA","previous":null,"results":[{"market_date":"2024-03-15","start_time":"11:45","end_time":"12:00","time_block":48,"hour":12,"state":{"code":"KA","identity":"Karnataka"},"cleared_buy":"450.00","cleared_sell":"620.00","price_mwh":"3750.00","price_kwh":"3.75"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-gdam/hourly/list/":{"get":{"summary":"State-Wise Green DAM — Hourly Rollup","description":"24-hour state-level renewable drawals, green injection volumes, and weighted prices.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter Indian State / UT code (e.g. KA for Karnataka, MH for Maharashtra, GJ for Gujarat, RJ for Rajasthan, TN for Tamil Nadu). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Target market trading date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"hour","in":"query","required":false,"description":"Hour of trading day.","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":24,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","hour":12,"state":{"code":"KA","identity":"Karnataka"},"cleared_buy":"1840.00","cleared_sell":"2560.00","price_mwh":"3820.00","price_kwh":"3.82","weighted_price_mwh":"3795.50","weighted_price_kwh":"3.7955"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-gdam/daily/list/":{"get":{"summary":"State-Wise Green DAM — Daily Settlement","description":"End-of-day state-level renewable buy/sell volumes and regional green settlement prices.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter Indian State / UT code (e.g. KA for Karnataka, MH for Maharashtra, GJ for Gujarat, RJ for Rajasthan, TN for Tamil Nadu). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Exact date.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Range query start date.","schema":{"type":"string"}},{"name":"end_date","in":"query","required":false,"description":"Range query end date.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":1,"next":null,"previous":null,"results":[{"market_date":"2024-03-15","state":{"code":"KA","identity":"Karnataka"},"cleared_buy":"35300.00","cleared_sell":"42100.00","price_mwh":"4080.00","price_kwh":"4.08","weighted_price_mwh":"4120.50","weighted_price_kwh":"4.1205"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-gdam/monthly/list/":{"get":{"summary":"State-Wise Green DAM — Monthly Aggregate","description":"Calendar-month state-wise renewable volumes and green settlement price trends.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter Indian State / UT code (e.g. KA for Karnataka, MH for Maharashtra, GJ for Gujarat, RJ for Rajasthan, TN for Tamil Nadu). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Calendar year.","schema":{"type":"integer"}},{"name":"month","in":"query","required":false,"description":"Month number (1-12).","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":12,"next":null,"previous":null,"results":[{"year":2024,"month":3,"state":{"code":"KA","identity":"Karnataka"},"cleared_buy":"980000.00","cleared_sell":"1120000.00","price_mwh":"4010.00","price_kwh":"4.01","weighted_price_mwh":"4050.80","weighted_price_kwh":"4.0508"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}},"/api/v1/iex/state-gdam/yearly/list/":{"get":{"summary":"State-Wise Green DAM — Annual Archive","description":"Annual state-level renewable energy benchmarks and regional green settlement history.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter Indian State / UT code (e.g. KA for Karnataka, MH for Maharashtra, GJ for Gujarat, RJ for Rajasthan, TN for Tamil Nadu). Query /api/v1/iex/meta/?section=states to see all 36 supported codes.","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Exact calendar year.","schema":{"type":"integer"}},{"name":"start_year","in":"query","required":false,"description":"Start year (inclusive, earliest 2021).","schema":{"type":"integer"}},{"name":"end_year","in":"query","required":false,"description":"End year (inclusive).","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Pagination page number.","schema":{"type":"integer"}},{"name":"page_size","in":"query","required":false,"description":"Records per page (max 100).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful telemetry response","content":{"application/json":{"example":{"total_credits":100,"used_credits":1,"remaining_credits":99,"credit_used":1,"data":{"count":3,"next":null,"previous":null,"results":[{"year":2024,"state":{"code":"KA","identity":"Karnataka"},"cleared_buy":"11500000.00","cleared_sell":"13400000.00","price_mwh":"3940.00","price_kwh":"3.94","weighted_price_mwh":"3980.50","weighted_price_kwh":"3.9805"}]},"status":"success"}}}},"400":{"description":"Bad Request - Historical plan limit exceeded or invalid query filter","content":{"application/json":{"example":{"date":["Your Free plan allows access to historical data from 2026-11-12 onwards. Please upgrade your subscription plan to access older historical data."]}}}},"401":{"description":"Unauthorized - Missing credentials or invalid gm_live_ API key","content":{"application/json":{"example":{"detail":"Authentication credentials were not provided."}}}},"403":{"description":"Forbidden - Subscription plan expired or cancelled","content":{"application/json":{"example":{"detail":"Your Developer plan expired on 2026-11-19. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."}}}},"429":{"description":"Too Many Requests - Per-minute or daily quota exceeded (Header: Retry-After)","content":{"application/json":{"example":{"detail":"Per-minute rate limit of 30 requests exceeded for your current plan (Developer)."}}}}}}}}}