API-Schlüssel: dein Journal in deinen eigenen Skripten

Pro und Fleet.

Mit der API von TakeJournal lesen deine eigenen Skripte, Tabellen und Programmierwerkzeuge dein Journal: die Konten, die Trades, wie die Seite Trades sie zeigt, die Fills eines Kontos, die Statistiken und Gruppierungen des Dashboards, einen Tag oder eine Woche mit ihren Notizen. Sie liest nur: Nichts davon ändert dein Journal oder erreicht deinen Broker.

Einen Schlüssel erstellen

Profil → KI und API → + Neuer Schlüssel: Gib ihm einen Namen, an dem du ihn erkennst, wähle, was er lesen darf und wie lange (30, 90 oder 365 Tage), dann Schlüssel erstellen. Der Schlüssel (tja_…) wird einmal gezeigt, mit einem Aufruf zum Ausprobieren: Bewahre ihn in deinem Passwortmanager oder im Geheimnisspeicher deines Skripts auf. TakeJournal behält nur seinen Fingerabdruck; ein verlorener Schlüssel kann nicht noch einmal gezeigt werden: Erstelle einen neuen. Höchstens zehn Schlüssel gleichzeitig.

Was ein Schlüssel liest

Jeder Schlüssel liest die Konten, die Trades, die Fills und die Statistiken. Hake Notizen, das Tagesjournal, KI-Reviews und die Nachrichten von Spotter an, wenn ein Schlüssel auch lesen soll, was du geschrieben hast; ohne das fehlt es in jeder Antwort.

Die API aufrufen

Sende den Schlüssel im Header Authorization:

curl -H "Authorization: Bearer tja_…" "https://app.takejournal.com/api/v1/trades?from=2026-10-01"

Aufruf	Was er liefert
GET /api/v1/me	den Plan, Zeitzone, Währung und Sprache des Profils, die Rechte und die Gültigkeit des Schlüssels, die heutigen Aufrufe
GET /api/v1/accounts	die Konten mit ID, Alias (ACC-12), Name, Nummer, Währung und Zustand
GET /api/v1/trades	die Trades (eine auf mehrere Konten kopierte Entscheidung zählt einmal), gefiltert und seitenweise
GET /api/v1/trades/{id}	einen Trade mit seinem Journal und seinem Trade auf jedem Konto
GET /api/v1/statistics	die Statistiken des Dashboards
GET /api/v1/groups?by=weekday	die Trades nach einer oder zwei Eigenschaften gruppiert
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	einen Tag oder eine Woche mit Notizen, KI-Review und den Nachrichten von Spotter
GET /api/v1/labels	die Tags, die Kategorien und die Strategien
GET /api/v1/accounts/{id}/fills	die Fills eines Kontos, die ältesten zuerst, in UTC

Die Filter sind die der Seite Trades: from und to als Handelstage (YYYY-MM-DD), account nach ID oder Alias, symbols, strategy, tags, account_kind, market; Listen kommagetrennt. limit und offset blättern durch die Trades. Zeiten stehen in der Zeitzone deines Profils, außer ein Aufruf nennt UTC. Jeder Parameter jedes Aufrufs steht in der Beschreibung der API (OpenAPI), die keinen Schlüssel braucht.

Grenzen

Alle deine Schlüssel zusammen: Pro 60 Aufrufe pro Minute, davon 20 Statistiken oder Gruppierungen, 5.000 pro Tag; Fleet 120, 40 und 10.000; zwei gleichzeitig. Ein Aufruf über einer Grenze antwortet 429 mit Retry-After, den Sekunden bis zum nächsten Versuch; der Tag zählt in UTC. Die Aufrufe verbrauchen keine deiner KI-Antworten. Profil → KI und API zeigt die heutigen Aufrufe.

Einen Schlüssel widerrufen

Widerrufen neben dem Schlüssel, dann bestätigen: Skripte, die ihn nutzen, bekommen sofort 401. Ein Schlüssel endet auch, wenn er abläuft. Hat dein Plan die API nicht mehr, antworten seine Schlüssel mit 403, bis er sie wieder hat; neu erstellen musst du sie nicht.