De criar a chave de API, escolher permissões e configurar a lista de IPs permitidos ao que cada código de erro significa quando uma ordem é recusada e o que fazer.
Ainda não tem conta na OKX? Cadastre-se na OKX
A API da OKX é o canal para um programa falar direto com a sua conta na OKX: consultar saldo e posições, enviar e cancelar ordens, tudo sem abrir o site. Programas de trading automático enviam ordens pelas regras através da API.
Para usar a API, primeiro crie uma chave. Com ela o programa prova que tem autorização da sua conta. O que a chave pode fazer depende das permissões que você ativar ao criá-la.
Entregue as três ao programa de trading automático. Faltando uma, ele não conecta.
O FAQ oficial da API da OKX deixa claro: uma chave com permissão de negociação ou de saque e sem IP vinculado é apagada automaticamente após 14 dias sem atividade. Com um IP vinculado, a chave não expira por inatividade e quem conseguir a chave não consegue usá-la de outro lugar. Cada chave aceita até 20 IPs.
Se for vincular, informe o IP público da máquina que roda o programa, não o do seu celular nem o da internet que você usa no dia a dia. O IP da internet de casa pode mudar e, quando mudar, adicione o novo à lista.
Com o Blave Agent, a caixa de conexão do servidor na nuvem mostra o IP dele, é só copiar. O app para desktop não exige vincular, mas se não vincular, lembre da regra dos 14 dias.
Estes são os erros que mais aparecem no trading automático. O significado segue a documentação oficial da API da OKX (o 51008 segue a classificação do programa de ordens da Blave) e a solução é uma orientação geral.
| Código | Significado | O que fazer |
|---|---|---|
| Primeiro grupo: problemas de chave e permissão, recusados logo ao conectar ou enviar a ordem | ||
| 50111 | API key inválida | Confira se colou certo e sem espaços sobrando no início ou no fim |
| 50113 | Assinatura inválida | Geralmente é a secret key colada errada. Cole de novo |
| 50105 | Passphrase errada | Use a que você definiu ao criar a chave, não a senha de login |
| 50110 | IP fora da lista de permitidos | Adicione o novo IP da máquina que roda o programa à lista |
| 50119 | A chave não existe | Pode ter sido apagada (por exemplo, pela regra dos 14 dias). Crie outra |
| 50100 | API congelada | Fale com o suporte da OKX |
| Segundo grupo: a chave está certa, mas essa ordem não consegue sair | ||
| 51010 | O modo de conta atual não permite | No Spot mode não dá para operar futuros. Mude para um modo que aceite futuros na configuração de modo da conta |
| 51008 | Margem insuficiente | Adicione fundos ou diminua o valor da estratégia |
| 51020 | Abaixo do tamanho mínimo de ordem | Aumente o valor da estratégia ou escolha uma moeda com unidade mínima menor |
| 50102 | Timestamp da requisição expirado | O relógio da máquina que roda o programa está fora de hora. Ative a sincronização automática de horário |
| Terceiro grupo: resultado incerto, pede mais cuidado | ||
| 50004 | Timeout na requisição de API | Não reenvie. Confira a ordem primeiro |
| 51149 | Timeout ao enviar a ordem | Não reenvie. Confira a ordem primeiro |
| 50001 | Serviço temporariamente indisponível | Não reenvie. Confira a ordem primeiro |
| 50026 | Erro de sistema | Não reenvie. Confira a ordem primeiro |
A documentação da OKX diz com todas as letras que 50004 e 51149 "não significam que a requisição teve sucesso ou falhou". A ordem pode já ter sido executada, e reenviar faria ela entrar duas vezes. Diante desses quatro códigos, o Blave Agent nunca reenvia a mesma ordem: numa ordem a mercado de futuros, ele confere se foi executada antes de decidir o próximo passo, e qualquer outra ordem para e avisa, sem nova tentativa automática.
Se você mesmo programar a conexão com a API da OKX, é aqui que as coisas mais dão errado.
Todo o tratamento de erros acima, incluindo sincronizar o horário com a OKX diante de um 50102 e não reenviar após timeout, já está pronto no programa de ordens do Blave Agent. Basta colar a API key, a secret key e a passphrase em Trading automático › Conectar conta › OKX, e a estratégia envia ordens na OKX pelas regras.
Antes de conectar uma conta real, vale rodar no paper trading por um tempo. Não precisa de chave e você começa com 100,000 USDT.
Baixar o app para desktopPara o passo a passo completo, veja Configurar as chaves de trading da exchange. Para o caminho todo da ideia à operação real, veja Trading automático na OKX: da ideia à operação real.
Chaves de API expiram?
Uma chave com IP vinculado não expira por inatividade. Uma com permissão de negociação ou de saque e sem IP vinculado é apagada após 14 dias sem atividade.
E se eu esquecer a passphrase?
Não dá para recuperar. Apague essa chave, crie outra e cole as três partes novas de volta no programa.
Em que horário as ordens mais dão timeout?
A OKX recomenda evitar 8:00, 16:00 e 24:00 todos os dias (horário de Taiwan, UTC+8). São as liquidações de funding, quando os servidores ficam mais carregados.
Uma chave de API é a autorização para operar a sua conta, então não cole em sites ou programas em que você não confia. Nunca ative a permissão de saque e apague as chaves que não usa mais. O trading automático não faz as perdas sumirem, só executa as regras. Com alavancagem, as perdas também aumentam.