# Grid and Energy Data API
GET/v1/griddata/power/windows/{market}/{region}
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.
Price
$0.015/ callEdge cache
900s
Uptime 24h
96.36%
p95
264ms
MCP tool
griddata_power-windows-market-region
The Grid and Energy Data API provides wholesale electricity prices per market region, including AEMO NEM, Elexon GB, ENTSO-E EU zones, and EIA US balancing authorities. It also offers grid demand and generation by fuel, NESO carbon intensity, and derived cheapest-window signals for charging and demand response. The API has a single schema across four market structures, using UTC timestamps, integer micro units, and region codes in one list. The cheapest charging window endpoint returns the cheapest contiguous window of N hours within the next horizon hours. The API refreshes every 30 minutes.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| market* | path | string | |
| region* | path | string | |
| hours | query | integer = 4 | |
| horizon | query | integer = 24 |
Code
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/griddata/power/windows/nem/NSW1"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/griddata/power/windows/nem/NSW1" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/griddata/power/windows/nem/NSW1")).json();
console.log(data);# pip install "x402[requests,evm]==2.27.0" eth-account
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(Account.from_key(PRIVATE_KEY)))
session = x402_requests(client)
print(session.get("https://api.realtimeapi.ai/v1/griddata/power/windows/nem/NSW1").json())curl "https://api.realtimeapi.ai/v1/griddata/power/windows/nem/NSW1" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
What markets are covered by the API?
AEMO NEM, Elexon GB, ENTSO-E EU zones, and EIA US balancing authorities
What is the pricing of the API?
$0.015 per request
How often is the API updated?
Every 30 minutes