Deriv API WebSocket: tutorial para robôs
Todo robô que opera na Deriv, inclusive o Codexium, conversa com a plataforma por uma conexão WebSocket. Entender essa conversa ajuda a ler logs, diagnosticar ordens que não fecham e separar problema de rede de problema de estratégia. Este tutorial vai do micro (uma mensagem JSON) ao macro (as regras que valem no Brasil), e o que de fato afeta a latência. O panorama geral está no guia de robôs de trading no Brasil.
O nível micro: uma conexão, várias mensagens
Diferente de uma API REST, em que cada pedido abre e fecha uma conexão, o WebSocket mantém um canal aberto nos dois sentidos. O cliente manda mensagens JSON e a Deriv responde no mesmo canal, inclusive com dados que chegam sozinhos, como cada novo tick de um índice.
O endereço público segue o formato wss://ws.derivws.com/websockets/v3?app_id=SEU_APP_ID. O app_id identifica o aplicativo; para testes, a documentação oficial usa um identificador de demonstração, mas uma ferramenta séria registra o próprio app no painel de desenvolvedor da Deriv.
As mensagens que um robô mais usa
| Mensagem | Para que serve | Precisa de token? |
|---|---|---|
{"ping": 1} | Manter a conexão viva e medir o tempo de resposta | Não |
{"ticks": "R_100"} | Assinar o fluxo de ticks de um índice | Não |
{"authorize": "TOKEN"} | Autenticar a sessão com um token de API | Sim |
{"proposal": 1, ...} | Pedir preço e payout de um contrato | Sim |
{"buy": "ID", "price": ...} | Comprar a proposta recebida | Sim |
{"forget_all": "ticks"} | Cancelar assinaturas abertas | Não |
Cada resposta traz um campo msg_type e, se algo deu errado, um objeto error com código e mensagem. Um robô bem feito nunca ignora esse campo: uma proposta expirada ou um preço que mudou geram erro, e tratar o erro é o que evita comprar no escuro.
O nível técnico: o fluxo de uma ordem
- Conectar ao endereço WebSocket com o seu
app_id. - Autorizar com um token que tenha só as permissões necessárias. Nunca use a senha da conta; veja como conectar a conta Deriv com segurança.
- Assinar ticks do índice escolhido e guardar cada um com horário, para auditoria.
- Pedir uma proposta com tipo de contrato, valor, duração e símbolo.
- Comprar usando o
idda proposta e um preço máximo, para não aceitar um valor pior do que o combinado. - Acompanhar o resultado pela assinatura do contrato aberto ou pelo extrato, e registrar o desfecho.
- Enviar
pingperiodicamente, porque conexões ociosas podem ser encerradas, e reconectar com espera crescente quando cair, sem disparar compras repetidas.
O passo 7 é onde muitos robôs caseiros falham. Se a conexão cai entre a compra e a confirmação, o programa precisa consultar o extrato antes de tentar de novo; caso contrário, pode abrir a mesma operação duas vezes.
Latência: o que muda e o que não muda
Parte do tráfego internacional de internet do Brasil chega por cabos submarinos. Isso descreve a infraestrutura do país, não garante que um robô em determinada cidade responda mais rápido à Deriv. A latência depende do caminho até o servidor da plataforma, do provedor, da própria API e do código do robô. Meça a conexão de onde o robô vai rodar e trate quedas e reconexão no software, em qualquer lugar.
O nível macro: Brasil
A Deriv é uma empresa estrangeira e não é autorizada pela CVM a ofertar valores mobiliários ao público brasileiro. Ferramentas de software que usam a API, como o Codexium, não são corretoras e não custodiam o seu saldo. Quem guarda dados de clientes no Brasil segue a LGPD (Lei 13.709/2018). Esses pontos valem em qualquer cidade do país.
Checklist antes de colocar um robô na API
- Teste todo o fluxo na conta demo, com o mesmo código que vai para a real.
- Use token com permissões mínimas e revogue os que não usa; veja como revogar token na Deriv.
- Trate todo campo
errore registre cada mensagem com horário. - Implemente ping, reconexão com espera crescente e checagem do extrato antes de repetir uma compra. Para não esbarrar no limite de requisições, veja robô de trading e rate limit na Deriv.
- Defina stop de perda e de ganho por sessão.
Resumo
A API WebSocket da Deriv é simples de entender: um canal aberto, mensagens JSON e um campo de erro que não pode ser ignorado. A infraestrutura de cabos do país liga o Brasil ao exterior, mas a velocidade da conexão não substitui teste na demo, tratamento de erro e limite de perda.
Perguntas frequentes
O que é a API WebSocket da Deriv?
É a interface que permite a um programa se conectar à Deriv por um canal aberto e trocar mensagens em JSON para consultar preços, autorizar a conta e enviar ordens.
Preciso de token para usar a API?
Para dados públicos, como ticks, em geral não. Para operar ou consultar dados da conta, é preciso autorizar a conexão com um token ou pelo fluxo OAuth.
Como tratar erros na API da Deriv?
Verifique o campo error em toda resposta, registre o código e a mensagem com horário e evite repetir a requisição em laço. Erros repetidos são motivo para pausar o robô.
O que fazer quando a conexão WebSocket cai?
Reconecte com espera crescente entre tentativas, autorize de novo e consulte as posições abertas ou o extrato antes de repetir qualquer compra, para não duplicar ordens.
Posso testar a API sem dinheiro real?
Sim. Use a conta demo com o mesmo código que iria para a conta real. Assim você valida o fluxo e o tratamento de erros sem arriscar saldo.
