Conectar a exchange KuCoin

O Bybot opera na sua conta da KuCoin 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 KuCoin com a permissão Transfer ou Withdrawal, 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 kucoin.com global no modo Classic. A Unified Trading Account (UTA) e a KuCoin EU, AU, TH e TR não funcionam
  • Autenticação de dois fatores ativada na KuCoin — a exchange pede códigos ao criar uma chave
  • USDT na sua conta Trading account da KuCoin

1. Entre na KuCoin

Abra a kucoin.com e faça login. Ainda não tem conta? Crie uma e conclua a verificação que a KuCoin pedir.

2. Abra API Management

Clique no ícone do perfil no canto superior direito e selecione “API Management”.

3. Clique em “Create API”

Escolha uma chave de API comum para trading (API-Based Trading), não um vínculo com um app de terceiros. Crie uma chave nova só para o bot.

4. Configure a chave

CampoO que selecionar
API NameQualquer um, por exemplo bybot
API PassphraseSua própria senha para esta chave. Guarde-a — você vai precisar dela no Bybot
General✅ ativado
Spot Trading✅ ativado
Unified Accountpode ficar ativado — é uma permissão, não o modo Unified Trading Account
Transfer❌ desativado
Withdrawal❌ desativado
IP restrictionnenhuma
💡

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 a senha de trading e os códigos de verificação que a KuCoin pedir.

6. Copie a API Key e o Secret

A KuCoin mostra a API Key e o Secret. Copie os dois e guarde em um lugar seguro junto com a passphrase.

⚠️

O Secret aparece só uma vez. Se perder o Secret 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 KuCoin, cole a API key, a Secret key e a Passphrase e clique em Salvar (“Save”).

Aba de chaves de API nas configurações do Bybot com o botão Add key

O Bybot verifica a chave na hora: ela precisa ter Spot Trading, não ter Transfer nem Withdrawal, e a conta precisa estar no modo Classic.

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 (Main) — transfira-o para a Trading account na KuCoin.

Validade da chave

As chaves da KuCoin não têm data de expiração, e o cartão da chave no Bybot mostra Sem validade (“No expiry”). Mas a KuCoin exclui uma chave sem vínculo de IP depois de 30 dias de inatividade. 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 KuCoin

  • Taxa: no nível básico da KuCoin no momento da conexão, 0,1% por ordem; alguns pares têm taxa maior. As taxas atuais dependem do seu nível — confira no site da KuCoin.
  • Pares: pares spot com USDT.
  • Lucro mínimo: a configuração de lucro mínimo do bot DCA na KuCoin começa em 0,29% e é maior para pares com taxa maior, 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 KuCoin ainda não está disponível.

Segurança da chave

  • Saques estão bloqueados. O Bybot rejeita uma chave da KuCoin com a permissão Transfer ou Withdrawal.
  • O Bybot nunca vai pedir sua senha da KuCoin, sua senha de trading nem códigos 2FA.
  • Nunca envie o Secret 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 Management da KuCoin. O acesso termina na hora.

Problemas comuns

“A KuCoin rejeitou a chave”. Confira se você copiou a API key, o Secret e a passphrase inteiros, sem espaços extras. A chave precisa ser criada na kucoin.com global em uma conta Classic. Se a chave tem um endereço IP, crie uma chave nova sem IP.

“A chave não tem permissão de trading spot”. Ative Spot Trading nas configurações da chave na KuCoin ou crie uma chave nova.

“A chave tem a permissão Transfer ou Withdrawal”. Crie uma chave nova da KuCoin sem Transfer e Withdrawal e adicione-a no Bybot.

“Chaves de uma Unified Trading Account não são suportadas”. Mude sua conta da KuCoin para o modo Classic ou use uma chave de uma conta Classic.

O bot não vê o saldo. O dinheiro está na conta Funding (Main). Transfira-o para a Trading account.

O bot não iniciou depois de uma pausa longa. A KuCoin excluiu a chave depois de 30 dias de inatividade. Crie uma chave nova e substitua a antiga no Bybot.

Página oficial da exchange: KuCoin API Management.