Conecte a API da sua exchange

Crie uma API key somente leitura na sua exchange e cole no Blave para ver saldos e posições de todas as exchanges em uma página. O Blave não consegue operar nem sacar com ela.

Conectar a API de uma exchange é entregar ao Blave uma API key somente leitura criada na sua exchange, para que o Studio leia seus saldos e posições. Seis exchanges são compatíveis: Binance, OKX, BingX, Bitget, Bitunix e Bybit. A key só precisa de permissão de leitura: com ela, o Blave não consegue enviar ordens nem sacar fundos. Crie a key na exchange e cole na página de API do Blave.

O que você ganha ao conectar?

• Página de Portfólio: todas as exchanges conectadas juntas — evolução do valor da conta, desempenho, alocação, e o saldo e a exposição de cada moeda por exchange e carteira.
• O seletor de símbolos dos gráficos do Studio ganha uma aba "Portfólio" com as moedas que você tem agora, para trocar de gráfico sem precisar buscar.
• Contas que o Blave lê: na Binance, spot, futuros USDⓈ-M e Simple Earn flexível; na OKX, a conta de trading; na BingX, spot e futuros perpétuos; na Bitget, spot e futuros da conta clássica; na Bitunix, spot e futuros; na Bybit, a Conta de Trading Unificada. Em nenhuma das seis o Blave lê a conta Funding — moedas guardadas lá não aparecem na página de Portfólio.

É seguro entregar uma API key ao Blave?

• Conceda só permissão de leitura. As exchanges vinculam as permissões à própria key: quem tem uma key somente leitura consegue ver a conta, mas não enviar ordens, transferir ou sacar.
• O Blave usa a key para ler seus saldos e posições periodicamente; é isso que monta a página de Portfólio.
• A janela de conexão traz a Política de conexão de API: o Blave coleta e analisa, de forma anonimizada, os dados das contas conectadas para melhorar o produto. Para o Blave parar de ler sua conta, remova a key seguindo os passos de exclusão.

Como criar uma API key somente leitura em cada exchange?

O fluxo é parecido em todas: abra a página de gerenciamento de API da conta, crie uma key, dê só permissão de leitura, conclua a verificação de segurança e copie a key. Duas regras valem para todas as exchanges:

• Deixe a lista de IPs permitidos vazia. Se vincular o seu IP, os servidores do Blave ficam fora da lista e não conseguem ler a conta.
• Somente leitura. Deixe desativadas as permissões de trading, transferência e saque.

Binance｜OKX｜BingX｜Bitget｜Bitunix｜Bybit

Os nomes de botões e campos abaixo seguem o site em inglês de cada exchange; podem mudar em outros idiomas ou depois de um redesenho.

Binance

Antes de criar uma key, a Binance exige 2FA ativada, um depósito de qualquer valor na Carteira Spot e verificação de identidade. Use uma key gerada pelo sistema (HMAC); keys RSA/Ed25519 geradas por você não conectam. Ao conectar, o Blave verifica sua conta de futuros USDⓈ-M, então uma conta sem futuros habilitados não conecta.

1. Entre na Binance pela web, clique no ícone de perfil → "Account" → "API Management" e depois em "Create API". No app: "More" → "Other" → "API Management".
2. Escolha "System-generated", digite Blave como rótulo e conclua a 2FA.
3. Confira que "Enable Reading" é a única permissão (vem por padrão). Não marque mais nada nem configure restrição de IP.
4. Copie a API Key e a Secret Key.

Guia oficial da Binance

OKX

1. Entre na OKX pela web, vá em "Profile" → "API and connections" e clique em "Create API key".
2. Digite um nome para a API key (por exemplo, Blave) e em "Account" escolha a conta que o Blave deve ler.
3. Em "Permissions", marque só "Read". Deixe vazia a lista de endereços IP permitidos.
4. Defina uma Passphrase e anote. A OKX não a mostra de novo: se perder, será preciso excluir a key e criar outra. Você vai precisar dela ao conectar no Blave.
5. Conclua a verificação de segurança e copie a API Key e a Secret Key.

Guia oficial da OKX

