API da OKX: crie a chave, permissões e trading automático

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.

Última atualização 2026-11
Aviso: os links de cadastro da OKX neste artigo são links de parceria da Blave. Se você se cadastrar por eles, a Blave pode receber uma comissão.

Ainda não tem conta na OKX? Cadastre-se na OKX

Pontos principais
  • Uma chave de API da OKX tem três partes: API key, secret key e passphrase. A passphrase é você quem define e, se esquecer, só resta apagar a chave e criar outra.
  • O trading automático só precisa das permissões Read e Trade. Nunca ative Withdraw.
  • A OKX apaga automaticamente uma chave com permissão de negociação e sem IP vinculado após 14 dias sem atividade.
  • Uma ordem que volta com timeout 50004 ou 51149 não quer dizer que não foi executada. Confira a ordem primeiro e não reenvie direto.

O que é a API da 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.

Como criar uma chave de API da OKX?

Criar conta na OKX
Nunca ative a permissão de saque. O trading automático só precisa de leitura e negociação. Mesmo que a chave vaze, sem permissão de saque ninguém consegue mover suas moedas.
  1. Entre na OKX pelo navegador, vá em Profile → API and connections e clique em Create API key.
  2. Dê um nome à chave de API e escolha a conta e a finalidade.
  3. Configure a lista de IPs permitidos (veja a próxima seção).
  4. Marque as permissões Read e Trade. Não marque Withdraw.
  5. Defina uma passphrase e anote. A OKX não volta a mostrá-la depois de criar a chave.
  6. Conclua a verificação de segurança, anote a API key e a secret key e guarde num lugar seguro.

Entregue as três ao programa de trading automático. Faltando uma, ele não conecta.

Vale configurar a lista de IPs permitidos?

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.

Códigos de erro comuns da API da OKX

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ódigoSignificadoO que fazer
Primeiro grupo: problemas de chave e permissão, recusados logo ao conectar ou enviar a ordem
50111API key inválidaConfira se colou certo e sem espaços sobrando no início ou no fim
50113Assinatura inválidaGeralmente é a secret key colada errada. Cole de novo
50105Passphrase erradaUse a que você definiu ao criar a chave, não a senha de login
50110IP fora da lista de permitidosAdicione o novo IP da máquina que roda o programa à lista
50119A chave não existePode ter sido apagada (por exemplo, pela regra dos 14 dias). Crie outra
50100API congeladaFale com o suporte da OKX
Segundo grupo: a chave está certa, mas essa ordem não consegue sair
51010O modo de conta atual não permiteNo Spot mode não dá para operar futuros. Mude para um modo que aceite futuros na configuração de modo da conta
51008Margem insuficienteAdicione fundos ou diminua o valor da estratégia
51020Abaixo do tamanho mínimo de ordemAumente o valor da estratégia ou escolha uma moeda com unidade mínima menor
50102Timestamp da requisição expiradoO 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
50004Timeout na requisição de APINão reenvie. Confira a ordem primeiro
51149Timeout ao enviar a ordemNão reenvie. Confira a ordem primeiro
50001Serviço temporariamente indisponívelNão reenvie. Confira a ordem primeiro
50026Erro de sistemaNã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.

Conecte a OKX pelo Blave Agent e não precisa cuidar disso

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 desktop

Para 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.

Perguntas frequentes

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.

Os riscos, antes de tudo

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.