# Conectar a KuCoin ao SetupBook com uma chave de API de permissão General e sincronizar seus trades

> Crie uma chave de API da KuCoin só com a permissão General, adicione a passphrase no SetupBook e seus trades de futuros USDT-M e spot caem no diário.

- Source: https://setupbook.io/pt/blog/conectar-kucoin-diario-de-trades
- Site: SetupBook
- Language: pt
- Published: 2026-10-30
- Tags: sincronização, kucoin, ferramentas
- en: https://setupbook.io/blog/connect-kucoin-trading-journal
- tr: https://setupbook.io/tr/blog/kucoin-islem-gunlugu-baglama
- es: https://setupbook.io/es/blog/conectar-kucoin-diario-de-trading
- id: https://setupbook.io/id/blog/menghubungkan-kucoin-jurnal-trading
- vi: https://setupbook.io/vi/blog/ket-noi-kucoin-nhat-ky-giao-dich
- de: https://setupbook.io/de/blog/kucoin-mit-trading-tagebuch-verbinden
- fr: https://setupbook.io/fr/blog/connecter-kucoin-journal-de-trading
- ar: https://setupbook.io/ar/blog/connect-kucoin-trading-journal

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](https://setupbook.io/pt/blog/conectar-metatrader-ctrader-bybit-binance-okx-diario-de-trades). Se você também usa a MEXC, veja [o guia da MEXC](https://setupbook.io/pt/blog/conectar-mexc-diario-de-trades).

## 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](https://setupbook.io/pt/signup).
- 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](https://setupbook.io/blog/connect/kucoin-api-key-general-permission.svg)

*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](https://setupbook.io/blog/connect/setupbook-kucoin-connection-dialog.pt.svg)

*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](https://setupbook.io/blog/connect/setupbook-kucoin-connection-active-status.pt.svg)

*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](https://setupbook.io/pt/glossary/resultado-liquido)). 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](https://setupbook.io/pt/guide). Para conectar outra exchange, leia [o guia da Hyperliquid](https://setupbook.io/pt/blog/conectar-hyperliquid-diario-de-trades).