Quantic per sviluppatori

Il tuo portafoglio e i dati sui dividendi di Quantic, per i tuoi script e strumenti: oggi un'API JSON, e in arrivo un client da riga di comando e un widget per il desktop.

Disponibile

L'API JSON

Leggi il tuo portafoglio e i dati pubblici sui dividendi via HTTPS.

In sviluppo

La riga di comando

Le tue posizioni, i dividendi e le entrate nel terminale.

Previsto

Un widget per il desktop

Il tuo prossimo dividendo nella barra superiore del desktop.

Usi invece un assistente IA? Collegalo a Quantic

L'API JSON

Disponibile

Un'API JSON in sola lettura e versionata, su HTTPS. Il tuo portafoglio richiede un token; i dati pubblici sui dividendi rispondono anche senza.

https://quantic.finance/api/v1

Ottieni un token

Accedi e apri le Impostazioni. In «Accesso per IA e API», cerca «Token di accesso personali».
Dai al token il nome del posto dove vivrà, come «portatile» o «script di backup», e crealo. Viene mostrato una sola volta, quindi copialo subito.
Invialo nell'header Authorization. Tienilo in una variabile d'ambiente o nel tuo portachiavi, mai in codice che condividi.

I token sono in sola lettura: niente in questa API può modificare i tuoi dati. Revocare un token nelle Impostazioni lo blocca subito. Lo stesso token funziona anche per il connettore IA.

La tua prima richiesta

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

I dati pubblici non richiedono un token:

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

Endpoint

Sono tutti GET. Dove un endpoint accetta portfolio, è il nome di uno dei tuoi portafogli; senza, la risposta copre tutti i tuoi portafogli.

Endpoint	Token	Restituisce
/api/v1/me	Obbligatorio	A chi appartiene il token. Il modo più economico per verificarne uno.
/api/v1/portfolios	Obbligatorio	I tuoi portafogli, quello predefinito per primo.
/api/v1/holdings	Obbligatorio	Le tue posizioni: azioni e costo medio. Facoltativo: portfolio.
/api/v1/dividends	Obbligatorio	I dividendi che ti sono stati pagati, i più recenti prima: lordo, ritenuta e netto. Facoltativi: symbol, from, to, portfolio.
/api/v1/income	Obbligatorio	Le tue entrate annuali previste, lorde e nette, e una proiezione anno per anno. Facoltativi: years (1–50), drip, portfolio.
/api/v1/calendar	Non serve	Titoli che stanno per andare ex-dividendo, i più vicini prima. Facoltativo: days (1–120).
/api/v1/stocks	Non serve	Cerca per ticker o nome. Obbligatorio: q. Con un token, cerca anche oltre i titoli che Quantic segue.
/api/v1/stocks/{symbol}	Facoltativo	Un titolo: prezzo, profilo dei dividendi, sicurezza e punteggi. Con un token, il prezzo è in tempo reale.

Convenzioni

Errori: Ogni errore ha la stessa forma e lo stato HTTP corrispondente. Decidi in base a code; message è per le persone e può cambiare.; {"error": {"code": "not_found", "message": "…"}}
Importi: Gli importi sono stringhe decimali, mai float, e hanno sempre la loro valuta.; {"amount": "1234.56", "currency": "EUR"}
Tassi: Numeri semplici, con nomi che dicono la loro unità: un nome che finisce in _pct è una percentuale, ogni altro tasso è una frazione (0.05 è il 5%).; yield_pct: 3.1 · growth_rate: 0.05
Date: ISO 8601. I timestamp sono in UTC.; 2026-10-08
Parametri non validi: Un parametro malformato è un errore, mai ignorato in silenzio. Un numero fuori intervallo viene riportato al valore consentito più vicino.; 422 invalid_params
Cache: Ogni risposta porta un ETag. Rimandalo come If-None-Match e una risposta invariata torna come 304, senza corpo.; If-None-Match → 304
Limiti: Senza token, 60 richieste al minuto per indirizzo IP. Con un token non c'è un limite fisso: interroga ogni pochi minuti, non ogni secondo.; 429 rate_limited
Versioni: La v1 cresce soltanto: nuovi endpoint, parametri e campi. Ignora i campi che non conosci. Tutto ciò che romperebbe un client va in una nuova versione.; /api/v1 → /api/v2

Il documento OpenAPI

Ogni parametro e ogni campo della risposta, descritti in OpenAPI 3. Genera un client a partire da qui invece di scriverlo a mano.

/api/v1/openapi.json

La riga di comando

In sviluppo

quantic, un client da riga di comando costruito su questa API: le tue posizioni, i dividendi e le entrate come tabelle nel terminale, o come JSON per gli script. Un solo file da installare e, come l'API, legge soltanto.

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

Non si può ancora installare, e i comandi possono cambiare prima della prima versione. È sviluppato in pubblico: github.com/fleveque/quantic-cli

Un widget per il desktop

Previsto

Un widget per la barra superiore di Omarchy, il desktop Linux: la tua prossima data ex-dividendo a colpo d'occhio, e un pannello con i dividendi delle prossime due settimane e le entrate del mese finora.

Gli importi restano nascosti nella barra finché non li attivi, perché la barra si vede quando condividi lo schermo. Funziona tramite il client da riga di comando, quindi arriva dopo.