Ordens, uma avaliação para cada

Para acompanhar todas as ordens, avalie cada ordem uma vez, com a requisição v1.1 e a etiqueta trade. O corpo não traz nenhum dado da ordem: nada de instrumento, lado, quantidade, preço ou valor. O FingerTrackID avalia o dispositivo e o acesso por trás da ordem; seu sistema já tem a ordem.

Dimensionamento

Um fluxo de ordens de alta frequência precisa de uma revisão de capacidade com o FingerTrackID antes de entrar no ar: taxa de requisições, retenção e volume no console são dimensionados para o seu fluxo, não presumidos.

Fluxo

1. Prepare no navegador. Com a receita de coleta, chame prepareNextAction() quando houver atividade no formulário da ordem (seus focusin e pointerdown), nunca quando a tela de negociação carrega. O helper mantém a coleta atual dentro da janela de evidência da sua aplicação (60 ou 300 segundos, a janela de evidência) e só coleta de novo quando ela expiraria.
2. Para cada ordem, obtenha um contexto do evento. Chame takeActionContext() uma vez por ordem, no envio dela; a chamada espera no máximo o seu próprio teto (o ciclo de vida do SDK). Cada ordem recebe o seu próprio evento a partir da coleta mais recente, com um orçamento de 5000 ms por consulta desde o SDK 0.2.0. Se nenhum contexto chegar a tempo, siga com null: a avaliação volta sem nota, e a falta de contexto nunca é motivo para reter a ordem. Uma sessão do SDK emite no máximo 128 contextos do evento; o helper coleta de novo antes disso.
3. Avalie a partir do seu backend. Envie POST /v1/assessments com o corpo v1.1 e "tag": "trade". Derive external_event_id e idempotency_key do ID da sua ordem, para que uma nova tentativa da mesma ordem seja a mesma operação. As duas referências são obrigatórias.
4. Informe o que você fez. Envie a ação e o desfecho pelo assessment_id, como em qualquer outra avaliação (feedback).

Nenhuma ordem dispara uma consulta externa nem uma nova coleta: toda ordem reutiliza a evidência atual da sessão.

Um corpo sintético para uma ordem, formatado para leitura:

{
  "schema_version": "event-assessment-request.v1.1",
  "external_event_id": "evt_trade_0001",
  "idempotency_key": "idem_evt_trade_0001",
  "occurred_at": "2026-11-03T14:05:22.481Z",
  "subject_ref": "usr_5c0e",
  "account_ref": "acc_77d2",
  "event_context_token": "ect_trade_0001",
  "tag": "trade",
  "deadline_ms": null
}

O que olhar no console

Leitura	O que mostra
Eventos com a mesma etiqueta na conta	A rajada de eventos trade de uma conta no último minuto, nos últimos cinco minutos e na última hora
Eventos com a mesma etiqueta no dispositivo	A rajada de eventos trade de um dispositivo, somando todas as contas, nas mesmas janelas
Indicadores do dispositivo	BOT_AUTOMATION, EMULATED_ENVIRONMENT, BROWSER_SPOOFING e os indicadores de rede

Essas leituras são contexto para seus analistas. Elas não entram na nota e não são devolvidas pela API. As leituras de ordens da jornada TRADE do v1 contam só ordens v1; as ordens v1.1 são contadas por etiqueta.

Uso

A unidade de uso é uma coleta do navegador concluída, não uma ordem. Ordens que reutilizam a mesma coleta não somam uso, então o uso acompanha o tempo em que seus usuários negociam ativamente dividido pela janela de evidência, não o número de ordens. Os números de uso no console são estimativas, não faturas (status em produção).