Quantic pour les développeurs

Ton portefeuille et les données de dividendes de Quantic, pour tes propres scripts et outils : une API JSON, et un client en ligne de commande et un widget de bureau construits dessus.

Disponible

L'API JSON

Lis ton portefeuille et les données publiques de dividendes en HTTPS.

Disponible

La ligne de commande

Tes positions, dividendes et revenus dans le terminal.

Disponible

Un widget de bureau

Ton prochain dividende dans la barre du haut de ton bureau.

Tu utilises plutôt un assistant IA ? Connecte-le à Quantic

L'API JSON

Disponible

Une API JSON en lecture seule et versionnée, en HTTPS. Ton propre portefeuille demande un jeton ; les données publiques de dividendes répondent sans.

https://quantic.finance/api/v1

Obtenir un jeton

  1. Connecte-toi et ouvre les Réglages. Dans « Accès IA et API », cherche « Jetons d'accès personnels ».
  2. Nomme le jeton d'après l'endroit où il servira, comme « portable » ou « script de sauvegarde », et crée-le. Il n'est affiché qu'une fois : copie-le à ce moment-là.
  3. Envoie-le dans l'en-tête Authorization. Garde-le dans une variable d'environnement ou ton trousseau, jamais dans du code que tu partages.

Les jetons sont en lecture seule : rien sur cette API ne peut modifier tes données. Révoquer un jeton dans les Réglages l'arrête aussitôt. Le même jeton marche aussi pour le connecteur IA.

Ta première requête

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

Les données publiques ne demandent pas de jeton :

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

Endpoints

Tous sont en GET. Quand un endpoint accepte portfolio, c'est le nom d'un de tes portefeuilles ; sans lui, la réponse couvre tous tes portefeuilles.

Endpoint Jeton Renvoie
/api/v1/me Obligatoire À qui appartient le jeton. Le moyen le moins coûteux d'en vérifier un.
/api/v1/portfolios Obligatoire Tes portefeuilles, celui par défaut en premier.
/api/v1/holdings Obligatoire Tes positions : nombre d'actions et coût moyen. Facultatif : portfolio.
/api/v1/dividends Obligatoire Les dividendes qui t'ont été versés, les plus récents d'abord : brut, retenue et net. Facultatif : symbol, from, to, portfolio.
/api/v1/income Obligatoire Tes revenus annuels à venir, bruts et nets, et une projection année par année. Facultatif : years (1–50), drip, portfolio.
/api/v1/upcoming Obligatoire Tes prochains dividendes, portefeuille et radar : date ex-dividende, date de paiement et ce que chacun devrait verser. Facultatif : days (1–120), portfolio.
/api/v1/calendar Pas nécessaire Les actions dont la date de détachement approche, les plus proches d'abord. Facultatif : days (1–120).
/api/v1/stocks Pas nécessaire Recherche par ticker ou par nom. Obligatoire : q. Avec un jeton, la recherche va aussi au-delà des actions que Quantic suit.
/api/v1/stocks/{symbol} Facultatif Une action : cours, profil de dividende, sécurité et scores. Avec un jeton, le cours est en direct.

Conventions

Erreurs
Toutes les erreurs ont la même forme et le statut HTTP correspondant. Décide selon le code ; le message est destiné aux humains et peut changer.
{"error": {"code": "not_found", "message": "…"}}
Montants
Les montants sont des chaînes décimales, jamais des flottants, et toujours accompagnés de leur devise.
{"amount": "1234.56", "currency": "EUR"}
Taux
Des nombres simples, nommés d'après leur unité : un nom finissant par _pct est un pourcentage, tout autre taux est une fraction (0.05 vaut 5 %).
yield_pct: 3.1 · growth_rate: 0.05
Dates
ISO 8601. Les horodatages sont en UTC.
2026-10-08
Paramètres invalides
Un paramètre mal formé est une erreur, jamais ignoré en silence. Un nombre hors limites est ramené à la valeur autorisée la plus proche.
422 invalid_params
Cache
Chaque réponse porte un ETag. Renvoie-le en If-None-Match et une réponse inchangée revient en 304, sans corps.
If-None-Match → 304
Limites
Sans jeton, 60 requêtes par minute et par adresse IP. Avec un jeton, pas de limite fixe : interroge toutes les quelques minutes, pas toutes les secondes.
429 rate_limited
Versions
La v1 ne fait que s'enrichir : nouveaux endpoints, paramètres et champs. Ignore les champs que tu ne connais pas. Tout ce qui casserait un client va dans une nouvelle version.
/api/v1 → /api/v2

Le document OpenAPI

Chaque paramètre et chaque champ de réponse, décrits en OpenAPI 3. Génère un client à partir de lui plutôt que d'en écrire un à la main.

/api/v1/openapi.json

La ligne de commande

Disponible

quantic, un client en ligne de commande construit sur cette API : tes positions, dividendes et revenus en tableaux dans le terminal, ou en JSON pour les scripts. Un seul fichier à installer et, comme l'API, il ne fait que lire.

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

Avec Homebrew, sur macOS ou Linux :

brew install fleveque/tap/quantic

Ou avec Go installé :

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

Ou télécharge-le pour Linux, macOS ou Windows, avec des sommes de contrôle pour vérifier le fichier : github.com/fleveque/quantic-cli/releases

Il est développé en public : github.com/fleveque/quantic-cli

Un widget de bureau

Disponible

Un widget pour la barre du haut d'Omarchy, le bureau Linux : ta prochaine date de détachement d'un coup d'œil, et un panneau avec les dividendes des deux prochaines semaines et les revenus du mois jusqu'ici.

Le widget Quantic dans la barre d'Omarchy, avec la prochaine date ex-dividende d'une position Le panneau du widget : le prochain dividende et son montant, les revenus de ce mois et chaque date ex-dividende et paiement des 14 prochains jours

Les montants restent masqués dans la barre sauf si tu les actives, car la barre est visible quand tu partages ton écran. Il fonctionne avec le client en ligne de commande : installe-le et connecte-toi d'abord, puis ajoute le widget :

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

Si le widget ne trouve pas quantic, après go install par exemple, son README explique comment lui indiquer où se trouve le fichier. Comme le client en ligne de commande, il est développé en public : github.com/fleveque/omarchy-quantic