Como conectar sua chave de API da OKX e corrigir o erro 50119

Sua chave de API da OKX pode ser válida e ainda retornar “A chave de API não existe.” Se uma chave EEA chegar à API global em vez da infraestrutura da OKX Europe, recriar a chave não resolverá o problema. Vou mostrar como conectar sua chave de API da OKX, escolher a região correta da conta e diagnosticar o erro antes de alterar as credenciais.

A verificação crucial é a combinação entre credenciais e endpoint regional. Uma chave copiada corretamente e enviada ao host regional errado pode falhar antes que suas permissões se tornem relevantes.

Uma chave de API válida da OKX pode falhar no endpoint regional errado

Uma reação tentadora diante de uma falha de conexão é gerar outra chave, colá-la novamente e tentar mais permissões. Essa abordagem trata toda falha de autenticação como um problema de credenciais.

A estrutura regional da OKX torna essa suposição pouco confiável.

A OKX Europe Limited é uma entidade separada, regulada pelo MiCA e licenciada pela MFSA de Malta. As contas EEA ficam em my.okx.com, e suas chaves de API são válidas apenas na infraestrutura de API da OKX Europe.

Envie uma chave EEA perfeitamente válida para a API global www.okx.com, e a resposta pode ser 50119: “A chave de API não existe.” A chave existe, mas a requisição chegou ao endpoint regional errado.

As contas US têm seu próprio host regional, us.okx.com. Suas conexões também precisam da infraestrutura regional correspondente.

As contas brasileiras da OKX usam a plataforma global e a mesma API, portanto selecione Global. A presença em um mercado local não implica automaticamente uma região de API separada.

Começo o diagnóstico por aqui porque alterar uma frase secreta ou ampliar permissões não corrige uma incompatibilidade regional. A requisição precisa chegar à infraestrutura que reconhece a chave.

Como criar uma chave de API da OKX com as permissões necessárias

Uma conexão deve receber acesso suficiente para executar a tarefa pretendida. Conceder permissões adicionais para fazer um erro desaparecer é um método ruim de diagnóstico.

Para visualizar o portfólio, use Leitura. Adicione Negociação apenas quando pretender usar bots que enviam ordens.

Nunca habilite Saque para esta conexão.

Passo a passo para configurar uma chave de API da OKX

1. Abra o gerenciamento de API na sua conta OKX.

Entre na conta que deseja conectar e acesse a área de gerenciamento de API. Identifique se essa conta pertence a Global, EEA ou US antes de criar a chave.

1. Crie uma chave de API exclusiva para a conexão.

Dê a ela um nome reconhecível para identificar sua finalidade ao revisar os acessos depois. Uma chave exclusiva também facilita alterar ou revogar o acesso dessa conexão separadamente.

1. Defina a frase secreta da API durante a criação.

Essa é uma frase secreta que você escolhe para a chave de API. Ela não é a senha da sua conta OKX, e você precisará dela junto com a chave de API e a chave secreta ao conectar.

1. Habilite Leitura para visualizar o portfólio.

Se seu objetivo é consultar informações do portfólio, comece com acesso de Leitura. Uma conexão apenas para visualização não precisa de permissão de negociação.

1. Adicione Negociação apenas para bots que precisam enviar ordens.

A permissão de Negociação autoriza operações de trading. Habilite-a deliberadamente para essa finalidade, não como uma tentativa de resolver um erro de autenticação.

1. Mantenha Saque desabilitado.

A visualização do portfólio e o envio de ordens por bots não exigem permissão de saque. Não a conceda para concluir esta configuração. Lembre-se de que desabilitar saques não impede perdas em operações: uma chave com permissão de Negociação ainda pode enviar ordens que gerem prejuízo, portanto limite os recursos mantidos na conta à qual uma conexão de negociação tem acesso.

1. Vincule a chave aos endereços IP da conexão, quando disponíveis.

Use os endereços IP especificados pelo serviço que faz as requisições à API. Mantenha essa configuração alinhada à conexão que você realmente usa.

1. Armazene a chave de API, a chave secreta e a frase secreta com segurança.

Trate-as como credenciais. Ao inseri-las no formulário de conexão, verifique se cada valor está completo e pertence à mesma chave de API.

Criar a chave é apenas parte da configuração. A conexão que recebe as credenciais também precisa saber qual host regional usar.

Por que a lista de IPs permitidos importa

A vinculação a IPs restringe de onde uma chave pode ser usada. Ela também importa para o ciclo de vida da chave: a OKX pode excluir chaves de API inativas que não tenham vinculação a IPs, então uma chave que você criou e deixou sem uso pode não existir mais quando voltar a usá-la.

