Klucze API: twój dziennik we własnych skryptach

Pro i Fleet.

API TakeJournal pozwala twoim skryptom, arkuszom i narzędziom programistycznym odczytywać twój dziennik: konta, transakcje tak, jak pokazuje je strona Transakcje, fille konta, statystyki i grupowania z pulpitu, dzień lub tydzień z notatkami. Tylko odczytuje: nic, co robi, nie zmienia twojego dziennika ani nie dociera do twojego brokera.

Tworzenie klucza

Profil → AI i API → + Nowy klucz: nadaj mu nazwę, którą rozpoznasz, wybierz, co może odczytywać i na jak długo (30, 90 lub 365 dni), potem Utwórz klucz. Klucz (tja_…) pokazujemy raz, z wywołaniem do wypróbowania: przechowuj go w menedżerze haseł lub w sekretach skryptu. TakeJournal zachowuje tylko jego odcisk, więc zgubionego klucza nie da się pokazać ponownie: utwórz nowy. Najwyżej dziesięć kluczy naraz.

Co odczytuje klucz

Każdy klucz odczytuje konta, transakcje, fille i statystyki. Zaznacz Notatki, dziennik dnia, przeglądy AI i wiadomości Spottera dla klucza, który ma też czytać to, co napisałeś; bez tego są pomijane w każdej odpowiedzi.

Wywoływanie API

Wyślij klucz w nagłówku Authorization:

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

Wywołanie	Co zwraca
GET /api/v1/me	plan, strefę czasową, walutę i język profilu, zakres i ważność klucza, dzisiejsze wywołania
GET /api/v1/accounts	konta z id, aliasem (ACC-12), nazwą, numerem, walutą i stanem
GET /api/v1/trades	transakcje (decyzja skopiowana na kilka kont liczy się raz), filtrowane i stronicowane
GET /api/v1/trades/{id}	jedną transakcję z jej dziennikiem i jej transakcją na każdym koncie
GET /api/v1/statistics	statystyki z pulpitu
GET /api/v1/groups?by=weekday	transakcje pogrupowane według jednej lub dwóch właściwości
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	dzień lub tydzień z notatkami, przeglądem AI i wiadomościami Spottera
GET /api/v1/labels	tagi, kategorie i strategie
GET /api/v1/accounts/{id}/fills	fille konta od najstarszego, w UTC

Filtry są takie jak na stronie Transakcje: from i to jako dni handlowe (YYYY-MM-DD), account według id lub aliasu, symbols, strategy, tags, account_kind, market; listy rozdziela się przecinkami. limit i offset stronicują transakcje. Czasy są w strefie czasowej twojego profilu, chyba że wywołanie mówi UTC. Każdy parametr każdego wywołania jest w opisie API (OpenAPI), który nie wymaga klucza.

Limity

Wszystkie twoje klucze razem: Pro 60 wywołań na minutę, w tym 20 statystyk lub grupowań, 5000 dziennie; Fleet 120, 40 i 10 000; dwa naraz. Wywołanie ponad limit zwraca 429 z Retry-After, liczbą sekund do odczekania; dzień liczy się w UTC. Wywołania nie zużywają twoich odpowiedzi AI. Profil → AI i API pokazuje dzisiejsze wywołania.

Unieważnianie klucza

Unieważnij obok klucza i potwierdź: skrypty, które go używają, od razu dostają 401. Klucz przestaje działać także po wygaśnięciu. Jeśli twój plan nie ma już API, jego klucze zwracają 403, dopóki znów go nie będzie miał; nie trzeba ich tworzyć od nowa.