Quipu API v1

Acceso programático a la capa analítica de Quipu: índice de riesgo compuesto por país, series diarias de señales OSINT y alertas sintetizadas para Latinoamérica. Read-only, JSON.

Autenticación

Todas las llamadas requieren una API key en el header X-API-Key (o Authorization: Bearer <key>). Pedí acceso en quipu.solutions.

curl -H "X-API-Key: TU_KEY" https://www.quipu.solutions/api/v1/index

Límite por defecto: 60 req/min por cliente (HTTP 429 si se excede). CORS habilitado para GET.

Endpoints

GET /api/v1/sources

Catálogo de señales derivadas disponibles (id, categoría, etiqueta, unidad).

GET /api/v1/history/:sourceId

Serie diaria del escalar derivado de una fuente. Parámetros: ?from=YYYY-MM-DD&to=YYYY-MM-DD o ?days=N (default 30, máx 365).

GET /api/v1/history/usgs?days=90
→ { "source":"usgs", "from":"...", "to":"...",
    "series":[ { "day":"2026-06-24", "scalar":71, "vmin":68, "vmax":80, "vlast":71, "cnt":288, "alert_count":1 }, ... ] }

GET /api/v1/index

Índice de riesgo compuesto (0-100) por país, snapshot más reciente, rankeado.

GET /api/v1/index
→ { "countries":[ { "country":"MX", "name":"México", "idx":26, "components":[{"source":"gdacs",...}] }, ... ] }

GET /api/v1/index/:country

Serie temporal del índice para un país (ISO2). ?days=N (default 90) o from/to.

GET /api/v1/anomalies

Anomalías actuales (z-score del valor vigente vs su baseline diario).

GET /api/v1/alerts

Alertas sintetizadas por Quipu en un rango. ?from=&to= o ?days=N (default 7, máx 180), ?limit= (máx 1000).

Campos del índice

campo	descripción
`idx`	índice compuesto 0-100 (intensidad histórica × atribución país × peso de categoría)
`components`	fuentes que contribuyen, con su aporte e intensidad

Sobre los datos. La API expone agregados e índices derivados calculados por Quipu — no redistribuye el payload crudo de las fuentes de terceros. Atribución y metodología en /methodology.

— Quipu · Terminal de información OSINT para Latinoamérica