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. Se você também opera na Binance, veja o guia da Binance.
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 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.
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 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.
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). 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
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).
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. Para conectar outra exchange, leia o guia da OKX.