Clés d'API : votre journal dans vos propres scripts

Pro et Fleet.

L’API de TakeJournal permet à vos propres scripts, tableurs et outils de programmation de lire votre journal : les comptes, les trades tels que la page Trades les affiche, les exécutions d’un compte, les statistiques et regroupements du tableau de bord, un jour ou une semaine avec ses notes. Elle ne fait que lire : rien de ce qu’elle fait ne modifie votre journal ni n’atteint votre broker.

Créer une clé

Profil → IA et API → + Nouvelle clé : donnez-lui un nom que vous reconnaîtrez, choisissez ce qu’elle peut lire et pour combien de temps (30, 90 ou 365 jours), puis Créer la clé. La clé (tja_…) n’est montrée qu’une fois, avec un appel pour l’essayer : rangez-la dans votre gestionnaire de mots de passe ou les secrets de votre script. TakeJournal n’en garde que l’empreinte ; une clé perdue ne peut pas être montrée à nouveau : créez-en une autre. Au plus dix clés à la fois.

Ce qu’une clé lit

Chaque clé lit les comptes, les trades, les exécutions et les statistiques. Cochez Notes, journal du jour, revues IA et messages de Spotter pour une clé qui doit aussi lire ce que vous avez écrit ; sans cela, ils sont absents de chaque réponse.

Appeler l’API

Envoyez la clé dans l’en-tête Authorization :

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

Appel	Ce qu’il renvoie
GET /api/v1/me	l’offre, le fuseau horaire, la devise et la langue du profil, la portée et l’expiration de la clé, les appels du jour
GET /api/v1/accounts	les comptes avec leur id, leur alias (ACC-12), leur nom, leur numéro, leur devise et leur état
GET /api/v1/trades	les trades (une décision copiée sur plusieurs comptes compte une fois), filtrés et paginés
GET /api/v1/trades/{id}	un trade avec son journal et son trade sur chaque compte
GET /api/v1/statistics	les statistiques du tableau de bord
GET /api/v1/groups?by=weekday	les trades regroupés selon une ou deux propriétés
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	un jour ou une semaine avec ses notes, sa revue IA et les messages de Spotter
GET /api/v1/labels	les tags, les catégories et les stratégies
GET /api/v1/accounts/{id}/fills	les exécutions d’un compte, de la plus ancienne à la plus récente, en UTC

Les filtres sont ceux de la page Trades : from et to comme jours de trading (YYYY-MM-DD), account par id ou alias, symbols, strategy, tags, account_kind, market ; les listes sont séparées par des virgules. limit et offset paginent les trades. Les heures sont dans le fuseau horaire de votre profil, sauf si l’appel indique UTC. Chaque paramètre de chaque appel figure dans la description de l’API (OpenAPI), qui ne demande pas de clé.

Limites

Toutes vos clés ensemble : Pro 60 appels par minute, dont 20 de statistiques ou de regroupements, 5 000 par jour ; Fleet 120, 40 et 10 000 ; deux en même temps. Un appel au-delà d’une limite répond 429 avec Retry-After, les secondes à attendre ; la journée se compte en UTC. Les appels ne consomment aucune de vos réponses IA. Profil → IA et API affiche les appels du jour.

Révoquer une clé

Révoquer à côté de la clé, puis confirmez : les scripts qui l’utilisent reçoivent aussitôt 401. Une clé s’arrête aussi à son expiration. Si votre offre n’a plus l’API, ses clés répondent 403 jusqu’à ce qu’elle l’ait de nouveau ; inutile de les recréer.