> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arbitragem-crypto.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Journal de operações

> Histórico de operações, P&L ao vivo e resultado consolidado com taxas

O journal guarda cada operação que o usuário registra, desde a abertura até o
fechamento, para que o resultado não desapareça quando a posição é encerrada.

## Fluxo

1. **Abertura** — manualmente pela tela `/journal` ou pelo botão
   "Registrar operação no journal" da calculadora, que pré-preenche ativo,
   exchange, preços e quantidades e guarda o `calculatorId` de origem. A
   calculadora continua funcionando como antes; o journal não a substitui.
2. **Acompanhamento** — operações abertas mostram o P\&L líquido não realizado
   via [stream SSE](/api-reference/endpoint/journal-stream).
3. **Fechamento** — o usuário informa os preços de saída (pré-preenchidos com
   os preços ao vivo) e, opcionalmente, as taxas reais e o funding. O resultado
   bruto, líquido e percentual fica gravado na operação.
4. **Relatórios** — resultado acumulado, taxa de acerto, total pago em taxas e
   desempenho por rota, ativo e estratégia, com exportação CSV.

## Persistência

Coleção MongoDB `journal_operations`, com índices `{email, status, openedAt}`
e `{email, closedAt}` criados na inicialização. Toda consulta filtra por
`email`.

## Acesso

A tela é exclusiva do plano premium; usuários gratuitos são redirecionados
para `/premium`. Assim como as demais rotas, a API identifica o usuário pelo
`email` enviado na requisição.

## Fora do escopo

A importação automática de trades das exchanges via API key depende da gestão
de chaves de API e fica para uma fase seguinte.

Referência: [operações](/api-reference/endpoint/journal-operations),
[resumo e CSV](/api-reference/endpoint/journal-summary),
[stream](/api-reference/endpoint/journal-stream).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.