# Space Weather Geomagnetic Forecast

> Space Weather Geomagnetic Forecast is a paid API for AI agents from space-weather.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Returns predicted geomagnetic activity for the next 1-4 days, including peak Kp index, timing, and NOAA G storm level.

## Facts

- Endpoint: GET https://space-weather.x402tookit.com/geomagnetic-forecast?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/space-weather-geomagnetic-forecast-91cd157e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PfGTcfEAB0v7XKknOJDZK

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 space-weather-geomagnetic-forecast-91cd157e
```

Example prompt: What's the geomagnetic storm forecast for the next 4 days — give me the predicted peak Kp, when it'll hit, and the NOAA G storm level I should expect.

## When to prefer this

Use this endpoint when you need a forward-looking geomagnetic forecast (1-4 days ahead) expressed in Kp and NOAA G scale terms. Prefer this over the current-conditions endpoint when planning future operations such as HF radio schedules, satellite maneuvers, aurora viewing, or power grid risk assessments. Choose this over the historical Kp endpoint when you need predictions rather than past observations.

## Known failure modes

- Upstream NOAA data unavailable — response may include degraded:true flag
- days parameter out of range (must be 1-4) — likely returns validation error
- Stale or null forecast data if NOAA feed is delayed — asOf field may reflect older data
- Network timeout if upstream space weather service is slow to respond

## How this service works

Predicted geomagnetic activity for the next days: peak Kp, when, and the NOAA G storm level expected.

## Output

Returns a structured forecast object including: predicted peak Kp index, the datetime of that peak, the corresponding NOAA G storm scale level, number of storm periods, a human-readable summary and verdict, the data source URL, an as-of timestamp, and optional degraded/disclaimer flags if the upstream data source had issues.

## 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",
     "required": [],
     "properties": {
      "days": {
       "type": "integer",
       "description": "Look-ahead days, 1 to 4, default 3"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "periods": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "kp": {
          "type": [
           "null",
           "number"
          ]
         },
         "time": {
          "type": [
           "null",
           "string"
          ]
         },
         "scale": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "peakGLevel": {
       "type": [
        "null",
        "number"
       ]
      },
      "windowDays": {
       "type": [
        "null",
        "number"
       ]
      },
      "stormPeriods": {
       "type": [
        "null",
        "number"
       ]
      },
      "predictedPeakAt": {
       "type"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/space-weather-geomagnetic-forecast-91cd157e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from space-weather.x402tookit.com](https://www.zero.xyz/host/space-weather.x402tookit.com/llms.txt)