Datos y API

Ver el portal es libre. Las series y pronósticos también se pueden descargar: como CSV desde cada producto, desde un servidor HAPI o en el formato de intercambio de pronósticos. Con un registro gratuito obtienes una llave de API; sin llave puedes bajar tramos cortos y recientes.

Cómo acceder

HAPI, el estándar de la comunidad heliofísica para series de tiempo: https://helio.fisica.usach.cl/clima-espacial/hapi. Funciona con cualquier cliente HAPI (detalles).
CSV: el botón «CSV» de cada producto descarga las últimas 24 h, 7 o 30 días, o el rango que elijas.
Pronósticos en el formato de intercambio de la red, en JSON o CSV (lista más abajo).

La llave va en el encabezado X-API-Key o, si tu cliente no puede enviar encabezados (los clientes HAPI), en el parámetro api_key de la URL. Trátala como una contraseña.

Sin llave

Sin llave puedes pedir hasta 24 h de datos que terminen dentro de los últimos 7 días, o la última emisión de un pronóstico, hasta 30 veces por hora desde una misma conexión. Para más historia, regístrate.

Límites por llave

60 solicitudes por minuto (aproximado).
5 000 solicitudes y 2 000 000 filas por día UTC.
Por solicitud: hasta 31 días de una serie de 5 minutos o menos, 366 días de una más lenta, y 200 000 filas. Para más, divide el rango.
Si te pasas, la respuesta es HTTP 429 con Retry-After.

Servidor HAPI

HAPI (Heliophysics Application Programmer’s Interface) es la especificación común de la comunidad heliofísica para pedir series de tiempo por HTTP, de modo que el mismo cliente sirve para cualquier servidor.

Dirección del servidor: https://helio.fisica.usach.cl/clima-espacial/hapi
Puntos de entrada: about · capabilities · catalog · info · data
Versión: HAPI 3.3, especificación 3.3.1
Formatos: CSV, JSON

Los conjuntos de datos (datasets) son las series de la tabla siguiente: cada identificador enlaza a su descripción HAPI (info). Las series de terceros están marcadas como tales.

about, capabilities, catalog e info no piden llave. data pide una llave de API (encabezado X-API-Key o parámetro api_key), salvo tramos de hasta 24 h que terminen dentro de los últimos 7 días (ver «Sin llave»).

Series disponibles

Identificador (HAPI)	Serie	Cadencia	Licencia
`noaa.goes.electron_fluence`	Fluencia diaria de electrones >2 MeV (GOES) de terceros: NOAA SWPC	1 día (días UTC completos)	Dominio público (NOAA)
`noaa.goes.electrons`	Flujo de electrones (GOES) de terceros: NOAA SWPC	5 minutos	Dominio público (NOAA)
`noaa.goes.protons`	Flujo de protones (GOES) de terceros: NOAA SWPC	5 minutos	Dominio público (NOAA)
`noaa.goes.xray`	Flujo de rayos X (GOES) de terceros: NOAA SWPC	1 minuto	Dominio público (NOAA)
`noaa.kp`	Índice planetario Kp de terceros: NOAA SWPC	3 horas	Dominio público (NOAA)
`noaa.rtsw.mag`	Campo magnético interplanetario (L1) de terceros: NOAA SWPC	1 minuto	Dominio público (NOAA)
`noaa.rtsw.wind`	Viento solar (L1) de terceros: NOAA SWPC	1 minuto	Dominio público (NOAA)

Series de terceros: las ofrecemos por comodidad y podemos dejar de hacerlo. Para uso operacional en tiempo real, obtenlas directamente del proveedor oficial (enlace en cada fila).

Pronósticos

Pronóstico de Kp por persistencia (referencia) (CC BY 4.0): JSON · CSV — la última emisión; con llave, ?issued_since=…&issued_until=… (hasta 31 días)

Series que mostramos pero no redistribuimos

Su licencia no permite que las reenviemos. Obtenlas del proveedor:

Índices aurorales AE/AL/AU (Kyoto) (Uso no comercial (WDC Kyoto)): WDC Kyoto
Índice Dst (Kyoto) (Uso no comercial; datos preliminares (WDC Kyoto)): WDC Kyoto

Ejemplos

Reemplaza la llave de ejemplo por la tuya.

CSV con curl

curl -H "X-API-Key: TU_LLAVE" -o noaa.rtsw.mag.csv "https://helio.fisica.usach.cl/clima-espacial/api/v1/datos/noaa.rtsw.mag.csv?start=2026-10-15T00:00:00Z&stop=2026-10-22T00:00:00Z"

HAPI (URL directa)

https://helio.fisica.usach.cl/clima-espacial/hapi/data?dataset=noaa.rtsw.mag&start=2026-10-15T00:00:00Z&stop=2026-10-22T00:00:00Z&api_key=TU_LLAVE

Python (requests)

import io
import pandas as pd
import requests

r = requests.get("https://helio.fisica.usach.cl/clima-espacial/hapi/data",
                 params={"dataset": "noaa.rtsw.mag", "start": "2026-10-15T00:00:00Z", "stop": "2026-10-22T00:00:00Z"},
                 headers={"X-API-Key": "TU_LLAVE"}, timeout=60)
r.raise_for_status()
df = pd.read_csv(io.StringIO(r.text), header=None)

Los tiempos son UTC (ISO 8601) y marcan el inicio de cada intervalo. Un valor faltante es -1.0E31.

Condiciones de uso

Cada serie conserva su licencia: los productos de USACH son CC BY 4.0 (cita la fuente), los datos de la NOAA son de dominio público. Cita también al proveedor original cuando corresponda.
Los datos se entregan tal cual, sin garantía. No son avisos oficiales: para alertas, consulta a los servicios oficiales.
Las llaves son personales y podemos revocarlas si se usan para sobrecargar el servicio o se comparten públicamente.

Registro

Aviso de privacidad

Qué guardamos: tu nombre, correo, institución, sector y el uso previsto que describas; una huella (hash) de tu llave de API, nunca la llave misma; y, por cada llave, cuántas solicitudes y filas descargó cada día. Por qué: para entregarte acceso a los datos y para elaborar estadísticas de uso por sector para los informes a quienes financian el proyecto. Quién lo ve: el equipo del proyecto; nunca se vende ni se comparte con terceros, y las estadísticas que se reportan no incluyen nombres ni correos. Cuánto se conserva: mientras el registro esté activo. Cómo pedir la eliminación de tus datos: escríbenos. victor.pinto@usach.cl.