Claves de API: tu diario en tus propios scripts

Pro y Fleet.

La API de TakeJournal permite que tus propios scripts, hojas de cálculo y herramientas de programación lean tu diario: las cuentas, las operaciones tal como las muestra la página Operaciones, las ejecuciones de una cuenta, las estadísticas y agrupaciones del panel, un día o una semana con sus notas. Solo lee: nada de lo que hace cambia tu diario ni llega a tu broker.

Crear una clave

Perfil → IA y API → + Nueva clave: dale un nombre que reconozcas, elige qué puede leer y durante cuánto tiempo (30, 90 o 365 días) y pulsa Crear clave. La clave (tja_…) se muestra una vez, con una llamada para probarla: guárdala en tu gestor de contraseñas o en los secretos de tu script. TakeJournal solo guarda su huella, así que una clave perdida no puede mostrarse de nuevo: crea otra. Como máximo diez claves a la vez.

Qué lee una clave

Toda clave lee las cuentas, las operaciones, las ejecuciones y las estadísticas. Marca Notas, el diario del día, las revisiones con IA y los mensajes de Spotter en una clave que también deba leer lo que escribiste; sin eso, quedan fuera de cada respuesta.

Llamar a la API

Envía la clave en la cabecera Authorization:

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

Llamada	Qué devuelve
GET /api/v1/me	el plan, la zona horaria, la moneda y el idioma del perfil, el alcance y la caducidad de la clave, las llamadas de hoy
GET /api/v1/accounts	las cuentas con su id, alias (ACC-12), nombre, número, moneda y estado
GET /api/v1/trades	las operaciones (una decisión copiada a varias cuentas cuenta una vez), filtradas y por páginas
GET /api/v1/trades/{id}	una operación con su diario y su operación en cada cuenta
GET /api/v1/statistics	las estadísticas del panel
GET /api/v1/groups?by=weekday	las operaciones agrupadas por una o dos propiedades
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	un día o una semana con sus notas, su revisión con IA y los mensajes de Spotter
GET /api/v1/labels	las etiquetas, las categorías y las estrategias
GET /api/v1/accounts/{id}/fills	las ejecuciones de una cuenta, de la más antigua a la más reciente, en UTC

Los filtros son los de la página Operaciones: from y to como días de trading (YYYY-MM-DD), account por id o alias, symbols, strategy, tags, account_kind, market; las listas van separadas por comas. limit y offset paginan las operaciones. Las horas están en la zona horaria de tu perfil salvo que la llamada diga UTC. Cada parámetro de cada llamada está en la descripción de la API (OpenAPI), que no necesita clave.

Límites

Todas tus claves juntas: Pro 60 llamadas por minuto, 20 de ellas de estadísticas o agrupaciones, 5.000 al día; Fleet 120, 40 y 10.000; dos a la vez. Una llamada por encima de un límite responde 429 con Retry-After, los segundos de espera; el día cuenta en UTC. Las llamadas no gastan ninguna de tus respuestas de IA. Perfil → IA y API muestra las llamadas de hoy.

Revocar una clave

Revocar junto a la clave y confirma: los scripts que la usan reciben 401 al instante. Una clave también deja de valer cuando caduca. Si tu plan ya no incluye la API, sus claves responden 403 hasta que vuelva a incluirla; no hace falta crearlas de nuevo.