SHARKRULE / Aprender

Dados desatualizados no robô: confira o evento, o recebimento e a avaliação

Um preço recebido agora pode descrever um evento de mercado anterior. Antes de interpretar o sinal de um robô de trading, confira o que o valor representa, quando o evento ocorreu, quando a ferramenta o recebeu e quando a regra o avaliou. Uma observação antiga pode comprovar uma condição passada; sozinha, não comprova o estado atual do mercado. A falta de um dado necessário significa informação desconhecida, não preço zero nem prova de que a condição é falsa.

SharkRule · Revisado em

Separe o evento de mercado do recebimento e da avaliação

O horário do evento descreve um fato registrado pela fonte. O horário de recebimento é quando a ferramenta registra sua chegada. O horário de avaliação é quando a regra utiliza o dado. Com relógios sincronizados e comparáveis, recebimento menos evento dá o atraso aparente de chegada; avaliação menos recebimento dá o tempo de espera local; avaliação menos evento dá a idade do evento na decisão. O atraso de chegada pode incluir processamento na origem, transmissão e erro de relógio: não mede apenas a demora da rede.

Confira a definição do campo antes de subtrair horários. O fluxo de negociações Spot da Binance distingue o horário do evento E do horário da negociação T; no fluxo de candles, k.T é o horário de fechamento do candle. São significados diferentes. A ferramenta precisa registrar seu próprio horário de recebimento. Se a fonte não fornecer o horário necessário, essa parte do diagnóstico continua desconhecida. Um recebimento recente, sozinho, não informa quando ocorreu a observação original.

O preço da última negociação, as ofertas atuais de compra e venda e o fechamento de um candle, ou vela, concluído respondem a perguntas diferentes. Um fechamento recente ainda resume um intervalo; não garante que alguém negocie naquele preço agora. Compare a mesma exchange, o mesmo par Spot e o mesmo campo de preço antes de concluir que duas telas discordam.

Exemplo: recebido há pouco não significa observado há pouco

Todos os preços e horários abaixo são hipotéticos. Em um mercado Spot sem ativo identificado, uma regra verifica se o preço observado é menor ou igual a 100. Este exercício aceita apenas observações cujo evento tenha no máximo cinco segundos de idade na avaliação, com relógios sincronizados. Cinco segundos é um limite inventado para o exemplo, não uma configuração recomendada, uma exigência da exchange ou um controle da SharkRule. Nenhuma ordem é enviada neste exercício.

Na primeira linha, o atraso aparente de chegada é de 4 segundos e a espera local é de 5 segundos: a idade total é 4 + 5 = 9 segundos. Embora 99 seja menor que 100, a observação não atende ao requisito de atualidade do exemplo. Ela não comprova que a condição seja verdadeira agora.

Registro hipotético; horários em UTC e preços em unidades da moeda de cotação
Horário do eventoRecebimentoAvaliaçãoPreçoIdade do eventoInterpretação
12:00:0012:00:0412:00:09999 segundosAntigo demais para este exemplo; condição atual desconhecida
12:00:1012:00:1112:00:121012 segundosRecente o suficiente para o exemplo; 101 ≤ 100 é falso
12:00:0312:00:1312:00:139810 segundosEvento anterior recebido com atraso; não é uma observação mais recente do preço atual

Recuperar dados permite conferir de novo, não executar um sinal antigo

Na segunda linha, o atraso de chegada é de 1 segundo e a espera local é de 1 segundo: o evento tem 2 segundos de idade. O exemplo pode avaliar a condição novamente, e ela é falsa. Recuperar dados utilizáveis não significa agir com base no valor antigo de 99. Na terceira linha, a mensagem recebida por último descreve um evento ocorrido sete segundos antes do evento da segunda linha. Guarde esse dado como histórico; não o use para substituir silenciosamente a observação mais recente.

Confira separadamente a validade do dado e a comparação de preços. Aqui, os resultados possíveis são evidência insuficiente, evidência utilizável com condição falsa ou evidência utilizável com condição verdadeira. Mesmo o último resultado ainda exigiria os demais requisitos, permissões e limites da regra. A linha do tempo ensina a interpretar observações; não descreve o algoritmo interno de consulta ou recuperação da SharkRule.

Um candle ausente e um candle ainda aberto exigem verificações diferentes

Um candle atualizado há pouco pode ainda estar em formação. Por outro lado, um candle fechado pode chegar atrasado. O fluxo de candles da Binance informa o fechamento separadamente pelo campo k.x; os registros de candles na API REST são identificados pelo horário de abertura. Confira o intervalo e seus limites antes de contar registros. Se um cálculo precisa de três candles consecutivos de um minuto e há aberturas às 12:00, 12:01 e 12:03, três linhas não fornecem três minutos consecutivos: falta 12:02.

Uma lacuna pode decorrer de falha na coleta, resposta incompleta ou da forma documentada como a exchange trata intervalos sem negociações. Por exemplo, a Upbit informa que não gera um candle de minuto quando não há negociação no intervalo. Essa é uma regra da Upbit, não uma descrição da Binance nem a confirmação de uma conexão da SharkRule com a Upbit. Confira a convenção da fonte antes de classificar a lacuna como interrupção do serviço.

Mantenha visível uma lacuna sem explicação. Substituí-la por zero inventa um preço; copiar o fechamento anterior inventa uma observação. As duas práticas podem alterar o cálculo da regra. Quando possível, recupere os registros necessários do mesmo mercado e intervalo e identifique quais foram realmente observados e quais foram reconstruídos. Um gráfico que parece contínuo não comprova que sua série de dados esteja completa.

