---
title: "Hourly US electricity demand, day-ahead demand forecast, net generation and total interchange for any of 83 balancing authorities - CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP, Bonneville, or US48 for the whole Lower 48. Straight from EIA open data, grouped by hour so an agent reads one object per hour instead of four raw series."
method: POST
path: "/v1/tools/grid-demand"
---

# Hourly US electricity demand, day-ahead demand forecast, net generation and total interchange for any of 83 balancing authorities - CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP, Bonneville, or US48 for the whole Lower 48. Straight from EIA open data, grouped by hour so an agent reads one object per hour instead of four raw series.

`POST /v1/tools/grid-demand`

## Request

- Base URL: `https://agents.dexl.io`
- URL: `https://agents.dexl.io/v1/tools/grid-demand`
- Auth: API key in header `X-Payment`

Paid per call via x402. Send without payment to get the exact price in the 402.

## Request body

- object
  - `region` string, required: Balancing-authority code: CAL, TEX, NYIS, PJM, MISO, ERCO, ISNE, or US48 for the whole Lower 48. 83 codes accepted.
  - `hours` integer: How many of the most recent hours to return.

## Response `200`

The tool output

## Other responses

- `400`: The input did not match the schema
- `402`: Payment required

---

[API](https://skmtc.dev/dexl/apis/dexl-agents.md) · [All operations](https://skmtc.dev/dexl/apis/dexl-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/dexl/apis/dexl-agents/revisions/e3692765c3f7?raw)