Docs / Earthquakes and space weather

Earthquakes and space weather

These are the only endpoints whose answers are expected to change within minutes. They mirror live feeds from two public agencies, the U.S. Geological Survey for earthquakes and NOAA's Space Weather Prediction Center for geomagnetic and solar activity, refreshed every few minutes and never on request.

Live scientific data has properties that are easy to misread. An earthquake appears within minutes with an automatic location and magnitude, and seismologists revise both over the following hours or days; a magnitude 4.6 can become a 4.4, and the magnitude type can change with it. The Kp index is published for three-hour intervals, first as an estimate and later as a definitive value, and a forecast is a probability rather than a promise. Treating the first number seen as final is the usual mistake.

The other mistake is losing track of time. Each answer carries the time the event or interval refers to, the time the upstream feed was generated, and a staleness note if the mirror has not been refreshed as often as it should have been. A copy that is an hour old is still returned, because an old answer that says it is old is more useful than none.

Earthquakes can be filtered by magnitude, by period and by distance from a point, and a status field shows whether an event has been reviewed by a seismologist. Space weather covers the current summary, recent Kp, the three-day forecast, solar wind and the latest flare.

Every endpoint in this group

/feed/earthquakes?[period=]&[min_magnitude=]&[near=]&[radius_km=]&[limit=]

Recent earthquakes, newest first (USGS)

period (optional): hour, day, week or month; min_magnitude (optional): minimum magnitude; near (optional): latitude,longitude to filter around; radius_km (optional): radius for near=; limit (optional): maximum lines, 1-500

curl "https://agent-helper.org/feed/earthquakes?min_magnitude=4.5"

/feed/earthquakes/latest?[period=]&[min_magnitude=]&[near=]&[radius_km=]

The most recent earthquake matching a filter

period (optional): hour, day, week or month; min_magnitude (optional): minimum magnitude; near (optional): latitude,longitude to filter around; radius_km (optional): radius for near=

curl "https://agent-helper.org/feed/earthquakes/latest?min_magnitude=5"

/feed/earthquakes/strongest?[period=]&[min_magnitude=]&[near=]&[radius_km=]

The strongest earthquake in a period

period (optional): hour, day, week or month; min_magnitude (optional): minimum magnitude; near (optional): latitude,longitude to filter around; radius_km (optional): radius for near=

curl "https://agent-helper.org/feed/earthquakes/strongest?period=week"

/feed/space-weather

Space weather now: Kp index, NOAA scales, solar wind, latest X-ray flare

curl "https://agent-helper.org/feed/space-weather"

/feed/space-weather/kp?[hours=]

Planetary K-index, observed for the last days

hours (optional): how far back, 3-168

curl "https://agent-helper.org/feed/space-weather/kp"

/feed/space-weather/forecast

3-day Kp forecast and NOAA R/S/G scale probabilities

curl "https://agent-helper.org/feed/space-weather/forecast"

/feed/space-weather/solar-wind

Real-time solar wind at L1: speed, density, temperature, magnetic field

curl "https://agent-helper.org/feed/space-weather/solar-wind"

/feed/space-weather/flares

Latest solar X-ray flare (GOES)

curl "https://agent-helper.org/feed/space-weather/flares"