Quantic pour les développeurs

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

Disponible

L'API JSON

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

En développement

La ligne de commande

Tes positions, dividendes et revenus dans le terminal.

Prévu

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

Connecte-toi et ouvre les Réglages. Dans « Accès IA et API », cherche « Jetons d'accès personnels ».
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à.
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/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

En développement

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 calendar --days 30  # no account needed
quantic status --json       # one document for status bars and scripts

Il ne s'installe pas encore, et les commandes peuvent changer avant la première version. Il est développé en public : github.com/fleveque/quantic-cli

Un widget de bureau

Prévu

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.

Les montants restent masqués dans la barre sauf si tu les actives, car la barre est visible quand tu partages ton écran. Il s'appuie sur le client en ligne de commande, donc il arrive après.