A KuCoin não tem um botão chamado "somente leitura". A chave somente leitura dela é a que tem a permissão General e mais nada. O SetupBook lê suas execuções com uma chave assim, então seus trades de futuros USDT-M e spot chegam ao diário sem você digitar nada. A KuCoin também pede uma passphrase ao criar a chave, e o SetupBook precisa dela. Leva cerca de cinco minutos.

Este guia mostra cada passo com imagens. Para saber como todas as plataformas se conectam, leia a visão geral de todas as conexões. Se você também usa a MEXC, veja o guia da MEXC.

Antes de começar

  • Uma conta no SetupBook com Pro. Conectar uma plataforma faz parte do Pro, e todo diário começa com 14 dias de Pro: comece 14 dias grátis.
  • Uma conta na KuCoin. A KuCoin pede uma verificação de segurança ao criar uma chave: a sua senha de trading, mais um código do seu e-mail e do seu aplicativo autenticador.
  • Um lugar para anotar a passphrase, como um gerenciador de senhas.
  • Cinco minutos.

A chave só lê. Você marca General e deixa desligados Spot, Futures, Margin, Earn e Withdrawal. O SetupBook nunca envia uma ordem e nunca movimenta dinheiro. Ele guarda a chave e a passphrase seladas no servidor e as usa para ler suas execuções.

1. Abra o API Management e crie uma chave

No site da KuCoin clique no seu avatar, escolha API Management e aperte Create API. A KuCoin pergunta para que serve a chave: escolha API Trading, a opção que cria uma chave sua. Depois digite um API name (chame de SetupBook) e uma API passphrase.

Desenho do formulário Create API da KuCoin: só General marcada, Spot, Futures e Withdrawal desligadas
Create API: um nome, uma passphrase sua, General marcado, todo o resto desligado.

2. Marque General e mais nada

Na etapa de permissões marque General. A KuCoin descreve essa permissão como limitada a ações somente de leitura: informações da conta, extratos e informações de ordens. Deixe Spot, Futures, Margin, Earn e Withdrawal desligados, e deixe desligada qualquer outra caixa também. Os textos do formulário podem mudar um pouco de região para região (o site da UE chama essa etapa de API Restrictions), então procure a caixa General.

Restrição de IP: a ajuda da KuCoin diz que uma chave que opera precisa estar presa a um endereço IP. A sua não opera, então deixe a restrição desligada. Se o formulário insistir em um mesmo assim, peça pelo formulário de feedback embaixo das conexões: ainda não podemos dar a você um endereço fixo para liberar. Com uma chave somente leitura nada pode ser operado nem sacado, de um jeito ou de outro.

3. Copie a chave, o secret e a passphrase

Confirme a verificação de segurança. A KuCoin mostra a API key e o secret. Copie as duas para um lugar seguro, junto com a sua passphrase. A KuCoin não consegue recuperar nenhuma das três depois de perdidas, então, se você perder uma, crie uma chave nova.

4. Cole os três no SetupBook

No SetupBook abra Contas → Conexões e aperte Adicionar conexão. Escolha KuCoin. Cole a chave em Chave de API, o secret em API secret e a passphrase em Passphrase.

Em Mercados marque o que você opera: Perpétuos USDT (futuros USDT-M) e Spot. Para spot, a KuCoin não tem uma chamada "o que eu operei", então escreva os pares que você opera em Pares spot, separados por vírgula, por exemplo BTC-USDT, ETH-USDT. Pares das moedas que você tem são adicionados sozinhos. Futuros não precisam de lista.

Deixe Para a conta em Criar a partir da conta da plataforma, ou escolha uma das suas, e aperte Verificar a chave e conectar.

SetupBook: diálogo de conexão da KuCoin com chave de API, secret, passphrase, mercados e pares spot
Contas → Conexões → Adicionar conexão → KuCoin. Chave, secret, passphrase, mercados e pares spot.

A KuCoin não informa as permissões de uma chave à própria chave, então o SetupBook não consegue avisar se você marcou uma caixa de trading por engano. Olhe uma vez as permissões da chave na KuCoin para ter certeza.

5. Acompanhe a primeira sincronização

