API klíče: tvůj deník ve vlastních skriptech

Pro a Fleet.

API TakeJournal dovoluje tvým vlastním skriptům, tabulkám a programátorským nástrojům číst tvůj deník: účty, obchody tak, jak je ukazuje stránka Obchody, filly účtu, statistiky a seskupení z nástěnky, den nebo týden s poznámkami. Jen čte: nic, co dělá, nezmění tvůj deník ani se nedostane k tvému brokerovi.

Vytvoření klíče

Profil → AI a API → + Nový klíč: pojmenuj ho tak, abys ho poznal, vyber, co smí číst a na jak dlouho (30, 90 nebo 365 dní), a dej Vytvořit klíč. Klíč (tja_…) se ukáže jednou, s voláním na vyzkoušení: ulož si ho do správce hesel nebo mezi tajné údaje skriptu. TakeJournal si nechá jen jeho otisk, takže ztracený klíč znovu ukázat nejde: vytvoř nový. Naráz nejvýš deset klíčů.

Co klíč čte

Každý klíč čte účty, obchody, filly a statistiky. Zaškrtni Poznámky, deník dne, AI review a zprávy Spottera u klíče, který má číst i to, co jsi napsal; bez toho se tyhle části z každé odpovědi vynechají.

Volání API

Klíč pošli v hlavičce Authorization:

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

Volání	Co vrací
GET /api/v1/me	tarif, časové pásmo, měnu a jazyk profilu, rozsah a platnost klíče, dnešní volání
GET /api/v1/accounts	účty s jejich id, aliasem (ACC-12), názvem, číslem, měnou a stavem
GET /api/v1/trades	obchody (rozhodnutí kopírované na víc účtů se počítá jednou), filtrované a po stránkách
GET /api/v1/trades/{id}	jeden obchod s jeho deníkem a jeho obchodem na každém účtu
GET /api/v1/statistics	statistiky z nástěnky
GET /api/v1/groups?by=weekday	obchody seskupené podle jedné nebo dvou vlastností
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	den nebo týden s poznámkami, AI review a zprávami Spottera
GET /api/v1/labels	štítky, kategorie a strategie
GET /api/v1/accounts/{id}/fills	filly účtu od nejstaršího, v UTC

Filtry jsou stejné jako na stránce Obchody: from a to jako obchodní dny (YYYY-MM-DD), account podle id nebo aliasu, symbols, strategy, tags, account_kind, market; seznamy se oddělují čárkou. limit a offset stránkují obchody. Časy jsou v časovém pásmu tvého profilu, pokud volání neříká UTC. Každý parametr každého volání je v popisu API (OpenAPI), který klíč nepotřebuje.

Limity

Všechny tvoje klíče dohromady: Pro 60 volání za minutu, z toho 20 statistik nebo seskupení, 5 000 za den; Fleet 120, 40 a 10 000; dvě naráz. Volání nad limit vrátí 429 s Retry-After, počtem sekund, které je třeba počkat; den se počítá v UTC. Volání nespotřebují žádné tvoje AI odpovědi. Profil → AI a API ukazuje dnešní volání.

Zrušení klíče

Zrušit vedle klíče a potvrď: skripty, které ho používají, dostanou hned 401. Klíč přestane platit i tím, že vyprší. Když tvůj tarif API už nemá, jeho klíče vracejí 403, dokud ho mít zase nebude; znovu je vytvářet není potřeba.