Chiavi API: il tuo diario nei tuoi script

Pro e Fleet.

L’API di TakeJournal permette ai tuoi script, fogli di calcolo e strumenti di programmazione di leggere il tuo diario: i conti, i trade come li mostra la pagina Trade, i fill di un conto, le statistiche e i raggruppamenti della dashboard, un giorno o una settimana con le sue note. Legge soltanto: niente di ciò che fa cambia il tuo diario o raggiunge il tuo broker.

Creare una chiave

Profilo → IA e API → + Nuova chiave: dalle un nome che riconoscerai, scegli cosa può leggere e per quanto (30, 90 o 365 giorni), poi Crea chiave. La chiave (tja_…) viene mostrata una volta, con una chiamata per provarla: conservala nel tuo gestore di password o tra i segreti del tuo script. TakeJournal ne conserva solo l’impronta, quindi una chiave persa non può essere mostrata di nuovo: creane una nuova. Al massimo dieci chiavi alla volta.

Cosa legge una chiave

Ogni chiave legge conti, trade, fill e statistiche. Spunta Note, il diario del giorno, le review IA e i messaggi di Spotter per una chiave che deve leggere anche ciò che hai scritto; senza, sono esclusi da ogni risposta.

Chiamare l’API

Invia la chiave nell’intestazione Authorization:

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

Chiamata	Cosa restituisce
GET /api/v1/me	il piano, il fuso orario, la valuta e la lingua del profilo, gli ambiti e la scadenza della chiave, le chiamate di oggi
GET /api/v1/accounts	i conti con id, alias (ACC-12), nome, numero, valuta e stato
GET /api/v1/trades	i trade (una decisione copiata su più conti conta una volta), filtrati e a pagine
GET /api/v1/trades/{id}	un trade con il suo diario e il suo trade su ogni conto
GET /api/v1/statistics	le statistiche della dashboard
GET /api/v1/groups?by=weekday	i trade raggruppati per una o due proprietà
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	un giorno o una settimana con le note, la review IA e i messaggi di Spotter
GET /api/v1/labels	i tag, le categorie e le strategie
GET /api/v1/accounts/{id}/fills	i fill di un conto, dal più vecchio, in UTC

I filtri sono quelli della pagina Trade: from e to come giorni di trading (YYYY-MM-DD), account per id o alias, symbols, strategy, tags, account_kind, market; gli elenchi sono separati da virgole. limit e offset sfogliano i trade. Gli orari sono nel fuso orario del tuo profilo, salvo che la chiamata indichi UTC. Ogni parametro di ogni chiamata è nella descrizione dell’API (OpenAPI), che non richiede una chiave.

Limiti

Tutte le tue chiavi insieme: Pro 60 chiamate al minuto, di cui 20 di statistiche o raggruppamenti, 5.000 al giorno; Fleet 120, 40 e 10.000; due insieme. Una chiamata oltre un limite risponde 429 con Retry-After, i secondi da attendere; il giorno si conta in UTC. Le chiamate non consumano nessuna delle tue risposte IA. Profilo → IA e API mostra le chiamate di oggi.

Revocare una chiave

Revoca accanto alla chiave, poi conferma: gli script che la usano ricevono subito 401. Una chiave smette di funzionare anche quando scade. Se il tuo piano non ha più l’API, le sue chiavi rispondono 403 finché non la riavrà; non serve crearle di nuovo.