Como conectar a OKX à ZeroLoss: configuração da chave de API
A ZeroLoss opera swaps perpétuos com margem em USDT da OKX na sua própria conta OKX. A conexão é feita por uma chave de API que você cria na OKX, e não pela sua senha, e a chave só precisa de permissão para ler sua conta e operar futuros. Seu dinheiro fica na OKX o tempo todo. Este guia mostra como criar essa chave, restringi-la e conectá-la à ZeroLoss. Leva cerca de cinco minutos.
Quer ver o bot operando antes de conectar qualquer coisa? O teste simulado de 7 dias grátis não exige nenhuma corretora.
Antes de começar
- Uma conta OKX com autenticação de dois fatores ativada. Se você estiver no EEE, use eea.okx.com, e nos EUA, us.okx.com: chaves de um site não funcionam em outro. Em algumas regiões, a OKX exige pelo menos 100 USD em ativos antes de permitir que você crie uma chave.
- Um modo de conta que permita futuros. Em Trade settings → Account mode, escolha qualquer modo diferente de Spot mode; o Spot mode bloqueia a negociação de contratos. Isso só pode ser alterado no site ou no app.
- Pelo menos 100 USDT na sua conta Trading. Use Assets → Transfer, da conta Funding para a conta Trading.
- Uma conta ZeroLoss. Você pode começar pelo teste simulado grátis e conectar depois.
Passo 1: Crie a chave de API na OKX
- No site da OKX, abra Profile → API and connections (no app: Menu → API) e depois Create API key.
- Dê um nome à chave, escolha sua conta principal (ou a subconta que tem os USDT) e a finalidade de trading próprio via API.
- Adicione a allowlist de IPs (Passo 3) e as permissões (Passo 2).
- Defina uma passphrase. Use uma forte, com letras maiúsculas e minúsculas, um número e um símbolo, e anote-a: a OKX não consegue exibi-la nem recuperá-la, e a ZeroLoss precisa dela.
- Confirme e depois copie a API key e a Secret key.
Passo 2: Escolha as permissões
- Read: ativado.
- Trade: ativado. É o que permite criar e cancelar ordens.
- Withdraw: desativado.
- Transfer, Loan e Earn: desativados. A ZeroLoss nunca precisa deles.
Passo 3: Restrinja a chave aos endereços IP da ZeroLoss
Restringir uma chave a alguns endereços IP faz com que ela só funcione a partir desses servidores, mesmo que alguém a copie. No app da ZeroLoss, abra Conectar corretora; o passo Adicione nossos IPs lista os endereços dos servidores da ZeroLoss com um botão Copiar tudo. Cole-os no campo de restrição de IP da OKX.
A OKX aceita até 20 endereços por chave, separados por vírgulas ou espaços. Uma chave de trading sem lista de IPs permitidos é excluída automaticamente após 14 dias sem uso; chaves com lista de IPs permitidos não expiram.
Passo 4: Conecte a chave na ZeroLoss
- Entre na ZeroLoss e abra Conectar corretora.
- Em 1 · Pick your exchange (escolha sua corretora), selecione OKX.
- Em 2 · Paste your API key (cole sua API key), cole a API key, a secret key e a passphrase. A passphrase é aquela que você digitou ao criar a chave na OKX; a OKX não consegue mostrá-la de novo.
- Clique em Verify & connect (verificar e conectar). A ZeroLoss verifica a chave e lê seu saldo de futuros. A conexão exige pelo menos 100 USDT na sua conta Trading da OKX.
Confira se a chave está segura
Abra a página de gerenciamento de API na OKX e confira a chave que você criou. Ela deve permitir leitura e trading de futuros, com saques desativados. Para parar a ZeroLoss a qualquer momento, exclua a chave na OKX; as operações por meio dela param na hora, sem nenhuma ação da nossa parte. Nosso guia sobre API keys só para trading explica por que essa é a configuração que importa.
Problemas comuns
- Ordens recusadas mesmo com a chave correta: a conta está no modo Spot. Altere o modo da conta nas configurações de trading da OKX.
- Key, secret e passphrase parecem certas, mas falham: todas precisam vir da mesma conta (principal ou subconta) e do site regional certo (okx.com, eea.okx.com ou us.okx.com).
- Passphrase perdida: a OKX não consegue mostrá-la. Exclua a chave e crie uma nova.
- “Invalid API Key or Secret”: algum caractere ficou de fora na cópia. Copie as duas de novo; se a secret não foi salva, exclua a chave e crie uma nova.
- “API key missing required permissions”: trading de futuros ou leitura não está marcado na chave. Edite a chave ou crie uma nova com as duas permissões.
- “API IP restriction issue”: a chave está restrita, mas não a todos os endereços da ZeroLoss. Use Copiar tudo no app e cole a lista completa de novo.
- “Minimum 100 USDT required in Futures wallet” (mínimo de 100 USDT na carteira de futuros): seus USDT estão na conta Funding. Transfira-os para a conta Trading na OKX e tente novamente.
O trading de futuros cripto envolve alto risco de perda, e a automação não elimina esse risco. As telas das corretoras mudam de vez em quando; se um menu estiver diferente, procure pelos nomes das permissões acima. Esta página traz informações gerais, não aconselhamento financeiro. Veja nosso Aviso de Risco e Responsabilidade.