# SiteCheck Trade & Energy – US Electric Grid Monitor

> SiteCheck Trade & Energy – US Electric Grid Monitor is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns hourly demand, day-ahead forecast, net generation, interchange, and generation-mix by fuel for a US balancing authority or region from EIA's official Hourly Electric Grid Monitor (Form EIA-930).

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/energy/us-electric-grid-monitor?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-us-electric-grid-monitor-9d89cc24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_STFp6HXfIVHhePxoDS_jK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-trade-energy-us-electric-grid-monitor-9d89cc24
```

Example prompt: Pull the last 12 hours of electricity demand, net generation, and generation mix for ERCOT (the Texas grid) from the EIA Hourly Electric Grid Monitor.

## When to prefer this

Use this endpoint when you need authoritative, official US electric grid data sourced directly from EIA Form EIA-930 — including real-time demand, generation mix by fuel type, and day-ahead forecasts at the balancing authority level. Prefer this over general energy databases when you need hourly granularity, official government data, or fuel-level generation breakdowns for US grid regions. It covers all major US balancing authorities and the contiguous US48 aggregate.

## Known failure modes

- Invalid respondent code returns an error or empty series — must use EIA-930 codes (US48, CISO, ERCO, PJM, MISO, NYIS, ISNE, SWPP, etc.)
- Hours parameter outside 1-48 range may be rejected or clamped
- EIA upstream API unavailable or rate-limited may result in stale data or DEMO_KEY quota exhaustion
- Data freshness lag: EIA publishes with roughly a 1-hour delay so the latest hour may not yet be available
- Some smaller balancing authorities may not report a generation mix breakdown

## How this service works

US electric grid monitor from EIA's Hourly Electric Grid Monitor (Form EIA-930, official Open Data API): hourly demand, day-ahead demand forecast, net generation and net interchange for a balancing authority or region (CISO, ERCO, PJM, MISO, NYIS, ISNE, SWPP, US48…), plus the generation mix by fuel (gas, coal, nuclear, wind, solar, hydro…) for the latest reported hour. Times are UTC; values in MWh per hour.

## Output

A JSON object containing: the balancing authority name and respondent code; latest reported values for demand, net generation, day-ahead forecast, and total interchange (each with MWh value and UTC hour); time-series arrays for each of those four metrics covering the requested number of hours; and a generation mix breakdown for the latest available hour listing each fuel type (e.g. Natural Gas, Wind, Coal, Nuclear, Solar, Hydro) with MWh and percentage share. Units are MWh per hour; times are UTC period-ending hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "hours": {
       "type": "string",
       "description": "Hours of history per series, 1-48 (default 6)"
      },
      "respondent": {
       "type": "string",
       "description": "EIA-930 respondent code: US48, CISO, ERCO, PJM, MISO, NYIS, ISNE, SWPP, SOCO, TVA, BPAT, FPL… (default US48)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Electric Reliability Council of Texas, Inc.",
  "units": "MWh per hour (UTC hours, period ending)",
  "latest": {
   "demand": {
    "mwh": 44812,
    "hour": "2026-10-23T08"
   },
   "netGeneration": {
    "mwh": 53053,
    "hour": "2026-10-22T04"
   },
   "dayAheadForecast": {
    "mwh": 50934,
    "hour": "2026-10-23T05"
   },
   "totalInterchange": {
    "mwh": -350,
    "hour": "2026-10-22T04"
   }
  },
  "series": {
   "demand": [
    {
     "mwh": 44812,
     "hour": "2026-10-23T08"
    },
    {
     "mwh": 45845,
     "hour": "2026-10-23T07"
    }
   ],
   "netGeneration": [
    {
     "mwh": 53053,
     "hour": "2026-10-22T04"
    },
    {
     "mwh": 55695,
     "hour": "2026-10-22T03"
    }
   ],
   "dayAheadForecast": [
    {
     "mwh": 50934,
     "hour": "2026-10-23T05"
    },
    {
     "mwh": 54101,
     "hour": "2026-10-23T04"
    }
   ],
   "totalInterchange": [
    {
     "mwh": -350,
     "hour": "2026-10-22T04"
    },
    {
     "mwh": -431,
     "hour": "2026-10-22T03"
    }
   ]
  },
  "source": "https://api.eia.gov/v2/electricity/rto/region-data/data/",
  "keyUsed": "DEMO_KEY",
  "checkedAt": "2026-10-23T09:38:10.465Z",
  "respondent": "ERCO",
  "generationMix": {
   "hour": "2026-10-22T04",
   "fuels": [
    {
     "mwh": 29551,
     "code": "NG",
     "fuel": "Natural Gas",
     "sharePct": 54.6
    },
    {
     "mwh": 12569,
     "code": "WND",
     "fuel": "Wind",
     "sharePct": 23.2
    }
   ],
   "totalMwh": 54109
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-us-electric-grid-monitor-9d89cc24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)