A primeira sincronização começa na hora. Os futuros voltam cerca de três meses; o spot é lido par por par até onde a KuCoin entrega. Quando termina, a conexão mostra Ativa, o horário da última sincronização e o número de trades. Depois disso o SetupBook procura execuções novas a cada hora, e você pode apertar Sincronizar agora a qualquer momento.

SetupBook: cartão de conexão da KuCoin com o status Ativa, a última sincronização e o total de trades
Status Ativa, última sincronização e número de trades depois da primeira sincronização.

O que você recebe:

  • Posições, não execuções soltas. As execuções são agrupadas em posições do mesmo jeito que na importação de arquivo, então uma posição fechada em três partes é um trade com três saídas.
  • Tamanho do contrato. Um contrato de futuros vale uma quantidade fixa da moeda (o contrato de BTC XBTUSDTM é 0,001 BTC), e o SetupBook usa isso, então o tamanho e o resultado batem com a KuCoin.
  • Campos travados. Símbolo, lado, horários, preços, tamanho, taxas e o resultado líquido vêm da KuCoin e ficam exatos (eles alimentam o seu resultado líquido). Plano, qualidade do setup, erros, notas e capturas de tela continuam seus.
  • Fuso horário. Os horários da KuCoin são UTC, então não há nada para configurar.
  • Não incluído. Contratos margeados em moeda (inversos) e pagamentos de funding não são lidos.

Demo ou real

O SetupBook conecta só contas reais da KuCoin. A KuCoin não tem um demo trading que o SetupBook consiga ler.

Substituindo uma chave

Abra o menu da conexão, escolha Editar e aperte Substituir a chave. Cole a chave, o secret e a passphrase novos e salve: o SetupBook os confere, esquece os antigos e usa os novos a partir da próxima sincronização. Os trades continuam.

Problemas

O que você vê Por quê O que fazer
Chaves da OKX, da Bitget e da KuCoin precisam da passphrase. O campo da passphrase está vazio Cole a passphrase que você digitou ao criar a chave
A exchange rejeitou a chave. Uma passphrase errada, um secret digitado errado, ou uma chave apagada Confira os três valores, ou crie uma chave nova
Você esqueceu a passphrase A KuCoin não consegue recuperá-la Crie uma chave nova e use Substituir a chave
Faltam trades spot O par não está na sua lista Edite a conexão e adicione o par em Pares spot
Faltam trades de futuros Perpétuos USDT não está marcado, ou o contrato é margeado em moeda Marque o mercado; contratos margeados em moeda são ignorados
Nada chega e o status é Erro A chave foi apagada na KuCoin Crie uma chave nova e substitua

Problemas para conectar? Escreva para nós pela página de conexões, contando o que você tentou. Respondemos por e-mail em 30 minutos, todos os dias.

Perguntas frequentes

É seguro? O SetupBook consegue operar ou sacar?

Não. Uma chave só com General não consegue enviar uma ordem nem sacar, e o SetupBook não tem código que tente isso. A chave e a passphrase são guardadas seladas no servidor e nunca são enviadas ao seu navegador. Para parar, apague a chave na KuCoin e a conexão para.

Por que o SetupBook precisa da passphrase?

A KuCoin assina cada requisição com a passphrase, além da chave e do secret. Sem ela a KuCoin rejeita a requisição. Você escolheu a passphrase ao criar a chave.

Preciso restringir o endereço IP?

Não. Deixe desligada. Ainda não podemos dar a você um endereço fixo para liberar; se quiser um, peça pelo formulário de feedback. Uma chave somente leitura não consegue operar nem sacar, com ou sem regra de IP.

Por que preciso listar meus pares spot?

A KuCoin não tem uma chamada que devolva os pares spot que você operou. Você lista os pares, e o SetupBook acrescenta os pares das moedas que você tem. Futuros não precisam de lista.

Custa alguma coisa?

Conectar faz parte do Pro. Todo diário começa com 14 dias de Pro, e nada é cobrado nesses 14 dias. Se você cancelar antes, fica no plano grátis, que mantém o registro manual.

Prefere um arquivo? A importação continua funcionando: veja o guia do usuário. Para conectar outra exchange, leia o guia da Hyperliquid.