Skip to content

# Grid and Energy Data API

GET/v1/griddata/power/load/{market}/{region}

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.

Price

$0.01/ call

Edge cache

150s

Uptime 24h

96.36%

p95

348ms

MCP tool

griddata_power-load-market-region

The Grid and Energy Data API provides wholesale electricity prices per market region, grid demand and generation by fuel, and other related data. It covers four market structures: AEMO NEM, Elexon GB, ENTSO-E EU zones, and EIA US balancing authorities. The API offers a unified schema and UTC timestamps. Data is available for energy, power prices, electricity, grid carbon, day-ahead, NEM, GB, and US markets.

Parameters

NameInTypeDescription
market* path string
region* path string

Code

curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/griddata/power/load/nem/NSW1"

# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/griddata/power/load/nem/NSW1" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"
TypeScript · @x402/fetch
// 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/load/nem/NSW1")).json();
console.log(data);
Python · x402
# 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/load/nem/NSW1").json())
With an API key
curl "https://api.realtimeapi.ai/v1/griddata/power/load/nem/NSW1" -H "X-API-Key: $RTAPI_KEY"

Frequently asked questions

What is the API endpoint for latest grid demand?

The endpoint is /power/load/{market}/{region}

What is the price of the API?

$0.010 per request

What is the refresh rate of the data?

Every 5 minutes

Get a free key

1,000 calls a month across every feed. Who is setting it up?

No key needed at all: agents can pay per call in USDC with x402.