Quantic per sviluppatori
Il tuo portafoglio e i dati sui dividendi di Quantic, per i tuoi script e strumenti: un'API JSON, e un client da riga di comando e un widget per il desktop costruiti su di essa.
L'API JSON
Leggi il tuo portafoglio e i dati pubblici sui dividendi via HTTPS.
La riga di comando
Le tue posizioni, i dividendi e le entrate nel terminale.
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
DisponibileUn'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/upcoming | Obbligatorio | I tuoi prossimi dividendi, portafoglio e radar: data di stacco, data di pagamento e quanto dovrebbe pagare ciascuno. Facoltativi: days (1–120), 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.jsonLa riga di comando
Disponibilequantic, 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 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, su macOS o Linux:
brew install fleveque/tap/quantic
Oppure con Go installato:
go install github.com/fleveque/quantic-cli/cmd/quantic@latest
Oppure scaricalo per Linux, macOS o Windows, con i checksum per verificare il file: github.com/fleveque/quantic-cli/releases
È sviluppato in pubblico: github.com/fleveque/quantic-cli
Un widget per il desktop
DisponibileUn 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: installalo e accedi prima, poi aggiungi il widget:
omarchy plugin add https://github.com/fleveque/omarchy-quantic.git --enable
Se il widget non trova quantic, per esempio dopo go install, il suo README spiega come dirgli dove si trova il file. Come il client da riga di comando, è sviluppato in pubblico: github.com/fleveque/omarchy-quantic