Não presuma que uma chave continua ativa só porque você ainda tem suas credenciais salvas. Verifique o status dela no gerenciamento de API da OKX.

Há outro problema de configuração a observar: uma chave ativa pode rejeitar uma requisição quando o IP de quem a envia não está na lista de IPs permitidos. Isso gera um erro específico de IP, que deve direcionar você às configurações de IP, em vez de voltar à criação da chave.

Por que a OKX diz “A chave de API não existe” quando a chave é válida

A frase parece definitiva. Seu significado para o diagnóstico é mais restrito do que aparenta.

Para uma conta EEA, o erro 50119 pode significar que o endpoint global não reconhece uma chave válida na infraestrutura da OKX Europe. Se um guia de conexão nunca pergunta a qual entidade sua conta pertence, ele não consegue identificar esse caso.

A divisão regional está documentada, não é uma teoria sobre credenciais

As perguntas frequentes sobre a API da OKX EEA documentam o contexto regional de my.okx.com e a validade das chaves exclusivamente na EEA. Relatos públicos de problemas no Freqtrade, no CCXT e no Hummingbot também corroboram o padrão de usuários EEA recebendo “A chave de API não existe” quando sua integração usa o host global.

Esses relatos sustentam a verificação do endpoint regional. Eles não demonstram que toda ocorrência tem a mesma causa.

Minha conclusão para o diagnóstico é direta: verifique a região da conta antes de substituir uma chave que a OKX ainda lista como ativa. Se um conector presume que todas as contas usam a API global, criar chaves repetidamente mantém essa suposição intacta.

Outras causas do erro 50119 também precisam ser verificadas

Uma incompatibilidade regional não é a única explicação. O mesmo erro também pode envolver:

• Uma chave de negociação em demonstração usada no ambiente errado. Confirme se as credenciais correspondem ao ambiente esperado pela conexão.
• Uma chave excluída automaticamente. Verifique se a chave ainda existe no gerenciamento de API da OKX.
• Um valor colado de forma incompleta. Confira se a chave de API foi inserida por inteiro.
• Uma chave realmente desconhecida. Confirme se as credenciais vieram da conta pretendida.

Eu verificaria essas possibilidades em sequência, em vez de mudar tudo ao mesmo tempo. Se você substituir as credenciais, as permissões, o ambiente e a região de uma só vez, uma nova tentativa bem-sucedida dirá muito pouco sobre o que estava errado.

A pergunta útil é: Este endpoint reconhece esta chave ativa para esta conta e este ambiente?

Decifre o código de erro da OKX antes de tentar novamente

Uma falha de conexão é um sintoma. O código de erro da OKX é a evidência mais útil.

A referência pública de códigos de erro da API da OKX distingue uma chave desconhecida de uma frase secreta incorreta, uma assinatura inválida e uma restrição de IP. Cada um aponta para uma parte diferente da conexão.

Código de erro	Significado	O que verificar
50119	A chave de API não existe	Região da conta e host regional; ambiente de demonstração versus ambiente pretendido; se a chave foi excluída; se a chave colada está completa
50105	Frase secreta da API incorreta	Use a frase secreta definida na criação desta chave de API, não a senha da conta
50113	Assinatura inválida	Verifique a chave secreta da API e a implementação de assinatura de requisições da integração
50110	O IP da requisição não está na lista de IPs permitidos	Verifique se o IP de quem envia a requisição está incluído na configuração de IPs permitidos da chave

Erro 50105: verifique a frase secreta da API

A frase secreta da API é uma credencial separada. Inserir sua senha de login da OKX nesse campo não atende a esse requisito.

Verifique também se a frase secreta pertence à mesma chave que a chave de API e a chave secreta. Misturar credenciais de diferentes tentativas de criação pode deixar você com valores que parecem plausíveis individualmente, mas não pertencem ao mesmo conjunto.

Erro 50113: investigue a assinatura de requisições

Uma assinatura inválida aponta para a assinatura de autenticação da requisição. Verifique a chave secreta da API e, se você mantém a integração, sua implementação de assinatura.

Se você usa um formulário de conexão, consulte o suporte ou a documentação técnica do conector para investigar a assinatura de requisições. Habilitar Negociação ou Saque não corrige uma assinatura inválida.

Erro 50110: inspecione a lista de IPs permitidos

Esse erro direciona você à configuração de IPs permitidos. Verifique o IP usado pelo serviço que faz a requisição e compare-o com a lista de IPs permitidos da chave.

