Conectar a exchange OKX
O Bybot opera na sua conta da OKX por meio de uma chave de API. Seus fundos ficam na exchange: a chave permite que o bot veja seu saldo e envie ordens spot. O Bybot rejeita qualquer chave da OKX com a permissão Withdraw, então não dá para sacar fundos pela chave. A configuração leva cerca de 5 minutos.
O que você precisa
- Uma conta na okx.com global. Chaves da OKX US (us.okx.com), OKX EEA (eea.okx.com), my.okx.com e do demo trading não funcionam
- Autenticação de dois fatores ativada na OKX — a exchange pede um código ao criar uma chave
- USDT na sua conta Trading account da OKX
1. Entre na OKX
Abra a okx.com e faça login. Ainda não tem conta? Crie uma e conclua a verificação que a OKX pedir.
2. Abra a página de API
Clique no ícone do perfil no canto superior direito e selecione “API” (em alguns idiomas o item se chama “API and connections”).
3. Clique em “Create API key”
Crie uma chave nova só para o bot, mesmo que você já use chaves da OKX em outros programas.
4. Configure a chave
| Campo | O que selecionar |
|---|---|
| API key name | Qualquer um, por exemplo bybot |
| Passphrase | Sua própria senha para esta chave. Guarde-a — você vai precisar dela no Bybot. Não comece nem termine com espaço |
| Permissions | ✅ Read, ✅ Trade |
| Withdraw | ❌ desativado |
| IP address | deixe vazio |
Clique em “Submit all”.
Não adicione endereços IP. O Bybot se conecta pelos próprios servidores, e uma chave vinculada a um IP não vai funcionar com eles.
5. Confirme a criação da chave
Digite os códigos de verificação que a OKX pedir (2FA e, se solicitado, e-mail ou SMS).
6. Copie a API key e a Secret key
A OKX mostra a API key e a Secret key. Copie as duas e guarde em um lugar seguro junto com a passphrase.
A Secret key aparece só uma vez. Se perder a chave secreta ou esquecer a passphrase, exclua a chave e crie uma nova.
7. Adicione as chaves no Bybot
No Bybot, abra Configurações (“Settings”) → Chaves de API (“API Keys”) e clique em Adicionar chave (“Add key”). Selecione OKX, cole a API key, a Secret key e a Passphrase e clique em Salvar (“Save”).

O Bybot verifica a chave na hora: ela precisa ter a permissão Trade e não ter a permissão Withdraw.
8. Confira seu saldo
O bot opera só com os fundos da sua conta Trading account. Ele não vê o dinheiro da conta Funding account — transfira-o para a Trading account na OKX.
Validade da chave
As chaves da OKX não têm data de expiração, e o cartão da chave no Bybot mostra Sem validade (“No expiry”). Mas a OKX exclui uma chave sem vínculo de IP depois de 14 dias sem uso. Enquanto um bot está rodando, a chave está em uso e continua ativa. Se você parar todos os bots por muito tempo e o bot não iniciar por causa da chave, crie uma chave nova com este guia e substitua a antiga em Configurações (“Settings”) → Chaves de API (“API Keys”).
O que saber sobre a OKX
- Taxa: no nível básico da OKX no momento da conexão, 0,08% para ordens maker e 0,10% para ordens taker. As taxas atuais dependem do seu nível — confira no site da OKX. Na compra, a OKX cobra a taxa na moeda comprada, então chega um pouco menos na sua conta. O Bybot leva isso em conta.
- Pares: pares spot com USDT.
- Lucro mínimo: a configuração de lucro mínimo do bot DCA na OKX é 0,29%, para que um ciclo cubra as taxas da compra e da venda. É um limite da configuração, não um lucro líquido garantido.
- Estratégias: DCA (LONG e SHORT) e Grid no spot. O backtest com dados da OKX ainda não está disponível.
Segurança da chave
- Saques estão bloqueados. O Bybot rejeita uma chave da OKX com a permissão Withdraw.
- O Bybot nunca vai pedir sua senha da OKX nem códigos 2FA.
- Nunca envie a Secret key nem a passphrase em chats, capturas de tela, tickets ou documentos compartilhados.
- Se a chave vazar ou você parar de usar o bot, exclua-a na página API da OKX. O acesso termina na hora.
Problemas comuns
“A OKX rejeitou a chave”. Confira se você copiou a API key, a Secret key e a passphrase inteiras, sem espaços extras. A chave precisa ser criada na okx.com global, não no demo trading nem na OKX US/EEA. Se a chave tem um endereço IP, crie uma chave nova sem IP.
“A chave não tem permissão de trading”. Ative Trade nas configurações da chave na OKX ou crie uma chave nova com Read e Trade.
“A chave tem a permissão Withdraw”. Crie uma chave nova da OKX sem Withdraw e adicione-a no Bybot.
O bot não vê o saldo. O dinheiro está na Funding account. Transfira-o para a Trading account.
O bot não iniciou depois de uma pausa longa. A OKX excluiu a chave depois de 14 dias sem uso. Crie uma chave nova e substitua a antiga no Bybot.
Página oficial da exchange: OKX API.