Quantic für Entwickler

Dein Portfolio und die Dividendendaten von Quantic, für deine eigenen Skripte und Tools: eine JSON-API, und ein Kommandozeilen-Client und ein Desktop-Widget, die darauf aufbauen.

Verfügbar

Die JSON-API

Lies dein Portfolio und öffentliche Dividendendaten über HTTPS.

Verfügbar

Die Kommandozeile

Deine Positionen, Dividenden und Einnahmen im Terminal.

Verfügbar

Ein Desktop-Widget

Deine nächste Dividende in der oberen Leiste deines Desktops.

Nutzt du lieber einen KI-Assistenten? Verbinde ihn mit Quantic

Die JSON-API

Verfügbar

Eine schreibgeschützte, versionierte JSON-API über HTTPS. Dein eigenes Portfolio braucht ein Token; öffentliche Dividendendaten antworten auch ohne.

https://quantic.finance/api/v1

Ein Token erstellen

  1. Melde dich an und öffne die Einstellungen. Unter „Zugriff für KI und API“ findest du „Persönliche Zugriffstokens“.
  2. Benenne das Token nach dem Ort, an dem es lebt, etwa „Laptop“ oder „Backup-Skript“, und erstelle es. Es wird nur einmal angezeigt, also kopiere es gleich.
  3. Schick es im Authorization-Header mit. Bewahre es in einer Umgebungsvariable oder deinem Schlüsselbund auf, nie in Code, den du teilst.

Tokens sind schreibgeschützt: Nichts an dieser API kann deine Daten ändern. Widerrufst du ein Token in den Einstellungen, ist es sofort gesperrt. Dasselbe Token funktioniert auch für den KI-Connector.

Deine erste Anfrage

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

Öffentliche Daten brauchen kein Token:

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

Endpunkte

Alle sind GET. Wo ein Endpunkt portfolio annimmt, ist es der Name eines deiner Portfolios; ohne ihn umfasst die Antwort alle deine Portfolios.

Endpunkt Token Liefert
/api/v1/me Erforderlich Wem das Token gehört. Der günstigste Weg, eines zu prüfen.
/api/v1/portfolios Erforderlich Deine Portfolios, das Standardportfolio zuerst.
/api/v1/holdings Erforderlich Deine Positionen: Stückzahl und Durchschnittskosten. Optional: portfolio.
/api/v1/dividends Erforderlich Dir gezahlte Dividenden, die neuesten zuerst: brutto, Quellensteuer und netto. Optional: symbol, from, to, portfolio.
/api/v1/income Erforderlich Dein erwartetes Jahreseinkommen, brutto und netto, und eine Projektion Jahr für Jahr. Optional: years (1–50), drip, portfolio.
/api/v1/upcoming Erforderlich Deine nächsten Dividenden, Bestände und Radar: Ex-Dividenden-Datum, Zahlungsdatum und was jede zahlen sollte. Optional: days (1–120), portfolio.
/api/v1/calendar Nicht nötig Aktien, die bald ex Dividende gehen, die nächsten zuerst. Optional: days (1–120).
/api/v1/stocks Nicht nötig Suche nach Ticker oder Name. Pflicht: q. Mit einem Token sucht sie auch über die Aktien hinaus, die Quantic verfolgt.
/api/v1/stocks/{symbol} Optional Eine Aktie: Kurs, Dividendenprofil, Sicherheit und Scores. Mit einem Token ist der Kurs live.

Konventionen

Fehler
Jeder Fehler hat dieselbe Form und den passenden HTTP-Status. Verzweige anhand von code; message ist für Menschen und kann sich ändern.
{"error": {"code": "not_found", "message": "…"}}
Beträge
Beträge sind Dezimal-Strings, nie Floats, und kommen immer mit ihrer Währung.
{"amount": "1234.56", "currency": "EUR"}
Raten
Einfache Zahlen, benannt nach ihrer Einheit: Ein Name auf _pct ist ein Prozentwert, jede andere Rate ein Bruchteil (0.05 sind 5 %).
yield_pct: 3.1 · growth_rate: 0.05
Datumsangaben
ISO 8601. Zeitstempel sind in UTC.
2026-10-08
Ungültige Parameter
Ein fehlerhafter Parameter ist ein Fehler und wird nie stillschweigend ignoriert. Eine Zahl außerhalb des Bereichs wird auf den nächsten erlaubten Wert begrenzt.
422 invalid_params
Caching
Jede Antwort trägt ein ETag. Schick es als If-None-Match zurück, und eine unveränderte Antwort kommt als 304 ohne Body.
If-None-Match → 304
Limits
Ohne Token 60 Anfragen pro Minute und IP-Adresse. Mit Token gibt es kein festes Limit: Frag alle paar Minuten ab, nicht jede Sekunde.
429 rate_limited
Versionierung
v1 wächst nur: neue Endpunkte, Parameter und Felder. Ignoriere Felder, die du nicht kennst. Alles, was einen Client brechen würde, kommt in eine neue Version.
/api/v1 → /api/v2

Das OpenAPI-Dokument

Jeder Parameter und jedes Antwortfeld, beschrieben in OpenAPI 3. Erzeuge einen Client daraus, statt ihn von Hand zu schreiben.

/api/v1/openapi.json

Die Kommandozeile

Verfügbar

quantic, ein Kommandozeilen-Client auf Basis dieser API: deine Positionen, Dividenden und Einnahmen als Tabellen im Terminal oder als JSON für Skripte. Eine einzige Datei zum Installieren, und wie die API liest er nur.

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

Mit Homebrew, unter macOS oder Linux:

brew install fleveque/tap/quantic

Oder mit installiertem Go:

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

Oder lade ihn für Linux, macOS oder Windows herunter, mit Prüfsummen, um die Datei zu prüfen: github.com/fleveque/quantic-cli/releases

Er entsteht öffentlich: github.com/fleveque/quantic-cli

Ein Desktop-Widget

Verfügbar

Ein Widget für die obere Leiste von Omarchy, dem Linux-Desktop: dein nächster Ex-Dividenden-Tag auf einen Blick und ein Panel mit den Dividenden der nächsten zwei Wochen und den bisherigen Einnahmen dieses Monats.

Das Quantic-Widget in der Omarchy-Leiste mit dem nächsten Ex-Dividenden-Datum einer Position Das Panel des Widgets: die nächste Dividende und ihr Betrag, die Einnahmen dieses Monats und jedes Ex-Dividenden-Datum und jede Zahlung der nächsten 14 Tage

Beträge bleiben in der Leiste verborgen, bis du sie einschaltest, denn die Leiste ist sichtbar, wenn du deinen Bildschirm teilst. Es läuft über den Kommandozeilen-Client: Installiere ihn und melde dich zuerst an, dann füge das Widget hinzu:

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

Wenn das Widget quantic nicht findet, zum Beispiel nach go install, erklärt seine README, wie du ihm sagst, wo die Datei liegt. Wie der Kommandozeilen-Client entsteht es öffentlich: github.com/fleveque/omarchy-quantic