Como Gerenciar as Chaves API da Sua Exchange na Freya Finance

#Como Gerenciar as Chaves API da Sua Exchange na Freya Finance

Suas chaves API são o que permite à Freya executar trades na sua exchange por você. Depois de conectar uma exchange, todas as suas chaves ficam em um só lugar, onde você pode revisá-las, ver exatamente o que cada uma tem permissão para fazer, adicionar mais ou remover as que você não usa mais. Este guia trata de como gerenciá-las.

Se você está conectando uma exchange pela primeira vez, comece com Como Conectar Sua Exchange — este artigo é sobre gerenciar chaves que você já adicionou.

---

#Uma Visão Geral Rápida dos Passos

1. Abra sua lista de chaves — vá em Configurações → Chaves API para ver cada exchange conectada, cada uma com seu rótulo, a data em que foi adicionada e seu status.
2. Verifique as permissões de cada chave — confirme que ela mostra Leitura e Trade (e Futuros se você opera futuros), e nunca acesso de saque.
3. Adicione uma chave quando precisar — use Adicionar Chave API para conectar outra exchange ou uma chave adicional, seguindo o mesmo fluxo da sua primeira conexão.
4. Exclua as chaves que não usa mais — escolha Excluir e confirme. Se um bot ainda estiver usando a chave, a Freya recusa a exclusão e informa quantos são; pare ou pause esses bots primeiro.

#Onde Encontrar Suas Chaves API

Vá em Configurações → Chaves API. Você verá Suas Chaves API — uma lista de cada conexão de exchange na sua conta. Para cada uma, a Freya mostra:

• A exchange (Binance, OKX ou Bybit).
• Um rótulo para a chave, para que você consiga distinguir várias delas.
• A data em que foi adicionada.
• Seu status (Ativa).

Se você ainda não conectou nada, verá em vez disso o aviso Adicione Sua Primeira Chave API.

#Entendendo as Permissões da Chave

Cada chave exibe as permissões com que foi criada, para que nunca haja dúvida sobre o que ela pode fazer:

• Leitura — permite que a Freya veja seus saldos e posições (necessário para tudo).
• Trade — permite que a Freya coloque e gerencie ordens (é isso que seus bots usam para operar).
• Futuros — presente quando a chave também tem o acesso a trading de futuros habilitado.

Essa transparência importa: uma chave da Freya é apenas para leitura e trading. Ela não tem — e não deveria ter — permissão de saque, então seus fundos nunca podem sair da sua exchange através da Freya. Para o quadro completo, veja Meu Dinheiro Está Seguro na Freya Finance?.

#Adicionando Outra Chave

Você pode conectar mais de uma exchange (ou mais de uma chave) a partir da mesma tela usando Adicionar Chave API. A configuração segue o mesmo fluxo da sua primeira conexão — veja Como Conectar Sua Exchange para o passo a passo, incluindo a passphrase da OKX.

#Excluindo uma Chave

Para remover uma conexão, escolha Excluir na chave e confirme. Algumas coisas a saber:

• Não pode ser desfeito. Você teria que adicionar a chave novamente do zero para reconectar.
• A Freya verifica antes de excluir. Se algum bot estiver operando com essa chave, ou estiver armado aguardando para operar, a exclusão é recusada e você é informado de quantos bots estão envolvidos. Pare ou pause esses bots no painel e tente de novo — um bot que perde a chave no meio de uma operação já não consegue gerenciar a posição que abriu.
• Você é notificado quando uma chave é removida — um toque de segurança para que você sempre saiba quando o acesso muda.

#Suas Chaves São Armazenadas com Segurança

A Freya armazena suas credenciais API criptografadas — a tela de Chaves API até as identifica como armazenadas com segurança. Combinado com chaves que não têm permissão de saque, isso significa que, mesmo no pior cenário, ninguém pode mover fundos para fora da sua conta na exchange através da Freya.

#Perguntas Frequentes

#Onde gerencio as chaves API da minha exchange?

Em Configurações → Chaves API. Essa tela lista cada chave conectada com sua exchange, rótulo, a data em que foi adicionada e seu status — e é onde você adiciona novas chaves ou exclui as existentes.

#O que significam os rótulos Leitura, Trade e Futuros?

Eles mostram o que cada chave tem permissão para fazer. Leitura permite que a Freya veja seus saldos e posições; Trade permite que ela coloque e gerencie ordens (o que seus bots usam); e Futuros aparece quando a chave também tem acesso a trading de futuros. Uma chave da Freya nunca precisa de permissão de saque.

#Como adiciono outra exchange ou chave?

Use Adicionar Chave API na mesma tela. Ela executa o mesmo fluxo de conexão da sua primeira chave — veja o guia Como Conectar Sua Exchange para o passo a passo completo, incluindo a passphrase extra da OKX.

#O que acontece quando eu excluo uma chave API?

A Freya verifica primeiro se algo ainda depende dela. Se um bot estiver operando com essa chave, ou estiver armado aguardando um sinal, a exclusão é recusada e você verá quantos bots estão envolvidos — pare ou pause esses bots e depois exclua. Quando nada mais depender da chave, a conexão é removida e não pode ser desfeita. Você também receberá uma notificação confirmando a remoção.

#Minhas chaves API são armazenadas com segurança?

Sim. Suas credenciais são armazenadas criptografadas, e as chaves que você conecta têm acesso apenas de trading — nunca permissão de saque. Essa combinação significa que seus fundos não podem ser sacados da sua exchange através da Freya.

#A Freya pode sacar meus fundos usando minha chave API?

Não. As chaves são criadas apenas com acesso de leitura e trading — não de saque. Mesmo que algo desse errado, ninguém poderia mover seus fundos para fora da exchange usando uma chave da Freya.

#Como edito as permissões de uma chave API, faço a rotação ou a desativo?

Não existe uma edição no local para uma chave conectada. Para alterar permissões, rotacionar ou substituir uma chave, você exclui da Freya e adiciona a nova — crie a chave atualizada na sua corretora e reconecte. Pare ou pause primeiro os bots que usam a chave antiga, já que a Freya não remove uma chave em uso; depois de conectar a nova, aponte esses bots para ela e inicie novamente. Para parar de usar uma chave sem removê-la, pause os bots que dependem dela em vez de excluir a chave.