Space weather data and atmospheric model API providing solar wind, geomagnetic indices, and models.
⚠️ API Under Construction
This API is currently in development. Endpoints and data formats are subject to change. Production availability coming soon.
Data Overview
- Kp Index: 3-hourly geomagnetic activity (0-9 scale)
- Magnetic Field: Solar wind Bx/By/Bz from DSCOVR L1
- Solar Wind: Speed, density, temperature, pressure from DSCOVR L1
- Proton Flux: Energy channels >0.5-100 MeV from GOES
- X-Ray Flux: GOES classification (A/B/C/M/X-class)
- Satellite Data: POES high-latitude and GOES geostationary measurements
- Events: Coronal mass ejections
- Models: JB2008 and MSIS atmospheric density/temperature calculations
Getting Started
To use this API, you'll need an API key. Request API access here to get started.
Detailed Guides
- POES Satellite Data Guide - Learn about POES satellite measurements (154+ types), active satellites (NOAA15/18/19, MetOp01/03), and 1B+ records
- GOES Satellite Data Guide - Learn about GOES satellite measurements (167+ types), active satellites (GOES16/17/18/19), and 34M+ records
Authentication
All API endpoints (except /health) require authentication using an API key. You can authenticate in two ways:
Option 1: Header (Recommended)
Code
Option 2: Query Parameter
Code
Rate Limits
Rate limit information is included in response headers:
X-RateLimit-Limit: Requests allowed per minuteX-RateLimit-Remaining: Remaining requests in current window
Limits:
- 200 req/min
Common Parameters
Time Parameters:
- All data endpoints require ISO 8601 timestamps (e.g., "2025-01-01T00:00:00Z")
- Maximum query span: 365 days per request
- Times are always in UTC
Pagination:
limit: 1-10000 records per page (default 1000)offset: Skip N records (default 0)
Field Units & Descriptions
| Field | Unit | Typical Range | Source |
|---|---|---|---|
| Kp Index | 0-9 (half-steps) | 0-9 | USGS |
| Bx, By, Bz | nanoTesla (nT) | ±100 | DSCOVR |
| Solar Wind Speed | km/s | 250-600 | DSCOVR |
| Density | particles/cm³ | 1-20 | DSCOVR |
| Temperature | Kelvin | 10K-100K | DSCOVR |
| Proton Flux | protons/(cm²·s·sr) | 0.1-1000 | GOES |
| X-Ray Flux | W/m² | 1e-7 to 1e-2 | GOES |
| Thermosphere Density | kg/m³ | 1e-15 to 1e-11 | Models |
| Temperature | Kelvin | 500-2000 | Models |
Space weather measurement data
Get Magnetic Field data
Retrieve solar wind magnetic field components (Bx, By, Bz) and total magnitude in Geocentric Solar Magnetospheric (GSM) coordinates. The Bz south component is the primary driver of geomagnetic storms.
Data Source: DSCOVR L1 spacecraft (Deep Space Climate Observatory)
Historical Coverage: 2015-present
Update Latency: 1-2 hours
Typical Values: ±100 nanoTesla
query Parameters
start_timeStart time ISO 8601. Data from 2015-01-01 onwards.
end_timeEnd time ISO 8601. Maximum 365 day span.
limitRecords per page. 1-min data: limit=1440 for 1 day. Default 1000.
offsetPagination offset. When returned < limit, no more data available.
Get Magnetic Field data › Responses
Successful response
statusGet Solar Wind data
Retrieve solar wind bulk parameters: speed, density, temperature, and dynamic pressure. These measurements are essential for magnetosphere modeling and geomagnetic storm forecasting. High speed + southward Bz = highest storm risk.
Data Source: DSCOVR L1 spacecraft
Historical Coverage: 2015-present
Update Latency: 1-2 hours
Typical Values: Speed 250-600 km/s, Density 1-20 particles/cm³, Temp 10K-100K K
query Parameters
start_timeStart time ISO 8601 format.
end_timeEnd time ISO 8601 format.
limitRecords per page (default 1000, max 10000).
offsetPagination offset.
Get Solar Wind data › Responses
Successful response
statusGet Proton Flux
Retrieve integral proton flux at standard energy thresholds from GOES SGPS (Space Environment Monitor). Returns pre-computed integral fluxes for 7 energy thresholds in a single response, optimized for space weather operations.
Data Source: GOES-16/17/18/19 SGPS Instrument
Historical Coverage: 2016-present (GOES-R series)
Update Latency: Near real-time
Energy Thresholds: ≥10, ≥30, ≥50, ≥60, ≥100, ≥500, ≥1000 MeV
Units: particles/cm²/s (integral flux)
Key Applications:
- Solar energetic particle (SEP) event detection
- NOAA space weather alert generation (S-scale)
- Spacecraft radiation risk assessment
- Polar cap absorption forecasting
Energy Threshold Reference:
- ≥10 MeV: Baseline SEP monitoring, NOAA S1 threshold (10 pfu)
- ≥30 MeV: HF communication impacts
- ≥50 MeV: Moderate radiation hazard
- ≥100 MeV: NOAA S3 threshold, significant radiation
- ≥500 MeV: Deep penetration, high LET events
- ≥1000 MeV: Ground Level Enhancement (GLE) indicator
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 4 active GOES satellites (GOES-16, GOES-17, GOES-18, GOES-19).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format
end_timeEnd time ISO 8601 format
satelliteFilter by GOES satellite (optional)
limitRecords per page (default 1000, max 10000)
offsetPagination offset
Get Proton Flux › Responses
Successful response
statusGet X-Ray Flux
Retrieve solar X-ray flux from GOES XRSF (X-Ray Sensor Full-disk) instrument with automatic NOAA flare classification. Returns both XRSA (0.5-4 Å) and XRSB (1-8 Å) bands with real-time flare class assignment.
Data Source: GOES-16/17/18/19 XRSF Instrument
Historical Coverage: 2016-present (GOES-R series)
Update Latency: Near real-time (1-minute cadence)
Wavelength Bands:
- XRSA: 0.5-4 Ångström (soft X-rays)
- XRSB: 1-8 Ångström (primary for NOAA classification)
NOAA Solar Flare Classification (based on XRSB flux):
- A-class: < 10⁻⁷ W/m² (background, no flare)
- B-class: 10⁻⁷ to 10⁻⁶ W/m² (minor flares, no impacts)
- C-class: 10⁻⁶ to 10⁻⁵ W/m² (small flares, minor radio blackouts)
- M-class: 10⁻⁵ to 10⁻⁴ W/m² (medium flares, HF radio blackouts, radiation storms)
- X-class: ≥ 10⁻⁴ W/m² (major flares, widespread blackouts, radiation hazard)
Each class has intensity levels 1.0-9.9 (e.g., M2.1, X1.5). The endpoint automatically computes these classifications and includes peak detection flags for flare identification.
Key Applications:
- Real-time solar flare monitoring
- Space weather alert generation
- HF communication impact assessment
- Satellite operations planning
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 4 active GOES satellites (GOES-16, GOES-17, GOES-18, GOES-19).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format
end_timeEnd time ISO 8601 format
satelliteFilter by GOES satellite (optional)
flare_categoryFilter by major flare category (optional). Use to find only significant events.
limitRecords per page (default 1000, max 10000)
offsetPagination offset
Get X-Ray Flux › Responses
Successful response
statusGet POES Satellite Data
Retrieve Polar Operational Environmental Satellites (POES) energetic particle and magnetometer data at high latitudes (~840 km polar orbit). Includes electron and proton fluxes across multiple energy channels, alpha particle fluxes, and magnetic field measurements in IGRF and Cartesian coordinates.
Data Source: NOAA POES and MetOp satellites
Active Satellites: NOAA-15, NOAA-18, NOAA-19, MetOp-01, MetOp-03
Historical Coverage: 1998-present
Update Interval: 1-minute granularity; data typically available within 1-3 days after downlink
Coverage: High-latitude regions (~840 km polar orbit)
Measurement Types:
- Position: latitude, longitude, altitude
- Magnetometer: B-field in IGRF (foot of field line, satellite), Cartesian components
- Particle Fluxes: Electrons (4 channels), Protons (8 channels), Alphas (4 channels)
- Energy Arrays: Reference energy values for each flux channel
Use Cases: Auroral substorm detection, radiation belt monitoring, space weather events
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 5 active POES satellites (NOAA-15, NOAA-18, NOAA-19, MetOp-01, MetOp-03).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format.
end_timeEnd time ISO 8601 format.
satelliteFilter by satellite (optional). Omit to return data from all available satellites.
limitRecords per page (default 1000, max 10000).
offsetPagination offset. Use for retrieving additional pages.
Get POES Satellite Data › Responses
Successful response
statusGet GOES X-Ray Sensor Flux (XRSF) Data
Retrieve X-Ray Sensor Flux measurements from GOES satellites. XRSF data includes X-ray flux measurements in the 0.1-0.8 nm (A) and 0.05-0.4 nm (B) bands used for solar flare classification.
Data Source: NOAA GOES X-Ray Sensor (XRS)
Active Satellites: GOES-16, GOES-17, GOES-18, GOES-19
Historical Coverage: GOES-16+ from 2016-present
Update Latency: Real-time (minutes)
Key Measurements: XRSA/XRSB flux (A/B bands), quality flags, roll angle
Use Cases: Solar flare monitoring, X-ray event alerts, space weather forecasting
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 4 active GOES satellites (GOES-16, GOES-17, GOES-18, GOES-19).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format.
end_timeEnd time ISO 8601 format.
satelliteFilter by satellite (optional). Omit to return data from all available satellites.
limitRecords per page (default 1000, max 10000).
offsetPagination offset. Use for retrieving additional pages.
Get GOES X-Ray Sensor Flux (XRSF) Data › Responses
Successful response
statusGet GOES Extreme Ultraviolet Sensor (EUVS) Data
Retrieve Extreme Ultraviolet Sensor (EUVS) measurements from GOES satellites. EUVS provides solar irradiance measurements at multiple EUV wavelengths and MgII core-to-wing ratio for monitoring solar extreme-ultraviolet output.
Data Source: NOAA GOES EUVS
Active Satellites: GOES-16, GOES-17, GOES-18, GOES-19
Historical Coverage: GOES-16+ from 2016-present
Update Latency: Real-time
Key Measurements: EUV irradiance at 7 wavelengths (256, 284, 304, 1175, 1216, 1335, 1405 Å), MgII index
Use Cases: Solar UV activity tracking, ionosphere forecasting, radiation climate studies
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 4 active GOES satellites (GOES-16, GOES-17, GOES-18, GOES-19).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format.
end_timeEnd time ISO 8601 format.
satelliteFilter by satellite (optional). Omit to return data from all available satellites.
limitRecords per page (default 1000, max 10000).
offsetPagination offset. Use for retrieving additional pages.
Get GOES Extreme Ultraviolet Sensor (EUVS) Data › Responses
Successful response
statusGet GOES Magnetometer (MAGN) Data
Retrieve magnetometer data from GOES satellites in multiple coordinate systems (GSE, GSM, VDH, ECI). Includes satellite attitude and orbital information for understanding magnetic field vectors in space.
Data Source: NOAA GOES Magnetometer (MAG)
Active Satellites: GOES-16, GOES-17, GOES-18, GOES-19
Historical Coverage: GOES-16+ from 2016-present
Update Latency: Real-time
Key Measurements: Magnetic field in GSE/GSM/VDH/ECI coordinates, total field magnitude, attitude, orbit
Use Cases: Magnetosphere research, geomagnetic storm monitoring, space weather modeling
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 4 active GOES satellites (GOES-16, GOES-17, GOES-18, GOES-19).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format.
end_timeEnd time ISO 8601 format.
satelliteFilter by satellite (optional). Omit to return data from all available satellites.
limitRecords per page (default 1000, max 10000).
offsetPagination offset. Use for retrieving additional pages.
Get GOES Magnetometer (MAGN) Data › Responses
Successful response
statusGet GOES Space Weather Instruments (SGPS) Data
Retrieve Space Weather Instruments Package (SGPS) data from GOES satellites including solar and galactic proton flux measurements across multiple energy channels. Data includes both integral and differential proton fluxes.
Data Source: NOAA GOES SGPS
Active Satellites: GOES-16, GOES-17, GOES-18, GOES-19
Historical Coverage: GOES-16+ from 2016-present
Update Latency: Real-time
Key Measurements: Integral/differential proton fluxes, alpha particle fluxes, energy channels
Use Cases: Radiation forecasting, proton event monitoring, SEP (Solar Energetic Particle) alerts
Important Notes:
- Record Multiplication: The number of records returned is multiplied by the number of active satellites. For example, requesting 1 day of data without filtering by satellite will return records from all 4 active GOES satellites (GOES-16, GOES-17, GOES-18, GOES-19).
- Reverse Chronological Order: Results are returned in reverse chronological order (newest first), which is opposite to the chronological order of the specified
start_timeandend_timeparameters.
query Parameters
start_timeStart time ISO 8601 format.
end_timeEnd time ISO 8601 format.
satelliteFilter by satellite (optional). Omit to return data from all available satellites.
limitRecords per page (default 1000, max 10000).
offsetPagination offset. Use for retrieving additional pages.
Get GOES Space Weather Instruments (SGPS) Data › Responses
Successful response
status