Quantic para desarrolladores

Una API JSON de solo lectura y versionada, sobre HTTPS. Tu propia cartera necesita un token; los datos públicos de dividendos responden sin él.

https://quantic.finance/api/v1

Consigue un token

1. Inicia sesión y abre Ajustes. En «Acceso para IA y API», busca «Tokens de acceso personal».
2. Ponle al token el nombre del sitio donde vivirá, como «portátil» o «script de copias», y créalo. Solo se muestra una vez, así que cópialo en ese momento.
3. Envíalo en la cabecera Authorization. Guárdalo en una variable de entorno o en tu llavero, nunca en código que compartas.

Los tokens son de solo lectura: nada en esta API puede cambiar tus datos. Si revocas un token en Ajustes, deja de funcionar al momento. El mismo token sirve también para el conector de IA.

Tu primera petición

export QUANTIC_TOKEN=qtc_…
curl -H "Authorization: Bearer $QUANTIC_TOKEN" \
  https://quantic.finance/api/v1/me

Los datos públicos no necesitan token:

curl "https://quantic.finance/api/v1/calendar?days=30"

Endpoints

Todos son GET. Cuando un endpoint acepta portfolio, es el nombre de una de tus carteras; sin él, la respuesta cubre todas tus carteras.

Convenciones

Errores

Todos los errores tienen la misma forma y el estado HTTP que corresponde. Decide según el code; el message es para personas y puede cambiar.

{"error": {"code": "not_found", "message": "…"}}

Importes

Los importes son cadenas decimales, nunca floats, y siempre van con su divisa.

{"amount": "1234.56", "currency": "EUR"}

Tasas

Números sin más, con nombres que dicen su unidad: un nombre que acaba en _pct es un porcentaje; cualquier otra tasa es una fracción (0.05 es un 5%).

yield_pct: 3.1 · growth_rate: 0.05

Fechas

ISO 8601. Las marcas de tiempo, en UTC.

2026-10-08

Parámetros incorrectos

Un parámetro mal formado es un error, nunca se ignora en silencio. Un número fuera de rango se ajusta al valor permitido más cercano.

422 invalid_params

Caché

Cada respuesta lleva un ETag. Devuélvelo como If-None-Match y, si nada ha cambiado, la respuesta es un 304 sin cuerpo.

If-None-Match → 304

Límites

Sin token, 60 peticiones por minuto y dirección IP. Con uno, no hay un límite fijo: consulta cada pocos minutos, no cada segundo.

429 rate_limited

Versiones

La v1 solo crece: nuevos endpoints, parámetros y campos. Ignora los campos que no conozcas. Todo lo que rompería un cliente va en una versión nueva.

/api/v1 → /api/v2

El documento OpenAPI

Cada parámetro y cada campo de respuesta, descritos en OpenAPI 3. Genera un cliente a partir de él en vez de escribirlo a mano.

/api/v1/openapi.json