Estándar abierto

API pública

Ollin es infraestructura abierta. Todos estos endpoints son de solo lectura, gratuitos y viven bajo la misma raíz del sitio: /api/v1. Construye lo que quieras sobre ellos.

Uso justo: rate-limit por IP; las descargas CSV están limitadas a 30/hora. Si construyes algo, cita las fuentes (USGS, SSN, EMSC, NOAA) y a Ollin.

Respuestas en JSON (salvo los .csv). Las respuestas son datos reales; Ollin no predice sismos y la capa de predicciones es experimental.

Sismos

GET/api/v1/feeds/earthquakesProbar

Últimos sismos del catálogo oficial (USGS/SSN/EMSC/GEOFON).

Parámetros: source (usgs|emsc|ssn|geofon), limit (≤500)

GET/api/v1/feeds/earthquakes/searchProbar

Archivo histórico buscable con paginación.

Parámetros: source, min_magnitude, max_magnitude, start, end, region (chiapas|mexico|all), limit (≤200), offset

GET/api/v1/eventsProbar

Eventos localizados por la red ciudadana Ollin.

Parámetros: limit (≤500), min_magnitude

Clima espacial

GET/api/v1/space-weather/currentProbar

Estado actual con severidad honesta (Kp, Dst, viento solar, Bz, magnetómetro…).

GET/api/v1/space-weather/historyProbar

Serie histórica de una métrica.

Parámetros: metric (kp|dst|solar_wind|bz|magnetometer|xray_flux|proton|aurora), window (24h|7d|30d|90d|365d)

GET/api/v1/space-weather/solar-imagesProbar

Imágenes solares oficiales (SDO + LASCO) con atribución.

Estaciones y comunidad

GET/api/v1/stationsProbar

Estaciones de la red (campos públicos: sin contacto ni claves).

GET/api/v1/community/contributorsProbar

Crédito a hosts de nodos + top predictores. Sin PII.

GET/api/v1/predictions/leaderboardProbar

Track record por autor de la capa experimental de predicciones.

GET/api/v1/volcanoesProbar

Semáforo volcánico (fuente CENAPRED, admin-actualizable).

GET/api/v1/coast/tsunamiProbar

Estado de alerta de tsunami (PTWC/NWS). Por defecto: sin amenaza.

Exportar (CSV)

GET/api/v1/export/earthquakes.csvCSV

Catálogo oficial filtrable, en CSV.

Parámetros: source, min_magnitude, max_magnitude, start, end, region, limit (≤5000)

GET/api/v1/export/space-weather.csvCSV

Serie de clima espacial en CSV.

Parámetros: metric, window

GET/api/v1/export/stations.csvCSV

Estaciones (campos públicos) en CSV.

Ejemplo

# Sismos M≥4 en Chiapas, formato JSON
curl "https://TU-DOMINIO/api/v1/feeds/earthquakes/search?region=chiapas&min_magnitude=4"

# Descargar el catálogo filtrado como CSV
curl -L "https://TU-DOMINIO/api/v1/export/earthquakes.csv?region=chiapas&min_magnitude=4" -o sismos.csv

Sustituye TU-DOMINIO por el dominio donde corre Ollin. ¿Construiste algo con la API? Nos encantaría enlazarlo.