# GridPulse Time-of-Use Optimizer

> GridPulse Time-of-Use Optimizer is a paid API for AI agents from gridpulse-amber.vercel.app, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-15).

Returns peak and off-peak time windows for a given utility along with an appliance-shifting strategy to minimize electricity costs under time-of-use rates.

## Facts

- Endpoint: GET https://gridpulse-amber.vercel.app/api/energy/tou
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gridpulse-time-of-use-optimizer-2036cadc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eYDZPuzqJmzGgmjv4gDy5

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-time-of-use-optimizer-2036cadc
```

Example prompt: What are the peak and off-peak hours for PG&E in California, and which of my appliances — dishwasher, washer/dryer, and EV charger — should I shift to off-peak times to save the most money?

## When to prefer this

Use this endpoint when a homeowner or energy agent needs to understand peak/off-peak windows for a specific utility and receive actionable appliance-scheduling recommendations. Prefer this over generic electricity price endpoints when the goal is behavioral optimization (shifting loads) rather than just price lookup.

## Known failure modes

- Unsupported utility provider returns a 404 or empty result
- Missing utility or location parameter returns a 400 validation error
- Utility does not offer time-of-use rates, resulting in a no-TOU-plan response
- Stale rate data if utility recently updated its TOU schedule
- Payment failure via x402 returns 402 before data is delivered

## How this service works

Time-of-use electricity rate optimizer — peak/off-peak rate windows and an appliance-shifting strategy to cut bills for a given utility or state. For homeowner and energy agents.

## Output

Returns the peak and off-peak time windows for the specified utility, along with a prioritized appliance-shifting strategy showing which devices to reschedule and the estimated cost savings from doing so.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "state"
 ],
 "properties": {
  "state": {
   "type": "string",
   "description": "2-letter US state code"
  },
  "has_ev": {
   "type": "boolean",
   "description": "true if household has an EV (major TOU savings driver)"
  },
  "utility": {
   "type": "string",
   "description": "Utility name (e.g., PGE, SCE, ConEd) for utility-specific TOU plans"
  },
  "has_solar": {
   "type": "boolean",
   "description": "true if household has solar (affects TOU export credit optimization)"
  },
  "monthly_bill": {
   "type": "integer",
   "description": "Average monthly electricity bill in USD"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gridpulse-time-of-use-optimizer-2036cadc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gridpulse-amber.vercel.app](https://www.zero.xyz/host/gridpulse-amber.vercel.app/llms.txt)