{"openapi":"3.1.0","info":{"title":"Grid and energy data (RealtimeAPI)","version":"603b16cb","description":"Grid and energy data served through the RealtimeAPI gateway. Pay per request in USDC with x402 (no account), or send an `X-API-Key` / `Authorization: Bearer rta_live_...` key. Each operation's `x-price` is the per-request price.","x-feed-slug":"griddata"},"servers":[{"url":"https://api.realtimeapi.ai/v1/griddata"}],"security":[{},{"ApiKeyHeader":[]},{"BearerKey":[]}],"paths":{"/carbon/{region}":{"get":{"operationId":"carbon-region","summary":"Grid carbon intensity","description":"gCO2 per kWh for Great Britain (region GB: actual and forecast for the current half hour) or a NESO distribution region id 1 to 17 (forecast and generation mix in basis points). Refreshes every 30 minutes.","parameters":[{"name":"region","in":"path","required":true,"schema":{"type":"string"}}],"x-price":{"price":"$0.005","price_micro":5000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_carbon-region","x-cache-ttl-s":900,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"country":{"type":"string"},"region_name":{"type":"string"},"interval_start":{"type":"string","format":"date-time"},"interval_minutes":{"type":"integer"},"actual_g_per_kwh":{"type":"integer"},"actual_interval_start":{"type":"string","format":"date-time"},"forecast_g_per_kwh":{"type":"integer"},"index":{"type":"string"},"generation_mix_bps":{},"forecast_next_6h":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"g_per_kwh":{"type":"integer"},"index":{"type":"string"}},"required":["start","g_per_kwh","index"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","country","region_name","interval_start","interval_minutes","actual_g_per_kwh","actual_interval_start","forecast_g_per_kwh","index","generation_mix_bps","forecast_next_6h","as_of","next_update","status","data_age_s","source"]},"example":{"region":"GB","country":"GB","region_name":"Great Britain","interval_start":"2026-11-11T02:30:00Z","interval_minutes":30,"actual_g_per_kwh":210,"actual_interval_start":"2026-11-11T02:00:00Z","forecast_g_per_kwh":217,"index":"high","generation_mix_bps":null,"forecast_next_6h":[{"start":"2026-11-11T03:00:00Z","g_per_kwh":216,"index":"high"},{"start":"2026-11-11T03:30:00Z","g_per_kwh":218,"index":"high"}],"as_of":"2026-11-11T02:30:00Z","next_update":"2026-11-11T03:00:00Z","status":"fresh","data_age_s":1607,"source":[{"publisher":"NESO Carbon Intensity API","licence":"CC BY 4.0","url":"https://api.carbonintensity.org.uk/","retrieved_at":"2026-11-11T02:56:30Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/petroleum/weekly":{"get":{"operationId":"petroleum-weekly","summary":"EIA weekly petroleum inventories","description":"The latest EIA weekly US petroleum figure for a series (crude_stocks, gasoline_stocks, distillate_stocks, refinery_inputs, crude_imports) with the previous week and the change. Published Wednesdays 10:30 ET. Refreshes every 7 days.","parameters":[{"name":"series","in":"query","required":false,"schema":{"type":"string","default":"crude_stocks"}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_petroleum-weekly","x-cache-ttl-s":86400,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"type":"string"},"name":{"type":"string"},"eia_series":{"type":"string"},"units":{"type":"string"},"period":{"type":"string","format":"date"},"value":{"type":"string"},"previous":{"type":"object","properties":{"period":{"type":"string","format":"date"},"value":{"type":"string"}},"required":["period","value"]},"change":{"type":"string"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["series","name","eia_series","units","period","value","previous","change","as_of","next_update","status","data_age_s","source"]},"example":{"series":"crude_stocks","name":"US crude oil stocks excluding SPR","eia_series":"WCESTUS1","units":"MBBL","period":"2026-10-30","value":"409760","previous":{"period":"2026-10-23","value":"410625"},"change":"-865","as_of":"2026-10-30T00:00:00Z","next_update":"2026-11-06T00:00:00Z","status":"fresh","data_age_s":1047407,"source":[{"publisher":"U.S. Energy Information Administration","licence":"US public domain","url":"https://api.eia.gov/v2/","retrieved_at":"2026-11-11T02:56:37Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/power/generation/{market}/{region}":{"get":{"operationId":"power-generation-market-region","summary":"Latest generation mix","description":"Latest generation by fuel for a region in MW with the total and the renewables share in basis points (GB, EU zones and US balancing authorities; NEM regions have no public fuel split in DispatchIS and answer pending). Refreshes every 5 minutes.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"region","in":"path","required":true,"schema":{"type":"string"}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_power-generation-market-region","x-cache-ttl-s":150,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"interval_start":{},"mix_mw":{"type":"object"},"total_mw":{},"renewables_share_bps":{},"note":{"type":"string"},"as_of":{},"next_update":{},"status":{"type":"string"},"data_age_s":{},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","market","name","timezone","currency","interval_start","mix_mw","total_mw","renewables_share_bps","note","as_of","next_update","status","data_age_s","source"]},"example":{"region":"NSW1","market":"nem","name":"New South Wales","timezone":"Etc/GMT-10","currency":"AUD","interval_start":null,"mix_mw":{},"total_mw":null,"renewables_share_bps":null,"note":"No fuel split is published for NEM regions in DispatchIS.","as_of":null,"next_update":null,"status":"pending","data_age_s":null,"source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/power/load/{market}/{region}":{"get":{"operationId":"power-load-market-region","summary":"Latest grid demand","description":"Latest demand for a region in MW: NEM total demand (5-minute), GB initial demand outturn (30-minute), ENTSO-E actual load (15 or 60-minute), EIA hourly demand for US balancing authorities. Refreshes every 5 minutes.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"region","in":"path","required":true,"schema":{"type":"string"}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_power-load-market-region","x-cache-ttl-s":150,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"interval_start":{"type":"string","format":"date-time"},"interval_minutes":{"type":"integer"},"demand_mw":{"type":"integer"},"local_time":{"type":"string","format":"date-time"},"available_generation_mw":{"type":"string"},"net_interchange_mw":{"type":"string"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","market","name","timezone","currency","interval_start","interval_minutes","demand_mw","local_time","available_generation_mw","net_interchange_mw","as_of","next_update","status","data_age_s","source"]},"example":{"region":"NSW1","market":"nem","name":"New South Wales","timezone":"Etc/GMT-10","currency":"AUD","interval_start":"2026-11-11T02:50:00Z","interval_minutes":5,"demand_mw":5872,"local_time":"2026-11-11T12:50:00+10:00","available_generation_mw":"15436.67657","net_interchange_mw":"-726.45","as_of":"2026-11-11T02:50:00Z","next_update":"2026-11-11T02:55:00Z","status":"fresh","data_age_s":407,"source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":"2026-11-11T02:56:31Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/power/prices/{market}/{region}":{"get":{"operationId":"power-prices-market-region","summary":"Latest wholesale price","description":"The latest settled wholesale electricity price for a region: NEM 5-minute RRP, GB half-hourly market index price, EU hourly day-ahead price for the current interval. Micro units of the local currency plus a USD conversion at the central bank reference rate. US regions have no price (ISO terms pending): 404. Refreshes every 5 minutes.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"region","in":"path","required":true,"schema":{"type":"string"}}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_power-prices-market-region","x-cache-ttl-s":150,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"interval_start":{"type":"string","format":"date-time"},"interval_end":{"type":"string","format":"date-time"},"interval_minutes":{"type":"integer"},"local_time":{"type":"string","format":"date-time"},"price":{"type":"object","properties":{"currency":{"type":"string"},"per_mwh_micro":{"type":"integer"},"per_mwh":{"type":"string"},"usd_per_mwh_micro":{"type":"integer"},"fx_source":{"type":"string"}},"required":["currency","per_mwh_micro","per_mwh","usd_per_mwh_micro","fx_source"]},"negative_price":{"type":"boolean"},"demand_mw":{"type":"integer"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","market","name","timezone","currency","interval_start","interval_end","interval_minutes","local_time","price","negative_price","demand_mw","as_of","next_update","status","data_age_s","source"]},"example":{"region":"NSW1","market":"nem","name":"New South Wales","timezone":"Etc/GMT-10","currency":"AUD","interval_start":"2026-11-11T02:50:00Z","interval_end":"2026-11-11T02:55:00Z","interval_minutes":5,"local_time":"2026-11-11T12:50:00+10:00","price":{"currency":"AUD","per_mwh_micro":93020000,"per_mwh":"93.02","usd_per_mwh_micro":64407048,"fx_source":"RBA 2026-11-10"},"negative_price":false,"demand_mw":5872,"as_of":"2026-11-11T02:50:00Z","next_update":"2026-11-11T02:55:00Z","status":"fresh","data_age_s":407,"source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":"2026-11-11T02:56:31Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/power/prices/{market}/{region}/day-ahead":{"get":{"operationId":"power-prices-market-region-day-ahead","summary":"Day-ahead or pre-dispatch prices for a day","description":"Forecast prices per interval for one local calendar day: the ENTSO-E day-ahead auction for EU zones (published around 13:00 CET), AEMO pre-dispatch for NEM regions (next 40 hours, 30-minute). GB and US regions answer with basis 'unavailable'. Refreshes every 30 minutes.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"region","in":"path","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","required":false,"schema":{"type":["string","null"],"format":"date"},"description":"Local calendar day, default tomorrow"}],"x-price":{"price":"$0.010","price_micro":10000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_power-prices-market-region-day-ahead","x-cache-ttl-s":900,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"date":{"type":"string","format":"date"},"basis":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"minutes":{"type":"integer"},"per_mwh_micro":{"type":"integer"},"currency":{"type":"string"}},"required":["start","minutes","per_mwh_micro","currency"]}},"summary":{"type":"object","properties":{"count":{"type":"integer"},"min_per_mwh_micro":{"type":"integer"},"max_per_mwh_micro":{"type":"integer"},"avg_per_mwh_micro":{"type":"integer"},"negative_intervals":{"type":"integer"}},"required":["count","min_per_mwh_micro","max_per_mwh_micro","avg_per_mwh_micro","negative_intervals"]},"published_at":{"type":"string","format":"date-time"},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","market","name","timezone","currency","date","basis","intervals","summary","published_at","as_of","next_update","status","data_age_s","source"]},"example":{"region":"NSW1","market":"nem","name":"New South Wales","timezone":"Etc/GMT-10","currency":"AUD","date":"2026-11-12","basis":"predispatch","intervals":[{"start":"2026-11-11T14:00:00Z","minutes":30,"per_mwh_micro":105990000,"currency":"AUD"},{"start":"2026-11-11T14:30:00Z","minutes":30,"per_mwh_micro":101431960,"currency":"AUD"}],"summary":{"count":48,"min_per_mwh_micro":11381590,"max_per_mwh_micro":129650000,"avg_per_mwh_micro":79346594,"negative_intervals":0},"published_at":"2026-11-11T02:32:05Z","as_of":"2026-11-11T02:56:36Z","next_update":"2026-11-11T03:26:36Z","status":"fresh","data_age_s":12,"source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":"2026-11-11T02:56:36Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/power/prices/{market}/{region}/history":{"get":{"operationId":"power-prices-market-region-history","summary":"Price history (7 days, Pro)","description":"Settled prices per interval for the last 7 days, newest last, optionally averaged to 30m or 60m buckets. Refreshes every 5 minutes.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"region","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"},"description":"ISO UTC start, default 7 days ago"},{"name":"to","in":"query","required":false,"schema":{"type":["string","null"],"format":"date-time"},"description":"ISO UTC end, default now"},{"name":"interval","in":"query","required":false,"schema":{"type":"string","default":"native"},"description":"native, 30m or 60m"}],"x-price":{"price":"$0.020","price_micro":20000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_power-prices-market-region-history","x-cache-ttl-s":1800,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"interval":{"type":"string"},"count":{"type":"integer"},"prices":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"minutes":{"type":"integer"},"per_mwh_micro":{"type":"integer"}},"required":["start","minutes","per_mwh_micro"]}},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","market","name","timezone","currency","from","to","interval","count","prices","as_of","next_update","status","data_age_s","source"]},"example":{"region":"NSW1","market":"nem","name":"New South Wales","timezone":"Etc/GMT-10","currency":"AUD","from":"2026-11-04T02:56:48Z","to":"2026-11-11T02:56:48Z","interval":"native","count":41,"prices":[{"start":"2026-11-10T23:30:00Z","minutes":5,"per_mwh_micro":34147360},{"start":"2026-11-10T23:35:00Z","minutes":5,"per_mwh_micro":68100000}],"as_of":"2026-11-11T02:50:00Z","next_update":"2026-11-11T02:55:00Z","status":"fresh","data_age_s":408,"source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":"2026-11-11T02:56:31Z"}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/power/windows/{market}/{region}":{"get":{"operationId":"power-windows-market-region","summary":"Cheapest charging window","description":"The cheapest contiguous window of N hours within the next horizon hours, from day-ahead (EU) or pre-dispatch (NEM) prices, with the GB carbon forecast where the region is GB. Other regions answer basis 'unavailable'. Refreshes every 30 minutes.","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"}},{"name":"region","in":"path","required":true,"schema":{"type":"string"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":4,"minimum":1,"maximum":12}},{"name":"horizon","in":"query","required":false,"schema":{"type":"integer","default":24,"minimum":1,"maximum":40}}],"x-price":{"price":"$0.015","price_micro":15000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_power-windows-market-region","x-cache-ttl-s":900,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"window_hours":{"type":"integer"},"horizon_hours":{"type":"integer"},"basis":{"type":"string"},"cheapest":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"avg_per_mwh_micro":{"type":"integer"},"min_per_mwh_micro":{"type":"integer"},"max_per_mwh_micro":{"type":"integer"},"currency":{"type":"string"},"intervals":{"type":"integer"},"avg_usd_per_mwh_micro":{"type":"integer"}},"required":["start","end","avg_per_mwh_micro","min_per_mwh_micro","max_per_mwh_micro","currency","intervals","avg_usd_per_mwh_micro"]},"coverage":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"intervals":{"type":"integer"}},"required":["from","to","intervals"]},"as_of":{"type":"string","format":"date-time"},"next_update":{"type":"string","format":"date-time"},"status":{"type":"string"},"data_age_s":{"type":"integer"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["region","market","name","timezone","currency","window_hours","horizon_hours","basis","cheapest","coverage","as_of","next_update","status","data_age_s","source"]},"example":{"region":"NSW1","market":"nem","name":"New South Wales","timezone":"Etc/GMT-10","currency":"AUD","window_hours":4,"horizon_hours":24,"basis":"predispatch","cheapest":{"start":"2026-11-11T21:00:00Z","end":"2026-11-12T01:00:00Z","avg_per_mwh_micro":23951705,"min_per_mwh_micro":11381590,"max_per_mwh_micro":33847030,"currency":"AUD","intervals":8,"avg_usd_per_mwh_micro":16584161},"coverage":{"from":"2026-11-11T02:00:00Z","to":"2026-11-12T03:00:00Z","intervals":50},"as_of":"2026-11-11T02:56:36Z","next_update":"2026-11-11T03:26:36Z","status":"fresh","data_age_s":12,"source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/regions":{"get":{"operationId":"regions","summary":"Market regions","description":"Every market region we serve with market, timezone, currency, source and price cadence. Refreshes every 24 hours.","parameters":[{"name":"market","in":"query","required":false,"schema":{"type":["string","null"]},"description":"nem, gb, eu or us"}],"x-price":{"price":"$0.005","price_micro":5000,"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"x-mcp-tool":"griddata_regions","x-cache-ttl-s":21600,"responses":{"200":{"description":"Successful response (passed through from the provider). Schema inferred from a recent live response; fields can be added or null.","headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"},"X-RTAPI-Price":{"$ref":"#/components/headers/Price"},"X-RTAPI-Cache":{"$ref":"#/components/headers/Cache"},"X-RTAPI-Cache-Layer":{"$ref":"#/components/headers/CacheLayer"},"X-RTAPI-Cache-TTL":{"$ref":"#/components/headers/CacheTtl"},"X-RTAPI-Data-Age":{"$ref":"#/components/headers/DataAge"},"X-RTAPI-Cached-At":{"$ref":"#/components/headers/CachedAt"},"X-RTAPI-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RTAPI-Quota-Source":{"$ref":"#/components/headers/QuotaSource"},"Server-Timing":{"$ref":"#/components/headers/ServerTiming"},"X-RTAPI-Gateway-Ms":{"$ref":"#/components/headers/GatewayMs"}},"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"markets":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"object","properties":{"region":{"type":"string"},"market":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"currency":{"type":"string"},"source":{"type":"string"},"price_cadence_s":{"type":"integer"},"prices_available":{"type":"boolean"},"meta":{"type":"object","properties":{"eic":{"type":"string"}},"required":["eic"]}},"required":["region","market","name","timezone","currency","source","price_cadence_s","prices_available","meta"]}},"as_of":{"type":"string","format":"date-time"},"source":{"type":"array","items":{"type":"object","properties":{"publisher":{"type":"string"},"licence":{"type":"string"},"url":{"type":"string"},"retrieved_at":{}},"required":["publisher","licence","url","retrieved_at"]}}},"required":["count","markets","regions","as_of","source"]},"example":{"count":18,"markets":["nem","gb"],"regions":[{"region":"DE_LU","market":"eu","name":"Germany and Luxembourg","timezone":"Europe/Berlin","currency":"EUR","source":"entsoe","price_cadence_s":3600,"prices_available":true,"meta":{"eic":"10Y1001A1001A82H"}},{"region":"ES","market":"eu","name":"Spain","timezone":"Europe/Madrid","currency":"EUR","source":"entsoe","price_cadence_s":3600,"prices_available":true,"meta":{"eic":"10YES-REE------0"}}],"as_of":"2026-11-11T02:56:48Z","source":[{"publisher":"AEMO","licence":"AEMO public data, attribution; commercial terms under confirmation","url":"https://nemweb.com.au/Reports/Current/DispatchIS_Reports/","retrieved_at":null},{"publisher":"Elexon Insights","licence":"Elexon open data licence","url":"https://data.elexon.co.uk/bmrs/api/v1","retrieved_at":null}]}}}},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerKey":{"type":"http","scheme":"bearer","description":"`rta_live_...` platform key"}},"headers":{"PaymentRequired":{"description":"Base64-encoded JSON x402 payment requirements (same as the body).","schema":{"type":"string"}},"PaymentResponse":{"description":"Base64-encoded JSON x402 settlement receipt (paid requests only).","schema":{"type":"string"}},"Price":{"description":"Per-request price of this endpoint, e.g. `$0.010` (charged only on a paid 2xx; covered by the key in API-key mode).","schema":{"type":"string"}},"Cache":{"description":"`HIT` or `MISS`.","schema":{"type":"string","enum":["HIT","MISS"]}},"CacheLayer":{"description":"On a hit: `edge` (this data centre's cache), `global` (the quality probe's copy) or `region` (the copy kept fresh in your region; `X-RTAPI-Data-Age` says how old).","schema":{"type":"string","enum":["edge","global","region"]}},"CacheTtl":{"description":"The endpoint's cache TTL in seconds (cacheable endpoints only).","schema":{"type":"integer"}},"DataAge":{"description":"Seconds since the gateway took its copy from the provider (0 when the answer is live). The data's own timestamp, if any, is in the body.","schema":{"type":"integer"}},"CachedAt":{"description":"Unix milliseconds the gateway's copy was taken from the provider (hits only).","schema":{"type":"integer"}},"Remaining":{"description":"API-key mode: calls left in the key's current period (also `X-RateLimit-Remaining`).","schema":{"type":"integer"}},"RateLimitLimit":{"description":"API-key mode: the key's calls per period.","schema":{"type":"integer"}},"RateLimitReset":{"description":"API-key mode: unix seconds the period resets.","schema":{"type":"integer"}},"QuotaSource":{"description":"API-key mode: `do` when the quota figures are the counter's exact answer, `memo` when a cached answer was served ahead of the count (figures then approximate by a few calls; a 429 is always exact).","schema":{"type":"string","enum":["do","memo"]}},"ServerTiming":{"description":"One entry per phase the request ran (`kv`, `auth`, `quota`, `cache`, `upstream`, `settle`) and `total`, the gateway's time to first byte; `desc` names the source (`cache;dur=3;desc=\"edge\"`).","schema":{"type":"string"}},"GatewayMs":{"description":"The gateway's own time to first byte: `total` minus `upstream` and `settle`.","schema":{"type":"integer"}}},"responses":{"PaymentRequired":{"description":"Payment required. Retry with an x402 `PAYMENT-SIGNATURE` (or `X-PAYMENT`) header for one of `accepts`, or with an API key.","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"Error":{"description":"Error envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"PaymentRequirements":{"type":"object","required":["scheme","network","payTo","asset"],"properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","examples":["eip155:8453"]},"payTo":{"type":"string"},"price":{"type":"string","examples":["$0.010"]},"asset":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"PaymentRequired":{"type":"object","required":["x402Version","accepts","error"],"properties":{"x402Version":{"type":"integer","const":2},"accepts":{"type":"array","items":{"$ref":"#/components/schemas/PaymentRequirements"}},"error":{"type":"string"},"alternatives":{"type":"object","properties":{"api_key_purchase":{"type":"string","format":"uri"},"docs":{"type":"string","format":"uri"}}}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}},"x-x402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"externalDocs":{"url":"https://realtimeapi.ai/feeds/griddata"}}