Outros métodos: resultados e erros.

Passo a passo por escrito

1. 0:00

   Outros métodos: resultados e erros.

   Este tutorial mostra como interpretar resultados e erros dos demais métodos MT5: dados da conta, informações de mercado, histórico, cálculos e streams WebSocket.

2. 0:16

   Abra o guia do método selecionado.

   Abra eme tê cinco ponto eme erre pê cê ponto pro. Selecione, por exemplo, Account Summary ou Opened Orders. Expanda o guia abaixo do exemplo de código e leia as instruções específicas daquele método.

3. 0:38

   1. Verifique o código de status HTTP.

   Primeiro, verifique o código de status HTTP. O código de status HTTP duzentos significa que a API recebeu a solicitação e retornou uma resposta. Leia o corpo JSON em seguida. Para outro código, examine primeiro o erro HTTP e o corpo da resposta.

4. 1:04

   2. Verifique error.

   Se error não for null, leia errorCode e errorMessage. Aqui, uma consulta real de Account Summary retornou o código de status HTTP duzentos, mas o id do terminal era inválido. O resultado vermelho indica a correção.

5. 1:26

   Corrija uma sessão inválida ou ausente.

   Para um id inválido, use o identificador completo de Connect Ex. Se o terminal não for encontrado, confira o id e a plataforma e consulte seu estado. Uma sessão encerrada precisa de uma conexão válida antes de continuar as consultas da conta.

6. 1:48

   Interprete os dados de cada método.

   Depois de verificar error, leia os campos data próprios do método. Uma lista vazia significa que não há itens correspondentes. Um contador zero pode indicar ausência de posições. False pode ser uma resposta válida a uma pergunta de sim ou não. Isso não é automaticamente uma falha da API.

7. 2:13

   Leia os campos exatos do resultado.

   Account Summary retorna os dados da conta. Positions Total retorna a quantidade de posições. Os cálculos estimam margem ou lucro, sem executar uma operação. Se o histórico estiver vazio, confira os filtros e o período solicitado.

8. 2:36

   Terminal ocupado: espere antes de repetir.

   Para Busy ou Rate Limit Exceeded, leia RetryAfterSeconds nas propriedades do erro, quando disponível. Aguarde esse intervalo e reduza as solicitações simultâneas. Se uma leitura exceder o tempo limite, confira o terminal e repita quando ele estiver pronto.

9. 3:00

   Streams: verifique cada mensagem.

   Em WebSocket, verifique error em cada mensagem antes de processar data. Um socket aberto não prova que todas as operações deram certo. Um stream silencioso ou um heartbeat vazio não são falhas. Se a conexão cair, reconecte quando necessário e leia o estado atual da conta.

10. 3:26

    Outros métodos: três verificações.

    Confira o código de status HTTP, verifique error e interprete os dados específicos do método. Nos streams, confira cada mensagem recebida. Guarde os diagnósticos, mas remova credenciais e dados da conta antes de compartilhar uma resposta.