Repetir a mesma requisição às cegas mantém a incompatibilidade. Corrija a configuração correspondente antes de testar novamente.

Como conectar a OKX à Anny

Meu formulário de conexão inclui um seletor de Região da conta com as opções Global, EEA e US. Essa seleção garante que a chave seja verificada no host regional apropriado.

Este é o processo de conexão:

1. Abra o formulário para adicionar uma exchange e escolha OKX.

Tenha em mãos sua chave de API, a chave secreta e a frase secreta da API.

1. Selecione a Região da conta.

Escolha EEA para uma conta da OKX Europe, US para uma conta da OKX US ou Global para uma conta na plataforma global. Contas brasileiras selecionam Global.

1. Insira as credenciais correspondentes.

Cole a chave de API e a chave secreta completas e, depois, insira a frase secreta que você definiu ao criar a chave.

1. Confirme se as permissões correspondem ao seu objetivo.

Use Leitura para visualizar o portfólio. Adicione Negociação apenas para bots e mantenha Saque desabilitado.

1. Verifique a conexão.

Se ela falhar, use o código de erro retornado para escolher a próxima verificação. Para 50119, confira novamente a região antes de criar outra chave.

Conecte a OKX à Anny

Selecionar uma região é um requisito de autenticação, não uma preferência de exibição. Isso determina onde as credenciais são verificadas.

Como usar a documentação da API da OKX para diagnosticar problemas

Se você está conectando por meio de um formulário existente, o seletor de região e a tabela de erros são os pontos de partida práticos. Se você mantém uma integração, leia as orientações regionais junto com a documentação de autenticação.

As partes relevantes da documentação da API da OKX respondem a perguntas diferentes:

• Orientações sobre a API regional: Qual infraestrutura deve receber as requisições desta conta?
• Orientações de autenticação: Quais credenciais são necessárias e como as requisições devem ser assinadas?
• Referência de códigos de erro: Qual parte da requisição enviada foi rejeitada?

Uma implementação correta de assinatura ainda pode enviar uma requisição ao host regional errado. Um host regional correto ainda pode rejeitar uma frase secreta incorreta.

Mantenho essas verificações separadas porque elas levam a correções diferentes. Uma conexão bem-sucedida exige que o endpoint, as credenciais, o ambiente, as permissões e a configuração de IP estejam alinhados.

Perguntas frequentes sobre conexões com a API da OKX

Uma chave de API da OKX expira?

Não presuma que uma chave de API permanece disponível indefinidamente. A OKX pode excluir chaves inativas que não tenham vinculação a IPs, portanto verifique o gerenciamento de API se credenciais salvas anteriormente pararem de funcionar.

Vincule a chave aos endereços IP especificados para a conexão, quando disponíveis, e verifique se a chave continua ativa antes de investigar sua frase secreta ou suas permissões.

Por que minha chave de API válida da OKX diz que não existe?

Uma chave válida pode retornar 50119 quando é enviada ao endpoint regional errado. Em particular, uma chave EEA deve ser usada na infraestrutura da OKX Europe; enviá-la à API global www.okx.com pode gerar “A chave de API não existe”.

Verifique também se há uma incompatibilidade com o ambiente de demonstração, uma chave excluída automaticamente ou um valor colado de forma incompleta.

De quais permissões um bot de trading da OKX precisa?

Use Leitura para visualizar o portfólio e adicione Negociação quando o bot precisar enviar ordens. Nunca habilite Saque para esta conexão.

Permissões extras não resolvem uma incompatibilidade regional, uma frase secreta incorreta, uma assinatura inválida ou um erro na lista de IPs permitidos.

A frase secreta da API da OKX é a mesma que minha senha?

Não. A frase secreta da API é definida quando você cria a chave de API e é separada da senha da sua conta OKX.

Insira a frase secreta associada àquela chave específica.

Qual região uma conta brasileira da OKX deve selecionar?

Selecione Global. A OKX Brazil opera na plataforma global e usa a mesma API.

Devo criar uma nova chave sempre que a conexão falhar?

Não. Leia primeiro o código de erro e verifique a configuração que ele identifica.

Para 50119, confirme o host regional, o ambiente, o status ativo da chave e se o valor colado está completo. Uma nova chave não corrigirá uma conexão que continua enviando-a ao endpoint regional errado.

A próxima ação útil é um diagnóstico, não outra tentativa idêntica. Comece pela região, leia o código e altere a configuração indicada pelas evidências.

Este artigo é educativo e não constitui aconselhamento financeiro. Performance passada ≠ resultados futuros. Anny é uma plataforma de análise baseada em IA, não uma consultora de investimentos registrada.