Skip to content

A Python wrapper for the Australian Bureau of Meteorology's Space Weather API.


Notifications You must be signed in to change notification settings


Repository files navigation


Documentation Status Testing versions License awesome list badge

pyspaceweather is a Python wrapper for the Australian Bureau of Metererology's Space Weather API.

The API provides access to near real-time data from the BOM's Australian Space Weather Forecasting Centre.


pip install pyspaceweather


An API key, which you can get from the BOM, is required to use the API:

import os

from pyspaceweather import SpaceWeather

sw = SpaceWeather(os.environ["SPACEWEATHER_API_KEY"])

Each API request method is available as a method of SpaceWeather.

For example, to get details of any magnetic alert current for the Australian region.

alert_warnings = sw.get_mag_alert()

What's returned is a list of MagAlert objects:

[MagAlert(start_time=datetime.datetime(2015, 2, 7, 8, 45),
valid_until=datetime.datetime(2015, 2, 7, 20, 45),

Or, to get historical A-index values, you can call get_a_index(), passing a string or datetime object to the relevant parameters:

a_index_data = sw.get_a_index(start="2023-01-01 00:00:00", end=datetime(2023, 12, 1, 12, 30))


You can read documentation for this wrapper at ReadTheDocs.