Chaves de API: o seu diário nos seus próprios scripts

Pro e Fleet.

A API do TakeJournal deixa seus próprios scripts, planilhas e ferramentas de programação lerem o seu diário: as contas, as operações como a página Operações as mostra, as execuções de uma conta, as estatísticas e agrupamentos do painel, um dia ou uma semana com suas notas. Ela só lê: nada do que faz altera o seu diário ou chega à sua corretora.

Criar uma chave

Perfil → IA e API → + Nova chave: dê a ela um nome que você reconheça, escolha o que pode ler e por quanto tempo (30, 90 ou 365 dias) e clique em Criar chave. A chave (tja_…) aparece uma vez, com uma chamada para testá-la: guarde-a no seu gerenciador de senhas ou nos segredos do seu script. O TakeJournal guarda só a impressão dela, então uma chave perdida não pode ser mostrada de novo: crie outra. No máximo dez chaves ao mesmo tempo.

O que uma chave lê

Toda chave lê as contas, as operações, as execuções e as estatísticas. Marque Notas, o diário do dia, as revisões com IA e as mensagens do Spotter para uma chave que também deva ler o que você escreveu; sem isso, eles ficam fora de toda resposta.

Chamar a API

Envie a chave no cabeçalho Authorization:

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

Chamada	O que responde
GET /api/v1/me	o plano, o fuso horário, a moeda e o idioma do perfil, o alcance e a validade da chave, as chamadas de hoje
GET /api/v1/accounts	as contas com id, apelido (ACC-12), nome, número, moeda e estado
GET /api/v1/trades	as operações (uma decisão copiada para várias contas conta uma vez), filtradas e paginadas
GET /api/v1/trades/{id}	uma operação com o seu diário e a sua operação em cada conta
GET /api/v1/statistics	as estatísticas do painel
GET /api/v1/groups?by=weekday	as operações agrupadas por uma ou duas propriedades
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	um dia ou uma semana com as notas, a revisão com IA e as mensagens do Spotter
GET /api/v1/labels	as tags, as categorias e as estratégias
GET /api/v1/accounts/{id}/fills	as execuções de uma conta, da mais antiga para a mais recente, em UTC

Os filtros são os da página Operações: from e to como dias de operação (YYYY-MM-DD), account por id ou apelido, symbols, strategy, tags, account_kind, market; listas separadas por vírgula. limit e offset paginam as operações. Os horários ficam no fuso horário do seu perfil, salvo quando a chamada diz UTC. Cada parâmetro de cada chamada está na descrição da API (OpenAPI), que não precisa de chave.

Limites

Todas as suas chaves juntas: Pro 60 chamadas por minuto, 20 delas de estatísticas ou agrupamentos, 5.000 por dia; Fleet 120, 40 e 10.000; duas ao mesmo tempo. Uma chamada acima de um limite responde 429 com Retry-After, os segundos de espera; o dia conta em UTC. As chamadas não gastam nenhuma das suas respostas de IA. Perfil → IA e API mostra as chamadas de hoje.

Revogar uma chave

Revogar ao lado da chave e confirme: os scripts que a usam recebem 401 na hora. Uma chave também para quando expira. Se o seu plano não tiver mais a API, as chaves respondem 403 até ele ter de novo; não é preciso criá-las outra vez.