Quantic per a desenvolupadors

La teva cartera i les dades de dividends de Quantic, per als teus propis scripts i eines: una API JSON avui, i un client de línia d'ordres i un widget d'escriptori en camí.

Disponible

L'API JSON

Llegeix la teva cartera i les dades públiques de dividends per HTTPS.

En desenvolupament

La línia d'ordres

Les teves posicions, dividends i ingressos al terminal.

Previst

Un widget d'escriptori

El teu proper dividend a la barra superior del teu escriptori.

Fas servir un assistent d'IA? Connecta'l a Quantic

L'API JSON

Disponible

Una API JSON només de lectura i versionada, sobre HTTPS. La teva pròpia cartera necessita un token; les dades públiques de dividends responen sense.

https://quantic.finance/api/v1

Aconsegueix un token

Inicia sessió i obre Configuració. A «Accés per a IA i API», busca «Tokens d'accés personal».
Posa-li al token el nom del lloc on viurà, com ara «portàtil» o «script de còpies», i crea'l. Només es mostra una vegada, així que copia'l en aquell moment.
Envia'l a la capçalera Authorization. Desa'l en una variable d'entorn o al teu clauer, mai en codi que comparteixis.

Els tokens són només de lectura: res en aquesta API pot canviar les teves dades. Si revoques un token a Configuració, deixa de funcionar a l'instant. El mateix token també serveix per al connector d'IA.

La teva primera petició

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

Les dades públiques no necessiten token:

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

Endpoints

Tots són GET. Quan un endpoint accepta portfolio, és el nom d'una de les teves carteres; sense, la resposta cobreix totes les teves carteres.

Endpoint	Token	Retorna
/api/v1/me	Obligatori	De qui és el token. La manera més barata de comprovar-ne un.
/api/v1/portfolios	Obligatori	Les teves carteres, la predeterminada primer.
/api/v1/holdings	Obligatori	Les teves posicions: accions i cost mitjà. Opcional: portfolio.
/api/v1/dividends	Obligatori	Els dividends que t'han pagat, els més recents primer: brut, retenció i net. Opcional: symbol, from, to, portfolio.
/api/v1/income	Obligatori	Els teus ingressos anuals previstos, bruts i nets, i una projecció any a any. Opcional: years (1–50), drip, portfolio.
/api/v1/calendar	No cal	Accions que aviat passen la seva data ex-dividend, les més properes primer. Opcional: days (1–120).
/api/v1/stocks	No cal	Cerca per ticker o nom. Obligatori: q. Amb un token, també cerca més enllà de les accions que segueix Quantic.
/api/v1/stocks/{symbol}	Opcional	Una acció: preu, perfil de dividends, seguretat i puntuacions. Amb un token, el preu és en directe.

Convencions

Errors: Tots els errors tenen la mateixa forma i l'estat HTTP que correspon. Decideix segons el code; el message és per a persones i pot canviar.; {"error": {"code": "not_found", "message": "…"}}
Imports: Els imports són cadenes decimals, mai floats, i sempre van amb la seva divisa.; {"amount": "1234.56", "currency": "EUR"}
Taxes: Números sense més, amb noms que diuen la seva unitat: un nom que acaba en _pct és un percentatge; qualsevol altra taxa és una fracció (0.05 és un 5%).; yield_pct: 3.1 · growth_rate: 0.05
Dates: ISO 8601. Les marques de temps, en UTC.; 2026-10-08
Paràmetres incorrectes: Un paràmetre mal format és un error, mai s'ignora en silenci. Un número fora de rang s'ajusta al valor permès més proper.; 422 invalid_params
Memòria cau: Cada resposta porta un ETag. Torna'l com a If-None-Match i, si res no ha canviat, la resposta és un 304 sense cos.; If-None-Match → 304
Límits: Sense token, 60 peticions per minut i adreça IP. Amb un, no hi ha cap límit fix: consulta cada pocs minuts, no cada segon.; 429 rate_limited
Versions: La v1 només creix: nous endpoints, paràmetres i camps. Ignora els camps que no coneguis. Tot el que trencaria un client va en una versió nova.; /api/v1 → /api/v2

El document OpenAPI

Cada paràmetre i cada camp de resposta, descrits en OpenAPI 3. Genera un client a partir d'ell en lloc d'escriure'l a mà.

/api/v1/openapi.json

La línia d'ordres

En desenvolupament

quantic, un client de línia d'ordres construït sobre aquesta API: les teves posicions, dividends i ingressos com a taules al terminal, o com a JSON per a scripts. Un sol fitxer per instal·lar i, com l'API, només llegeix.

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

Encara no es pot instal·lar, i les ordres poden canviar abans de la primera versió. Es desenvolupa en obert: github.com/fleveque/quantic-cli

Un widget d'escriptori

Previst

Un widget per a la barra superior d'Omarchy, l'escriptori de Linux: la teva propera data ex-dividend d'un cop d'ull, i un panell amb els dividends de les properes dues setmanes i els ingressos d'aquest mes fins ara.

Els imports queden amagats a la barra si no els actives, perquè la barra es veu quan comparteixes pantalla. Funciona sobre el client de línia d'ordres, així que arriba després.