Quantic para desarrolladores

Tu cartera y los datos de dividendos de Quantic, para tus propios scripts y herramientas: una API JSON, y un cliente de línea de comandos y un widget de escritorio construidos sobre ella.

Disponible

La API JSON

Lee tu cartera y los datos públicos de dividendos por HTTPS.

Disponible

La línea de comandos

Tus posiciones, dividendos e ingresos en el terminal.

Disponible

Un widget de escritorio

Tu próximo dividendo en la barra superior de tu escritorio.

¿Usas un asistente de IA? Conéctalo a Quantic

La API JSON

Disponible

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.

Endpoint Token Devuelve
/api/v1/me Obligatorio De quién es el token. La forma más barata de comprobar uno.
/api/v1/portfolios Obligatorio Tus carteras, la predeterminada primero.
/api/v1/holdings Obligatorio Tus posiciones: acciones y coste medio. Opcional: portfolio.
/api/v1/dividends Obligatorio Los dividendos que te han pagado, los más recientes primero: bruto, retención y neto. Opcional: symbol, from, to, portfolio.
/api/v1/income Obligatorio Tus ingresos anuales previstos, brutos y netos, y una proyección año a año. Opcional: years (1–50), drip, portfolio.
/api/v1/upcoming Obligatorio Tus próximos dividendos, cartera y radar: fecha ex-dividendo, fecha de pago y lo que debería pagar cada uno. Opcional: days (1–120), portfolio.
/api/v1/calendar No hace falta Acciones que pronto pasan su fecha ex-dividendo, las más próximas primero. Opcional: days (1–120).
/api/v1/stocks No hace falta Busca por ticker o nombre. Obligatorio: q. Con un token, también busca más allá de las acciones que sigue Quantic.
/api/v1/stocks/{symbol} Opcional Una acción: precio, perfil de dividendos, seguridad y puntuaciones. Con un token, el precio es en directo.

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

La línea de comandos

Disponible

quantic, un cliente de línea de comandos construido sobre esta API: tus posiciones, dividendos e ingresos como tablas en el terminal, o como JSON para scripts. Un solo archivo que instalar y, como la API, solo lee.

quantic auth login          # stores your token in the system keyring
quantic holdings
quantic income --years 5
quantic upcoming            # your next ex-dates and payments
quantic calendar --days 30  # no account needed
quantic status --json       # one document for status bars and scripts

Con Homebrew, en macOS o Linux:

brew install fleveque/tap/quantic

O con Go instalado:

go install github.com/fleveque/quantic-cli/cmd/quantic@latest

O descárgalo para Linux, macOS o Windows, con sumas de verificación para comprobar el archivo: github.com/fleveque/quantic-cli/releases

Se desarrolla en abierto: github.com/fleveque/quantic-cli

Un widget de escritorio

Disponible

Un widget para la barra superior de Omarchy, el escritorio de Linux: tu próxima fecha ex-dividendo de un vistazo, y un panel con los dividendos de las próximas dos semanas y los ingresos de este mes hasta ahora.

El widget de Quantic en la barra de Omarchy, con la próxima fecha ex-dividendo de una posición El panel del widget: el próximo dividendo y su importe, los ingresos de este mes y cada fecha ex-dividendo y pago de los próximos 14 días

Los importes quedan ocultos en la barra a menos que los actives, porque la barra se ve cuando compartes pantalla. Funciona sobre el cliente de línea de comandos: instálalo e inicia sesión primero, y luego añade el widget:

omarchy plugin add https://github.com/fleveque/omarchy-quantic.git --enable

Si el widget no encuentra quantic, por ejemplo después de go install, su README explica cómo decirle dónde está el archivo. Como el cliente de línea de comandos, se desarrolla en abierto: github.com/fleveque/omarchy-quantic