Catalog/science-geomag-forecast

Science

3-day geomagnetic (Kp/Ap) forecast + storm probabilities API

NOAA SWPC 3-day geomagnetic forecast parsed from the fixed-width text product into clean JSON: per-3-hour Kp forecast across the next three UTC days, NOAA storm probabilities (Active/Minor/Moderate/Strong-Extreme), plus a derived peak Kp and peak G-scale storm level. Forward-looking — distinct from science-space-weather's current snapshot. Answers 'will there be a geomagnetic storm in the next 3 days?', 'what's the forecast Kp for tomorrow night?', 'chance of a strong storm this week?'.

Price$0.01per request
MethodPOST
Route/v1/science/geomag-forecast
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache10800s public
sciencespace-weathergeomagnetickp-forecastauroranoaaswpcstormforecast
API URLhttps://x402.hexl.dev/v1/science/geomag-forecast
Integration docs
Example request
{}
Example response
{
  "issued": "2026 Jun 04 2205 UTC",
  "days": [
    "Jun 05",
    "Jun 06",
    "Jun 07"
  ],
  "kpForecast": [
    {
      "window": "00-03UT",
      "kp": [
        5.33,
        4.33,
        3
      ]
    },
    {
      "window": "03-06UT",
      "kp": [
        6.67,
        4,
        3
      ]
    },
    {
      "window": "06-09UT",
      "kp": [
        5.67,
        4,
        2
      ]
    },
    {
      "window": "09-12UT",
      "kp": [
        5.33,
        3,
        2.67
      ]
    },
    {
      "window": "12-15UT",
      "kp": [
        4.33,
        2.33,
        2.67
      ]
    },
    {
      "window": "15-18UT",
      "kp": [
        4.67,
        2.67,
        2.67
      ]
    },
    {
      "window": "18-21UT",
      "kp": [
        5,
        3.33,
        2
      ]
    },
    {
      "window": "21-00UT",
      "kp": [
        4.33,
        3.67,
        2.67
      ]
    }
  ],
  "peakKp": 6.67,
  "peakStormLevel": "G2 (moderate)",
  "stormProbabilities": [
    {
      "level": "Active",
      "perDayPct": [
        24,
        45,
        15
      ]
    },
    {
      "level": "Minor storm",
      "perDayPct": [
        25,
        20,
        5
      ]
    },
    {
      "level": "Moderate storm",
      "perDayPct": [
        1,
        10,
        1
      ]
    },
    {
      "level": "Strong-Extreme storm",
      "perDayPct": [
        51,
        5,
        1
      ]
    }
  ]
}
Input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}