Resposta direta: o conjunto mínimo de dados
Para avaliar o vencimento de uma ordem pendente, colete quatro grupos de informações: (1) detalhes da ordem, (2) a definição de vencimento na ordem, (3) as regras de tempo e execução do provedor/plataforma que interpretam esse vencimento e (4) a proveniência e a atualidade dos dados. Com apenas “a ideia de que uma ordem pode expirar”, você não consegue avaliar de forma confiável o que acontecerá no momento do vencimento, porque o comportamento de vencimento depende de como o tempo é medido e de como o provedor trata casos-limite.
Mecânica ou definição: o que “vencimento” significa para uma ordem pendente
Uma ordem pendente é uma ordem que aguarda uma condição ocorrer (por exemplo, o mercado atingindo um nível de gatilho). Vencimento significa que a ordem pendente deixa de ser válida após um ponto específico no tempo ou após um evento específico (dependendo da plataforma e das configurações da ordem).
Ao avaliar o vencimento, diferencie mecânicas estáveis de condições variáveis:
- Mecânicas estáveis: a instrução de vencimento registrada da ordem e o fato de que a ordem deve parar de ser aceita para execução após o vencimento.
- Condições variáveis: movimentos do mercado perto do momento do vencimento, custos de negociação, latência de execução e a interpretação específica do provedor sobre o tempo (como qual “relógio” é usado).
Evidência ou exemplo: um checklist prático de entradas
Use uma abordagem de checklist de controle para que você possa explicar o vencimento e verificar independentemente os fatos relevantes.
- Entradas de identidade da ordem
- Tipo de ordem (categoria de ordem pendente usada pela plataforma)
- Instrumento ou símbolo ao qual a ordem está vinculada
- Timestamp de envio da ordem e seu contexto de time zone (qual relógio a plataforma usa)
- Entradas de especificação de vencimento
- O parâmetro de vencimento conforme registrado na ordem (por exemplo, um horário explícito de vencimento, uma duração “good until” ou outra condição de vencimento)
- Se o vencimento é absoluto (data/horário específico) ou relativo (tempo a partir do momento do envio), conforme representado no registro da ordem
- Quaisquer timestamps de status relacionados (quando foi aceita, modificada ou rejeitada)
- Entradas de regras do provedor/plataforma (a “camada de interpretação”)
- A regra do provedor para como os timestamps são tratados (comumente horário do servidor em vez do seu horário local)
- A regra para o que acontece com ordens que estão próximas do vencimento (por exemplo, como o processamento parcial é tratado)
- A regra para modificações: se o horário de vencimento muda quando você altera a ordem
- Entradas de qualidade dos dados e verificação
- Fonte de verdade: de onde vem o registro da ordem (exportação do histórico da conta, ticket da ordem na plataforma ou resposta da API)
- Atualidade: se o texto do contrato/especificação e o registro da ordem foram capturados no momento em que você precisa avaliar
- Verificações de consistência: horário de vencimento no registro da ordem versus horário de vencimento exibido na tela de status da ordem
Exemplo de suposição para manter os cálculos honestos: se você converter um horário de vencimento registrado para o seu fuso horário local, informe o fuso horário e o método de conversão que você usou, e confirme que o horário registrado está de fato na mesma base de fuso horário que você assume.
Limitações e riscos: pelo menos um modo de falha
As limitações materiais incluem:
- Descompasso de time zone e relógio: se você tratar um timestamp do provedor como horário local (ou vice-versa), sua conclusão sobre se o vencimento ocorreu quando você acha que ocorreu pode estar errada.
- Ambiguidade de status em casos-limite: uma ordem pode mudar de estado (pendente, executada parcialmente, alterada, rejeitada) perto do vencimento; sem timestamps de status e as regras do provedor, você pode não saber qual evento “vence”.
- Documentação desatualizada: a interpretação do vencimento pode depender de termos da plataforma que podem mudar; o comportamento histórico de ordens não garante como ordens futuras serão tratadas.
Verificação e próxima pergunta
Você pode verificar informações sobre o vencimento de uma ordem pendente alinhando três artefatos: o registro da ordem (mostrando a instrução de vencimento), a documentação do provedor/plataforma que define como o tempo e o vencimento são interpretados e a linha do tempo do status da ordem (mostrando as mudanças de estado perto do vencimento). Se algum artefato estiver ausente ou for inconsistente, trate a avaliação como incompleta.
Próxima pergunta para você se fazer: “Eu tenho tanto a instrução exata de vencimento da ordem quanto a regra do provedor que define o relógio e o tratamento de casos-limite?” Se não, ainda não há dados suficientes para avaliar o vencimento de forma confiável.
DOCUMENT END