# x402-factory Energy Weather Intelligence

> x402-factory Energy Weather Intelligence is a paid API for AI agents from x402-factory.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-12).

Returns 1–7 day daily energy-weather forecasts for a US grid region, including heat/cooling degree days, solar/wind generation indices, peak load signal, and extreme risk flags.

## Facts

- Endpoint: GET https://x402-factory.com/v1/energy/%7Bregion%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-factory-energy-weather-intelligence-19cf69f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DV_6ilasSAcEf5vBFBeBX

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 x402-factory-energy-weather-intelligence-19cf69f7
```

Example prompt: What's the energy weather outlook for ERCOT over the next 5 days — give me the peak load signal, solar and wind generation indices, cooling degree days, and any extreme risk flags for each day.

## When to prefer this

Choose this endpoint when you need daily energy-weather signals specifically calibrated to US electricity grid regions (CAISO, ERCOT, PJM, MISO, SPP, NYISO, ISONE) rather than generic weather forecasts. It is purpose-built for energy market use cases — peak load signals, degree days, and renewable generation indices are pre-computed and normalized (0–1), saving transformation work. Use it over generic weather APIs when your downstream task involves electricity trading, grid operations, demand response, or renewable dispatch decisions. The x402 micropayment model ($0.05 USDC) makes it cost-effective for agent-driven, per-call usage without subscriptions.

## Known failure modes

- Invalid region enum value → 400 or schema validation error
- days parameter out of range (< 1 or > 7) → validation error
- No payment provided → HTTP 402 with USDC/Base payment requirements in response body
- Insufficient USDC payment → 402 retry required
- Upstream weather model unavailable → possible 5xx or stub-model fallback data
- Stale data if hourly refresh has not yet run → meta.freshness indicates last update

## How this service works

Paid data APIs for AI agents: prediction-market analytics, weather intelligence, weather×market edge signals, and SEC/gov data. Paid endpoints use the x402 protocol (HTTP 402 + USDC on Base): call without payment to receive requirements, retry with an X-PAYMENT header. Machine-readable catalog: /llms.txt. Per-endpoint docs: /docs/{id}.

## Output

A JSON object with a 'daily' array (one entry per requested day) where each entry contains: date (ISO string), HDD, CDD, expected_peak_load_signal (0–1), solar_gen_index (0–1), wind_gen_index (0–1), and extreme_risk_flags (array of strings). Also includes metadata: endpoint version, data mode, freshness cadence (hourly), request ID, and generation timestamp.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "region"
     ],
     "properties": {
      "region": {
       "enum": [
        "CAISO",
        "ERCOT",
        "PJM",
        "MISO",
        "SPP",
        "NYISO",
        "ISONE"
       ],
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "days": {
       "type": "integer",
       "default": 3,
       "maximum": 7,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "daily"
       ],
       "properties": {
        "daily": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "date",
           "hdd",
           "cdd",
           "expected_peak_load_signal",
           "solar_gen_index",
           "wind_gen_index",
           "extreme_risk_flags"
          ],
          "properties": {
           "cdd": {
            "type": "number"
           },
           "hdd": {
            "type": "number"
           },
           "date": {
            "type": "string"
           },
           "wind_gen_index": {
            "type": "number",
            "maximum": 1,
            "minimum": 0
           },
           "solar_gen_index": {
            "type": "number",
            "maximum": 1,
            "minimum": 0
           },
           "extreme_risk_flags": {
            "type": "array",
            "items": {
             "type": "string"
            }
           },
           "expected_peak_load_signal": {
            "type": "number",
            "maximum": 1,
            "minimum": 0
           }
          },
          "additionalProperties": false
         }
        }
       },
       "additionalProperties": false
      },
      "me
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "daily": [
    {
     "cdd": 15,
     "hdd": 0,
     "date": "2026-07-18",
     "wind_gen_index": 0.3,
     "solar_gen_index": 0.67,
     "extreme_risk_flags": [],
     "expected_peak_load_signal": 0.68
    },
    {
     "cdd": 14.9,
     "hdd": 0,
     "date": "2026-07-19",
     "wind_gen_index": 0.32,
     "solar_gen_index": 0.75,
     "extreme_risk_flags": [],
     "expected_peak_load_signal": 0.68
    },
    {
     "cdd": 16.1,
     "hdd": 0,
     "date": "2026-07-20",
     "wind_gen_index": 0.3,
     "solar_gen_index": 0.72,
     "extreme_risk_flags": [],
     "expected_peak_load_signal": 0.73
    }
   ]
  },
  "meta": {
   "docs": "https://x402-factory.com/docs/weather.energy-region",
   "sources": [
    "stub-model"
   ],
   "version": "1.0.0",
   "endpoint": "/v1/energy/{region}",
   "data_mode": "live",
   "freshness": "hourly",
   "request_id": "req_00000000",
   "generated_at": "2026-08-21T03:58:58.164Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-factory-energy-weather-intelligence-19cf69f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-factory.com](https://www.zero.xyz/host/x402-factory.com/llms.txt)
