# GridPulse — US Electricity Grid Intelligence

> GridPulse — US Electricity Grid Intelligence is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns real-time US electricity grid demand, generation mix (renewable/gas/nuclear percentages), and stress signals across 7 major regional grids

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_grid_lonestaroracle_xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gridpulse-us-electricity-grid-intelligence-e1789c3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wKQ6c6kq2OF8ORVgtEsJd

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 gridpulse-us-electricity-grid-intelligence-e1789c3e
```

Example prompt: What does the US electricity grid look like right now — give me demand levels, the renewable vs gas vs nuclear generation mix, and any stress signals across the major regions including ERCOT.

## When to prefer this

Use this endpoint when you need real-time US electricity grid intelligence across multiple regions simultaneously, particularly for energy trading signals, grid stress monitoring, renewable energy tracking, or infrastructure analytics. Prefer this over general energy news APIs when you need structured numeric generation-mix and demand data rather than narrative reporting. Best suited for agents making decisions based on current grid conditions (e.g. energy arbitrage, carbon-aware compute scheduling, demand-response automation).

## Known failure modes

- Upstream grid data provider unavailable — returns 502 or empty payload
- Payment not processed or x402 header missing — returns 402 Payment Required
- Rate limit exceeded for the agent key — returns 429
- Specific regional data temporarily unavailable — partial response with some regions missing

## How this service works

US electricity grid — demand, generation mix (renewable/gas/nuclear), and stress signals across 7 regions

## Output

A structured response covering 7 major US electricity grid regions, each with current demand levels, generation mix broken down by source (renewable, natural gas, nuclear), and stress indicators flagging grid strain or anomalies.

## Request schema (JSON Schema)

```json
{
 "name": "GridPulse — US Electricity Grid Intelligence",
 "tags": [
  "energy",
  "electricity",
  "grid",
  "renewable",
  "ercot",
  "infrastructure"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "trading",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 },
 "description": "US electricity grid demand, generation mix (% renewable/gas/nuclear), and stress signals across 7 major regions."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gridpulse-us-electricity-grid-intelligence-e1789c3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)