{"openapi":"3.1.0","info":{"title":"Space Weather API","version":"1.0.0","description":"Live solar and geomagnetic conditions as an API, relayed from NOAA's Space Weather Prediction Center (SWPC). Get the current planetary K-index with its activity level and geomagnetic-storm scale (Kp 5+ → G1-G5); the real-time solar wind from the L1 point (speed, density, temperature, magnetic field Bz/Bt); the current NOAA scales for radio blackouts (R), solar-radiation storms (S) and geomagnetic storms (G); and the latest space-weather alerts, watches and warnings. Ideal for aurora forecasting, satellite & power-grid operations, HF-radio and amateur-radio apps, and science dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/spaceweather-api","description":"oanor gateway"}],"tags":[{"name":"Space Weather"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/alerts":{"get":{"operationId":"get_v1_alerts","tags":["Space Weather"],"summary":"Recent space-weather alerts, watches & warnings","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max alerts (1-50, default 10)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"alerts":[{"id":"TIIA","message":"Space Weather Message Code: ALTTP2\nSerial Number: 1481\nIssue Time: 2026 May 01 1550 UTC\n\nALERT: Type II Radio Emission\nBegin Time: 2026 May 01 1535 UTC\nEstimated Velocity: 593 km/s\n\n\n\nDescription: Type II emissions occur in association with eruptions on the sun and typically indicate a coronal mass ejection is associated with a flare event.","issued_at":"2026-05-01 15:50:32.247"},{"id":"TIIA","message":"Space Weather Message Code: ALTTP2\nSerial Number: 1482\nIssue Time: 2026 May 02 1111 UTC\n\nALERT: Type II Radio Emission\nBegin Time: 2026 May 02 1051 UTC\nEstimated Velocity: 641 km/s\n\nComment: Likely associated with C-class flare acitivity originating from AR 4420 on the west limb.\n\n\n\nDescription: Type II emissions occur in association with eruptions on the sun and typically indicate a coronal mass ejection is associated with a flare event.","issued_at":"2026-05-02 11:11:38.977"},{"id":"K04W","message":"Space Weather Message Code: WARK04\nSerial Number: 5333\nIssue Time: 2026 May 04 1649 UTC\n\nWARNING: Geomagnetic K-index of 4 expected\nValid From: 2026 May 04 1645 UTC\nValid To: 2026 May 05 0300 UTC\nWarning Condition: Onset\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 65 degrees Geomagnetic Latitude.\nInduced Currents - Weak power grid fluctuations can occur.\nAurora - Aurora may be visible at high latitudes such as Canada and Alaska.","issued_at":"2026-05-04 16:49:32.777"},{"id":"K04A","message":"Space Weather Message Code: ALTK04\nSerial Number: 2654\nIssue Time: 2026 May 04 1649 UTC\n\nALERT: Geomagnetic K-index of 4\n Threshold Reached: 2026 May 04 1647 UTC\nSynoptic Period: 1500-1800 UTC\n \nActive Warning: Yes\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 65 degrees Geomagnetic Latitude.\nInduced Currents - Weak power grid fluctuations can occur.\nAurora - Aurora may be visible at high latitudes such as Canada and Alaska.","issued_at":"2026-05-04 16:49:58.653"},{"id":"K05W","message":"Space Weather Message Code: WARK05\nSerial Number: 2231\nIssue Time: 2026 May 04 1950 UTC\n\nWARNING: Geomagnetic K-index of 5 expected\nValid From: 2026 May 04 1945 UTC\nValid To: 2026 May 05 0000 UTC\nWarning Condition: Onset\nNOAA Scale: G1 - Minor\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 60 degrees Geomagnetic Latitude.\nInduced Currents - Weak power grid fluctuations can occur.\nSpacecraft - Minor impact on satellite operations possible.\nAurora - Aurora may be visible at high latitudes, i.e., northern tier of the U.S. such as northern Michigan and Maine.","issued_at":"2026-05-04 19:50:55.110"},{"id":"K05A","message":"Space Weather Message Code: ALTK05\nSerial Number: 2014\nIssue Time: 2026 May 04 1951 UTC\n\nALERT: Geomagnetic K-index of 5\n Threshold Reached: 2026 May 04 1951 UTC\nSynoptic Period: 1800-2100 UTC\n \nActive Warning: Yes\nNOAA Scale: G1 - Minor\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 60 degrees Geomagnetic Latitude.\nInduced Currents - Weak power grid fluctuations can occur.\nSpacecraft - Minor impact on satellite operations possible.\nAurora - Aurora may be visible at high latitudes, i.e., northern tier of the U.S. such as northern Michigan and Maine.","issued_at":"2026-05-04 19:51:43.590"},{"id":"K06W","message":"Space Weather Message Code: WARK06\nSerial Number: 656\nIssue Time: 2026 May 04 2031 UTC\n\nWARNING: Geomagnetic K-Index of 6 expected\nValid From: 2026 May 04 2031 UTC\nValid To: 2026 May 05 0000 UTC\nWarning Condition: Onset\nNOAA Scale: G2 - Moderate\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 55 degrees Geomagnetic Latitude.\nInduced Currents - Power grid fluctuations can occur. High-latitude power systems may experience voltage alarms.\nSpacecraft - Satellite orientation irregularities may occur; increased drag on low Earth-orbit satellites is possible.\nRadio - HF (high frequency) radio propagation can fade at higher latitudes.\nAurora - Aurora may be seen as low as New York to Wisconsin to Washington state.","issued_at":"2026-05-04 20:31:44.840"},{"id":"K06A","message":"Space Weather Message Code: ALTK06\nSerial Number: 715\nIssue Time: 2026 May 04 2032 UTC\n\nALERT: Geomagnetic K-index of 6\n Threshold Reached: 2026 May 04 2032 UTC\nSynoptic Period: 1800-2100 UTC\n \nActive Warning: Yes\nNOAA Scale: G2 - Moderate\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 55 degrees Geomagnetic Latitude.\nInduced Currents - Power grid fluctuations can occur. High-latitude power systems may experience voltage alarms.\nSpacecraft - Satellite orientation irregularities may occur; increased drag on low Earth-orbit satellites is possible.\nRadio - HF (high frequency) radio propagation can fade at higher latitudes.\nAurora - Aurora may be seen as low as New York to Wisconsin to Washington state.","issued_at":"2026-05-04 20:32:50.633"},{"id":"K06W","message":"Space Weather Message Code: WARK06\nSerial Number: 657\nIssue Time: 2026 May 04 2339 UTC\n\nEXTENDED WARNING: Geomagnetic K-Index of 6 expected\nExtension to Serial Number: 656\nValid From: 2026 May 04 2031 UTC\nNow Valid Until: 2026 May 05 0600 UTC\nWarning Condition: Persistence\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 55 degrees Geomagnetic Latitude.\nInduced Currents - Power grid fluctuations can occur. High-latitude power systems may experience voltage alarms.\nSpacecraft - Satellite orientation irregularities may occur; increased drag on low Earth-orbit satellites is possible.\nRadio - HF (high frequency) radio propagation can fade at higher latitudes.\nAurora - Aurora may be seen as low as New York to Wisconsin to Washington state.","issued_at":"2026-05-04 23:39:43.937"},{"id":"K05W","message":"Space Weather Message Code: WARK05\nSerial Number: 2232\nIssue Time: 2026 May 04 2339 UTC\n\nEXTENDED WARNING: Geomagnetic K-index of 5 expected\nExtension to Serial Number: 2231\nValid From: 2026 May 04 1945 UTC\nNow Valid Until: 2026 May 05 0900 UTC\nWarning Condition: Persistence\n\nNOAA Space Weather Scale descriptions can be found at\nwww.swpc.noaa.gov/noaa-scales-explanation\n\nPotential Impacts: Area of impact primarily poleward of 60 degrees Geomagnetic Latitude.\nInduced Currents - Weak power grid fluctuations can occur.\nSpacecraft - Minor impact on satellite operations possible.\nAurora - Aurora may be visible at high latitudes, i.e., northern tier of the U.S. such as northern Michigan and Maine.","issued_at":"2026-05-04 23:39:43.977"}]},"meta":{"timestamp":"2026-05-31T05:48:00.850Z","request_id":"395c0875-9edc-40cb-b1ed-a4125efb68dc"},"status":"ok","message":"Alerts retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/kp":{"get":{"operationId":"get_v1_kp","tags":["Space Weather"],"summary":"Planetary K-index (latest + recent series)","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of recent 3-hour points (1-100, default 12)","schema":{"type":"string"},"example":"12"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Planetary K-index (0-9) in 3-hour intervals; higher = stronger geomagnetic activity.","latest":{"kp":3.67,"time":"2026-05-31T00:00:00","level":"Unsettled"},"series":[{"kp":3.33,"time":"2026-05-29T15:00:00"},{"kp":4,"time":"2026-05-29T18:00:00"},{"kp":3.33,"time":"2026-05-29T21:00:00"},{"kp":3.33,"time":"2026-05-30T00:00:00"},{"kp":3,"time":"2026-05-30T03:00:00"},{"kp":1.33,"time":"2026-05-30T06:00:00"},{"kp":1.67,"time":"2026-05-30T09:00:00"},{"kp":2,"time":"2026-05-30T12:00:00"},{"kp":2.33,"time":"2026-05-30T15:00:00"},{"kp":4.33,"time":"2026-05-30T18:00:00"},{"kp":4,"time":"2026-05-30T21:00:00"},{"kp":3.67,"time":"2026-05-31T00:00:00"}]},"meta":{"timestamp":"2026-05-31T05:48:00.941Z","request_id":"563135d3-05f7-4fad-a1bd-52dacd5f05a7"},"status":"ok","message":"K-index retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/scales":{"get":{"operationId":"get_v1_scales","tags":["Space Weather"],"summary":"Current NOAA scales (R radio / S radiation / G geomagnetic)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-05-31","note":"NOAA scales 0-5: R = radio blackouts, S = solar radiation storms, G = geomagnetic storms.","time":"05:47:00","radio_blackouts":{"text":"none","scale":0},"solar_radiation":{"text":"none","scale":0},"geomagnetic_storms":{"text":"none","scale":0}},"meta":{"timestamp":"2026-05-31T05:48:01.028Z","request_id":"3f265063-e46b-47ed-a752-fbebe5cc193e"},"status":"ok","message":"Scales retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/solarwind":{"get":{"operationId":"get_v1_solarwind","tags":["Space Weather"],"summary":"Real-time solar wind (speed, density, Bz/Bt)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"ACE/DSCOVR real-time solar wind at L1. Negative Bz favours geomagnetic coupling; high speed drives storms.","time":"2026-05-31 05:45:00.000","plasma":{"speed_km_s":544.9,"density_p_cm3":2.95,"temperature_k":208502},"magnetic_field":{"bt_nt":4.45,"bz_gsm_nt":-0.84}},"meta":{"timestamp":"2026-05-31T05:48:01.133Z","request_id":"58a966dc-807d-4427-9769-1724d66e0ee1"},"status":"ok","message":"Solar wind retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & scale reference","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live solar & geomagnetic conditions relayed from NOAA SWPC; not cached.","scales":{"G":"Geomagnetic storms","R":"Radio blackouts","S":"Solar radiation storms"},"source":"NOAA Space Weather Prediction Center (services.swpc.noaa.gov)","kp_scale":"0-9 (5+ = geomagnetic storm G1-G5)","endpoints":["/v1/kp","/v1/solarwind","/v1/scales","/v1/alerts","/v1/meta"]},"meta":{"timestamp":"2026-05-31T05:48:01.189Z","request_id":"d09a229d-0148-4ca8-8a82-205dcce96864"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":50000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1700,"monthly_call_quota":240000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4400,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/spaceweather-api"}