# CAISO California Grid Outlook API

> California ISO grid data every 5 minutes: generation by fuel, demand, net demand, renewables and CO2

- Vendor: `caisocaliforniagridoutlookapi` · version 1.0 · category Energy · tags caiso api, california grid api, electricity demand api, power generation api, renewables api, grid emissions api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/caisocaliforniagridoutlookapi
- This document: https://apiclay.com/docs/caisocaliforniagridoutlookapi.md
- OpenAPI 3.1: https://apiclay.com/api/caisocaliforniagridoutlookapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `caisocaliforniagridoutlookapi`
- Updated: 2026-11-18

## About

## CAISO California Grid Outlook API

Today's Outlook data from the California Independent System Operator: 5-minute generation by fuel (solar, wind, geothermal, hydro, natural gas, nuclear, batteries, imports), demand against the day-ahead and hour-ahead forecasts, net demand, renewables and CO2 emissions by source, for today or any past day.

Data comes from **caiso.com** (https://www.caiso.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/today?dataset=fuelsource`, `/history?date=20261110&amp;dataset=demand`.

### Routes

#### GET `/today` - Today
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| dataset | path | string | yes | `fuelsource`, `demand`, `netdemand`, `renewables` or `co2`. |

Returns: CSV with a `Time` column (5-minute steps) and one column per fuel, forecast or source, in MW (CO2 in metric tons per hour).

#### GET `/history` - History
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| date | path | string | yes | Day `YYYYMMDD`. |
| dataset | path | string | yes | Same names as `/today`. |

Returns: the same CSV for that day.

### Caveats

- Responses are CSV, not JSON. Values are preliminary operating data as shown on CAISO's Today's Outlook.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by caiso.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /today — Today
- Gateway: `GET https://api.apiclay.com/v1/api/caisocaliforniagridoutlookapi/today`
- Public query params: `dataset` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /history — History
- Gateway: `GET https://api.apiclay.com/v1/api/caisocaliforniagridoutlookapi/history`
- Public query params: `date` (string, required), `dataset` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/caisocaliforniagridoutlookapi/today?dataset=<dataset>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