BingX

Ao conectar, o Blave verifica sua conta de futuros perpétuos, então uma conta sem futuros habilitados não conecta.

1. Entre na BingX pela web, abra "API Management" no centro do usuário e clique em "Create API".
2. Digite um nome fácil de reconhecer (por exemplo, Blave) e conclua a verificação de segurança.
3. Mantenha só a permissão de leitura: desative trading spot, trading de futuros, transferência universal, gestão de subcontas e saques, e deixe o IP vazio. A BingX não exclui keys somente leitura por inatividade.
4. Copie a API Key e a Secret Key.

Abrir o gerenciamento de API da BingX

Bitget

Por enquanto só contas clássicas são compatíveis. Uma key de Conta de Trading Unificada (UTA) retorna "Invalid API." ao conectar.

1. Entre na Bitget pela web, abra "API Management" no centro pessoal e clique em "Create New API".
2. Digite Blave em "Notes" e defina uma API Passphrase. Anote: você vai precisar dela ao conectar no Blave.
3. Escolha a permissão "Read-only" e não vincule IP.
4. Informe os códigos de verificação de e-mail, SMS e Google e copie a API Key e a Secret Key.

Guia oficial da Bitget

Bitunix

Ao conectar, o Blave verifica sua conta de futuros, então uma conta sem futuros habilitados não conecta.

1. Entre na Bitunix, clique no ícone de perfil → "API Management" e depois em "Create API".
2. Digite Blave em "Note" e escolha "Bind Third-Party App" em "Purpose": as permissões mudam para "Read-only" automaticamente. Se a tela estiver diferente, o que importa é dar só permissão de leitura.
3. Conclua a verificação de segurança. A API Key e a Secret Key aparecem na tela: copie e guarde na hora.

Abrir o gerenciamento de API da Bitunix

Bybit

Contas novas podem não conseguir criar keys nas primeiras 48 horas. Use uma key gerada pelo sistema (HMAC); keys RSA/Ed25519 geradas por você não conectam. Uma key da Bybit sem IP vinculado expira em 90 dias — veja o que fazer se a conexão falhar para renovar.

1. Abra o site da Bybit em um computador (não dá para criar API keys no app) e clique no ícone de perfil → "API" para chegar à página "API Management".
2. Clique em "Create New Key" e escolha "System-generated API Keys".
3. Escolha o uso que a tela oferecer e digite Blave como nome.
4. Escolha a permissão "Read-Only" e a opção "No IP restriction".
5. Informe seu código Google 2FA e copie a API Key e a Secret Key.

Guia oficial da Bybit

Cole a key no Blave

O que fazer se a conexão falhar?

• Aparece "Invalid API.": o Blave não conseguiu ler a conta com esta key. Verifique nesta ordem: a key foi copiada incompleta ou com espaços a mais; a exchange escolhida está errada; a Passphrase da OKX ou da Bitget está faltando ou errada; a key da Binance ou da Bybit é RSA/Ed25519 gerada por você; os futuros não estão habilitados na Binance, BingX ou Bitunix.
• Uma key da Bitget sempre retorna "Invalid API.": se sua conta da Bitget é uma Conta de Trading Unificada (UTA), ainda não dá para conectar — o Blave só é compatível com contas clássicas.
• Aparece "The API has already been connected.": esta conta da exchange já está conectada a uma conta do Blave, talvez outra sua. Exclua primeiro na página de API dessa conta e conecte de novo.
• A Bybit funcionava e os dados pararam: keys da Bybit sem IP vinculado expiram em 90 dias. Na página API Management da Bybit, clique em editar na coluna "IP Address Added" da key, escolha "No IP restriction", envie e verifique. A key continua a mesma e ganha mais 90 dias a partir daquele momento (FAQ oficial da Bybit).

Como excluir uma key?

1. Primeiro, na aba "Exchange" da página de API do Blave, clique em "Excluir" ao lado da key e confirme.
2. Depois exclua a mesma key na página de gerenciamento de API da exchange.

Siga esta ordem. Se excluir a key primeiro na exchange, o registro no Blave não é removido automaticamente.