A Bybit é a única exchange onde a Freya pode configurar a conexão por você. A Freya é um broker registrado da Bybit, o que significa que a Bybit cria a chave API do lado dela, anexa as permissões corretas e a entrega diretamente à Freya — você nunca vê uma chave, nunca copia um segredo e nunca coloca um endereço IP na whitelist.
Essa rota se chama Conexão rápida. A rota mais antiga, em que você mesmo cria a chave na Bybit, ainda existe e ainda funciona. Este guia cobre as duas, além do que fazer quando você precisa substituir uma chave ou quando uma conexão falha.
Pontos-chave
- A Conexão rápida é um clique: você aprova a Freya na Bybit, e suas chaves de Spot e Futuros são adicionadas automaticamente.
- A Conexão rápida não precisa de whitelist de IP — a própria Bybit vincula a chave aos servidores da Freya, e é também por isso que ela não expira.
- A Conexão manual continua funcionando e é a única rota na Binance e na OKX.
- Seja qual for a rota, a chave nunca recebe permissão de saque. A Freya não pode mover seus fundos.
- Conectar uma segunda vez não cria duplicatas — a Bybit emite uma chave por plataforma por conta, então ela atualiza o que você já tem.
Antes de Começar
Vale a pena verificar duas coisas primeiro.
Coloque fundos na conta que você vai conectar. Um bot não pode abrir uma posição com saldo vazio, e a Freya conectará de bom grado uma chave que não tem nada com que operar. Se você planeja executar bots de futuros, certifique-se de que os fundos estão na conta que seus bots vão usar.
Use um navegador. As duas rotas funcionam em navegadores de desktop e mobile. Criar uma chave API manualmente é uma tarefa exclusiva de navegador do lado da Bybit — o app mobile deles não expõe a tela de chaves API.
Conexão rápida
Esta é a rota que recomendamos. Ela leva cerca de quinze segundos se você já estiver conectado à Bybit.
- Na Freya, abra Configurações → Chaves API e selecione Adicionar Chave API.
- Escolha a Bybit como exchange. A aba Conexão rápida já vem selecionada.
- Selecione Conectar com a Bybit. Uma aba da Bybit se abre.
- Entre na Bybit. Se você ainda não tem uma conta, pode criar uma ali mesmo e voltar — a conexão espera por você.
- Revise e aprove. A Bybit mostra exatamente o que a Freya está pedindo. Aprovar é o único passo que concede alguma coisa.
- A aba se fecha sozinha e suas chaves aparecem na Freya, prontas para uso.
Uma única aprovação cobre tanto Spot quanto Futuros. Você não repete isso por mercado.
O Que Acontece nos Bastidores
Quando você aprova, a Bybit cria uma chave API vinculada ao registro de broker da Freya e a envia direto aos servidores da Freya. Como ela chega dessa forma, nunca passa pelo seu navegador, pela sua área de transferência ou por uma captura de tela — que é como as chaves API mais frequentemente vazam.
A Bybit também vincula essa chave aos servidores da Freya por conta própria. Duas consequências das quais você se beneficia:
- Sem whitelist de IP. Não há nada para você copiar ou colar nas configurações da Bybit.
- A chave não expira. Uma chave que você cria manualmente pode expirar; uma chave vinculada via broker, não.
Se Você Mudar de Ideia
Recusar na tela da Bybit é completamente seguro. Nada é criado na Bybit e nada muda na Freya — você simplesmente verá que a autorização não foi concluída, e pode tentar de novo quando quiser.
Fechar a aba da Bybit sem decidir tem o mesmo efeito.
Substituindo uma Chave da Bybit
Às vezes você precisa de uma chave nova — você revogou a antiga na Bybit, está mudando para outra conta Bybit, ou o suporte pediu que você reconectasse.
Com a Conexão rápida, basta conectar de novo. Abra Configurações → Chaves API → Adicionar Chave API, escolha a Bybit e selecione Conectar com a Bybit como antes. A Bybit emite uma chave por plataforma por conta, então reconectar atualiza o que você já tem em vez de empilhar uma segunda cópia. Seus bots existentes continuam rodando na credencial atualizada.
Isso vale para a mesma conta Bybit. A Freya não conecta outra conta Bybit por cima de uma conexão existente: para trocar de conta, pare os bots que a usam, exclua as chaves Bybit Spot e Bybit Futures na Freya e depois conecte-se com a nova conta e escolha a nova chave para seus bots.
Se você excluiu a chave primeiro do lado da Bybit, reconectar também é a solução — a Bybit emitirá uma nova na aprovação.
⚠️ Não exclua sua chave na Freya enquanto houver bots em execução, a menos que pretenda pará-los. Um bot em execução sem uma credencial funcional não consegue gerenciar a posição que já abriu. Pare ou feche seus bots primeiro, depois reconecte.
Conexão manual
Use esta rota se você preferir criar a chave por conta própria, ou se estiver conectando uma subconta da Bybit.
Crie a Chave na Bybit
- Entre na Bybit em um navegador e abra a seção de API da sua conta.
- Crie uma chave API gerada pelo sistema (System-generated).
- Escolha API Transaction como o tipo de uso — não somente leitura.
- Conceda as permissões de Contract Trade e Spot Trade, além do acesso de leitura.
- Nunca conceda a permissão de saque (Withdrawal). A Freya não precisa dela e não pode usá-la.
- Restrinja a chave por IP e insira o endereço da Freya, que o modal mostra e permite copiar.
⚠️ A Bybit mostra sua chave secreta exatamente uma vez. Copie-a antes de fechar aquela tela. Se você a perder, a chave não pode ser recuperada — você terá que criar uma nova.
Adicione a Chave à Freya
- Na Freya, abra Configurações → Chaves API → Adicionar Chave API e escolha a Bybit.
- Mude para a aba Conexão manual.
- Cole a chave API e a chave secreta, e dê à chave um nome que você reconhecerá depois.
- Selecione Adicionar Chave API. A Freya valida a conexão e as permissões imediatamente.
Se a validação falhar, a Freya diz exatamente qual parte falhou, em vez de um erro genérico. Veja Não Consegue Conectar Sua Exchange? Corrigindo Erros de Conexão da Chave API para cada mensagem e sua correção.
Perguntas Frequentes
Qual rota devo usar?
A Conexão rápida, a menos que você tenha um motivo específico para não usá-la. São menos passos, ela não pode dar errado por um erro de digitação, e elimina a whitelist de IP por completo. A Conexão manual existe para quem quer criar e controlar a chave por conta própria, e para subcontas.
A Conexão rápida dá à Freya mais acesso do que uma chave manual?
Não. As duas rotas produzem uma chave de trading com o mesmo escopo: leitura e trading, nunca saque. A diferença está em quem faz a configuração, não no que a chave pode fazer.
Preciso colocar um endereço IP na whitelist?
Apenas com a Conexão manual. Na Conexão rápida, a Bybit vincula a chave aos servidores da Freya automaticamente, e é também por isso que essa chave não expira.
Posso conectar Spot e Futuros da Bybit separadamente?
Com a Conexão rápida você não precisa — uma única aprovação configura os dois. Com a Conexão manual, você pode adicionar chaves separadas se preferir manter os mercados apartados.
O que acontece se eu conectar duas vezes?
Nada quebra e nada duplica. A Bybit emite uma chave por plataforma por conta, então uma segunda conexão atualiza a existente.
Posso usar a Conexão rápida com uma subconta da Bybit?
Use a Conexão manual para subcontas. A Conexão rápida é destinada à sua conta principal da Bybit.
Minha chave está segura depois que entra na Freya?
Ela é criptografada no momento em que chega e nunca mais é exibida — nem para você, nem para o suporte. Excluí-la na Freya remove a credencial armazenada, e revogá-la na Bybit corta o acesso do outro lado. Para o panorama completo, veja Meu Dinheiro Está Seguro na Freya Finance?.
A Freya diz que minha chave é inválida logo após conectar. Por quê?
Na maioria das vezes, a chave foi criada sem permissão de trading, ou foi restrita a um IP que não é o da Freya. Com a Conexão rápida nenhum dos dois pode acontecer, então reconectar por essa rota costuma ser a solução mais rápida.