O que conferir quando uma regra aguarda dados de mercado

Use esta lista para montar um breve registro do diagnóstico. Nem toda ferramenta exibe todos os horários ou ajustes: anote desconhecido quando não houver evidência. Não aumente o orçamento nem flexibilize a condição de preço apenas para fazer uma regra em espera agir.

  1. Identifique exchange, par Spot, versão da regra e dado necessário: última negociação, ofertas de compra e venda, fechamento de candle ou indicador. Mantenha a mesma fonte de dados.
  2. Registre o significado, a unidade e o fuso horário do horário informado pela fonte, além dos horários de recebimento e avaliação disponíveis. Segundos e milissegundos não são intercambiáveis. Confira o alinhamento dos relógios antes de interpretar uma idade negativa ou inesperadamente alta.
  3. Verifique separadamente a conexão e a última atualização de mercado utilizável. Uma mensagem de conexão ou solicitação bem-sucedida não comprova uma observação recente do preço. Um mercado com pouca atividade pode ficar sem novas negociações mesmo com a conexão funcionando.
  4. Para candles, confira limites dos intervalos, fechamento, duplicatas e lacunas em toda a janela exigida pela regra. Uma última linha recente não corrige a falta de um dado anterior.
  5. Registre o motivo real da espera e a última observação válida. Confira novamente com dados atuais e completos, usando a regra salva e os mesmos limites; não tente executar depois todas as oportunidades aparentes durante a interrupção.
  6. Se uma ordem real já foi enviada, confira separadamente essa ordem original e suas execuções. Recuperar os dados não esclarece um envio de resultado desconhecido, não cancela uma ordem aberta nem autoriza uma substituta.

Erro comum: confundir conexão funcionando com preço atualizado

A Binance documenta que sua API é assíncrona e que o atraso de atualização pode variar entre fontes de dados. Uma resposta bem-sucedida, portanto, não certifica que o dado seja atual. O horário antigo da última negociação também não comprova um fluxo interrompido: primeiro diferencie um mercado parado de atualizações perdidas conforme o comportamento documentado da fonte. Não existe um limite universal de idade adequado a todo dado e toda regra.

Repetir solicitações sem controle pode dificultar o diagnóstico. Respeite os limites de requisições e as instruções de nova tentativa da exchange; uma tentativa de recuperar dados não deve virar uma ordem duplicada. A Binance alerta que o tempo limite de uma ordem pode se esgotar e deixar a execução sem confirmação. Esclareça essa ordem, em vez de interpretar um fluxo de preços funcionando como prova de que ela falhou. Na SharkRule, um envio à Binance ainda não esclarecido deve continuar bloqueando novos envios à Binance.

Dados utilizáveis não reservam um preço de execução. Taxas, slippage, execuções parciais, ordens não executadas e indisponibilidade da exchange continuam possíveis; os ativos podem perder valor enquanto a regra aguarda. Uma simulação não comprova futuras execuções reais. Este guia explica o funcionamento, sem recomendar ativos, alocação, tamanho de posição ou estratégia. A SharkRule é software independente, não oferece aconselhamento financeiro ou de investimento e não tem afiliação nem endosso das exchanges.

Próximo passo: compare o motivo da espera com o horário dos dados

Abra o guia em português do simulador da SharkRule, indicado em Fontes. Ele explica como revisar o horário dos dados e aguardar dados atuais quando os necessários estão indisponíveis. Use essa explicação para conferir a condição, a atividade e o horário dos dados disponível de um Shark compatível, junto com seu orçamento virtual, antes de decidir se inicia uma simulação. O guia não confirma um limite de cinco segundos configurável pelo usuário nem promete um tempo de recuperação.

A simulação usa fundos virtuais e não autoriza ordens reais na exchange. Qualquer configuração posterior com dinheiro real exige revisão própria e início explícito; a disponibilidade depende do painel atual, da conta e da localização.

Perguntas frequentes

A página acabou de atualizar. O preço está atual?

Não necessariamente. A atualização da página, o recebimento da mensagem e o evento de mercado têm horários diferentes. Confira o horário informado pela fonte e seu significado. Uma página recém-atualizada pode entregar um valor armazenado anteriormente.

Dado ausente é o mesmo que condição falsa?

Não. Uma condição falsa exige evidência utilizável para aquela comparação. Se o dado necessário estiver ausente ou antigo demais segundo a política definida pela regra, ele não permite estabelecer se a condição é verdadeira agora. Registre o motivo da espera separadamente.

Um candle de minuto ausente sempre indica falha de conexão?

Não. Confira o mercado, o período solicitado e a convenção da fonte. Algumas exchanges omitem intervalos sem negociações; outras podem representá-los de outra forma. Não aplique a convenção de uma exchange a outra nem invente um candle para esconder a lacuna.

Dados recentes garantem que uma ordem será executada?

Não. Validade do dado, permissão para agir e execução na exchange são etapas diferentes. Mesmo após informações recentes, pode haver mudança de preço, taxas, execução parcial ou nenhuma execução. Os dados também não esclarecem o resultado de uma ordem enviada anteriormente.

Fontes oficiais

Elaborado com auxílio de IA a partir da documentação oficial indicada. Os exemplos são hipotéticos; não foram realizados testes em contas reais nem comparações de rentabilidade.