Quantic für Entwickler

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

Verfügbar

Die JSON-API

Lies dein Portfolio und öffentliche Dividendendaten über HTTPS.

In Entwicklung

Die Kommandozeile

Deine Positionen, Dividenden und Einnahmen im Terminal.

Geplant

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

Melde dich an und öffne die Einstellungen. Unter „Zugriff für KI und API“ findest du „Persönliche Zugriffstokens“.
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.
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/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

In Entwicklung

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

Er lässt sich noch nicht installieren, und die Befehle können sich bis zur ersten Version ändern. Er entsteht öffentlich: github.com/fleveque/quantic-cli

Ein Desktop-Widget

Geplant

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.

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 und kommt deshalb danach.