IonoFlux API

A free REST API for space weather, ionosphere maps, observed propagation and HF path predictions. JSON everywhere, UTC timestamps, MHz frequencies.

Quick start

Every call needs an API key. Sign in, create a free key on your account page and send it in the X-API-Key header.

curl "https://ionoflux.runvia.app/v1/propagation/path?from=Seoul&to=New%20York&frequency=14.074" \
  -H "X-API-Key: ifx_your_key"
// JavaScript
const res = await fetch("https://ionoflux.runvia.app/v1/space-weather/current", {
  headers: { "X-API-Key": process.env.IONOFLUX_KEY },
});
const { solar, geomagnetic } = await res.json();
# Python
import requests
r = requests.get("https://ionoflux.runvia.app/v1/propagation/forecast",
                 params={"from": "PM37", "to": "FN20", "hours": 24},
                 headers={"X-API-Key": "ifx_your_key"})
for hour in r.json()["hours"]:
    print(hour["time"], hour["best_band"], hour["best_reliability"])

Main endpoints

GET /v1/propagation/path?from=Seoul&to=New%20York&frequency=14.074Predict a path between two places (coordinates, Maidenhead locator or place name)
GET /v1/propagation/forecast?from=PM37&to=FN20&hours=24Hour-by-hour band reliability for a path (up to 72 h)
GET /v1/space-weather/currentAll current indicators in one call
GET /v1/ionosphere/muf?format=geojsonGlobal MUF / foF2 grid (JSON or GeoJSON)
GET /v1/observations/live?minutes=15&band=20mPaths heard in the last minutes (PSK Reporter + WSPR)
GET /v1/geomagnetic/kpKp history and the 3-day forecast
GET /v1/alertsNOAA alerts and detected sporadic-E openings

Limits

Free keys: 1,000 requests per UTC day. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.

Attribution

Responses include the upstream source and license. Please credit the original providers (NOAA SWPC, GFZ, SILSO, GIRO, PSK Reporter, WSPRnet, OpenStreetMap) when you publish the data.