# Conectar a Bybit ao SetupBook com uma chave de API somente leitura e sincronizar seus trades

> Crie uma chave de API da Bybit somente leitura, cole no SetupBook e dois anos de trades de perpétuos USDT e spot caem no seu diário. Passo a passo com imagens.

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

A Bybit guarda um histórico longo de trades: a API dela volta cerca de dois anos. Isso faz da Bybit a conexão com mais histórico logo no primeiro dia. Você cria uma chave somente leitura uma vez, cola no SetupBook, e seus trades de perpétuos USDT e spot chegam sozinhos. 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 opera na Binance, veja [o guia da Binance](https://setupbook.io/pt/blog/conectar-binance-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 Bybit. Crie a chave no site da Bybit; a central de ajuda da Bybit diz que não dá para criar chaves no aplicativo.
- Cinco minutos.

A chave só lê. Você escolhe **Read-Only** e deixa desligadas todas as permissões de trade, de ordens e de transferência. O SetupBook nunca envia uma ordem e nunca movimenta dinheiro. Ele guarda a chave selada no servidor e a usa para ler suas execuções.

## 1. Abra o API Management e crie uma chave

No site da Bybit clique no ícone da sua conta no canto superior direito, escolha **API**, abra **API Management** e aperte **Create New Key**. Escolha **System-generated API Keys**: a Bybit gera a chave e o secret para você, e essas são as duas coisas que o SetupBook pede. Dê à chave um nome que você reconheça, por exemplo SetupBook.

![Desenho do API Management da Bybit: Read-Only selecionado, permissões de trade, ordem e transferência desligadas](https://setupbook.io/blog/connect/bybit-api-key-read-only-permissions.svg)

*API Management: crie uma chave System-generated, escolha Read-Only, deixe as permissões de trade desligadas.*

## 2. Escolha Read-Only

Em permissões, escolha **Read-Only**. Não marque nenhuma permissão que opere, envie ordens ou movimente fundos. Uma chave somente leitura é tudo o que um diário precisa.

**Restrição de IP:** 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 embaixo das conexões. Com uma chave somente leitura nada pode ser operado nem sacado, de um jeito ou de outro. Uma coisa para saber: a Bybit desativa uma chave sem restrição de IP após 90 dias. Quando isso acontecer, crie uma chave nova e use **Substituir a chave** (veja abaixo).

## 3. Copie a chave de API e o secret

Confirme a verificação de segurança. A Bybit mostra a **API key** e o **secret**. Copie as duas para um lugar seguro, como um gerenciador de senhas, na hora. As exchanges geralmente mostram o secret uma única vez, então, se você perder, crie uma chave nova.

## 4. Cole no SetupBook

No SetupBook abra **Contas → Conexões** e aperte **Adicionar conexão**. Escolha **Bybit**, deixe **Ambiente** em *Real*, cole a chave em **Chave de API** e o secret em **API secret**.

Em **Mercados** marque o que você opera: **Perpétuos USDT** e **Spot**. A Bybit não precisa de lista de pares: o SetupBook encontra os símbolos pelas suas execuções. Deixe **Para a conta** em *Criar a partir da conta da plataforma*, ou escolha uma das suas contas, e aperte **Verificar a chave e conectar**.

![O diálogo de conexão da Bybit no SetupBook com os campos de chave de API e secret e os mercados destacados](https://setupbook.io/blog/connect/setupbook-bybit-connection-dialog.pt.svg)

*Contas → Conexões → Adicionar conexão → Bybit. Chave, secret e mercados.*

O SetupBook confere a chave com a Bybit primeiro. Se a chave puder fazer mais do que ler, ele avisa; apague essa chave na Bybit e crie uma somente leitura.

## 5. Acompanhe a primeira sincronização

A primeira sincronização começa na hora e puxa tudo o que a Bybit ainda entrega, cerca de dois anos. 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 Bybit com o status Ativa, a última sincronização e o total de trades](https://setupbook.io/blog/connect/setupbook-bybit-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.
- **Campos travados.** Símbolo, lado, horários, preços, tamanho, taxas e o resultado líquido vêm da Bybit 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 Bybit 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 Trading

O Bybit Demo Trading é uma conta própria, com ID de usuário próprio. Na Bybit mude para o Demo Trading, passe o mouse sobre o seu avatar, abra **API** lá e crie uma chave. No SetupBook escolha **Demo** em Ambiente e cole essa chave. Os trades caem em uma conta Demo. Não use o site de testnet separado da Bybit: é outra coisa. A Bybit guarda as ordens demo por apenas 7 dias, então conecte cedo se quiser mantê-las.

## Substituindo uma chave

Abra o menu da conexão, escolha **Editar** e aperte **Substituir a chave**. Cole a chave e o secret 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 |
| --- | --- | --- |
| *A exchange rejeitou a chave.* | A chave ou o secret foi digitado errado, ou a chave foi apagada | Copie de novo na Bybit, ou crie uma chave nova |
| Uma chave demo não funciona | **Real** está selecionado | Escolha **Demo** em Ambiente, ou o contrário para uma chave real |
| *Esta chave pode operar.* (um aviso) | Uma permissão de trade, ordem ou transferência está ligada | Crie uma chave Read-Only nova e use **Substituir a chave** |
| O status virou *Erro* depois de alguns meses | Uma chave sem restrição de IP acaba após 90 dias | Crie uma chave nova e substitua |
| Faltam trades spot | **Spot** não está marcado | Edite a conexão e marque o mercado |
| Faltam trades de perpétuos | O contrato é margeado em moeda | Contratos margeados em moeda ainda não são suportados |

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 **Read-Only** não consegue enviar uma ordem nem sacar, e o SetupBook não tem código que tente isso. A chave é guardada selada no servidor e nunca é enviada ao seu navegador. Se quiser parar, apague a chave na Bybit e a conexão simplesmente para.

### Preciso restringir o endereço IP?

Não. Deixe a restrição de IP 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.

### Até onde vão os meus trades?

Cerca de dois anos na primeira sincronização. Se o seu histórico for mais antigo, ele precisa entrar como arquivo: se você consegue exportá-lo da Bybit como CSV, a opção *Outro CSV (mapear colunas)* da importação mapeia as colunas (veja [o guia de importação](https://setupbook.io/pt/blog/importar-historico-metatrader-binance-tradingview)).

### Quais mercados da Bybit são lidos?

Perpétuos USDT e spot. Contratos margeados em moeda e pagamentos de funding ainda não são lidos.

### 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 OKX](https://setupbook.io/pt/blog/conectar-okx-diario-de-trades).