A API da Bitget entrega cerca de três meses de execuções. O SetupBook consegue lê-las com uma chave somente leitura, então seus trades de futuros USDT-M e spot chegam ao diário sem você digitar nada. Como a OKX, a Bitget pede que você invente uma passphrase ao criar a chave, e o SetupBook precisa dela além da chave e do secret. 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 usa a OKX, veja o guia da OKX.

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 Bitget.
  • Um lugar para anotar a passphrase, como um gerenciador de senhas.
  • Cinco minutos.

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

1. Abra o API Key Management e crie uma chave

No site da Bitget abra o menu embaixo do seu perfil e escolha API Key Management, depois aperte Create API key. O texto do menu pode mudar um pouco entre o site e o aplicativo, então procure a página chamada API Key Management. Dê à chave um nome que você reconheça, por exemplo SetupBook.

Desenho do formulário Create API key da Bitget: Read-only selecionado, escrita e saque desligados
Create API key: um nome, uma passphrase sua, Read-only selecionado, mais nada.

2. Escolha Read-only

A Bitget oferece chaves somente leitura e de leitura e escrita. Escolha Read-only. Olhe qual opção está selecionada antes de confirmar, porque o padrão pode mudar de uma página para outra. Deixe desligados trade, transferência e saque.

Restrição de IP: a Bitget recomenda vincular um endereço IP, mas não exige. 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.

3. Defina uma passphrase e copie a chave

Digite uma passphrase sua. Depois de definida ela não pode ser alterada, e a Bitget não consegue mostrá-la de novo: se você esquecer, precisa criar uma chave nova. Confirme com a sua verificação de segurança. Depois a Bitget mostra a API key e o secret. Copie a chave, o secret e a passphrase para um lugar seguro.

4. Cole os três no SetupBook

No SetupBook abra Contas → Conexões e aperte Adicionar conexão. Escolha Bitget. Cole a chave em Chave de API, o secret em API secret e a passphrase em Passphrase.

Em Mercados marque o que você opera: Perpétuos USDT (futuros USDT-M) e Spot. A Bitget não precisa de lista de pares. Deixe Para a conta em Criar a partir da conta da plataforma, ou escolha uma das suas, e aperte Verificar a chave e conectar.

O diálogo de conexão da Bitget no SetupBook com os campos de chave de API, secret e passphrase e os mercados destacados
Contas → Conexões → Adicionar conexão → Bitget. Três campos: chave, secret, passphrase.

O SetupBook confere a chave com a Bitget primeiro e lê as permissões da chave. Se a chave puder escrever, ele avisa; apague essa chave na Bitget e crie uma somente leitura.

5. Acompanhe a primeira sincronização

A primeira sincronização começa na hora e volta cerca de três meses. 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 Bitget com o status Ativa, a última sincronização e o total de trades
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. Se você usa o modo hedge, o lado long e o lado short ficam como posições separadas.
  • Campos travados. Símbolo, lado, horários, preços, tamanho, taxas e o resultado líquido vêm da Bitget 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 Bitget 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.

Mais antigo que três meses? Esse histórico precisa entrar como arquivo. Se você consegue exportá-lo da Bitget como CSV, a opção Outro CSV (mapear colunas) da importação mapeia as colunas: veja o guia de importação.

Demo ou real

O SetupBook conecta só contas reais da Bitget. Ainda não há opção Demo para a Bitget.

Substituindo uma chave

Abra o menu da conexão, escolha Editar e aperte Substituir a chave. Cole a chave, o secret e a passphrase 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
Chaves da OKX, da Bitget e da KuCoin precisam da passphrase. O campo da passphrase está vazio Cole a passphrase que você definiu ao criar a chave
A exchange rejeitou a chave. Uma passphrase errada, um secret digitado errado, ou uma chave apagada Confira os três valores, ou crie uma chave nova
Você esqueceu a passphrase A Bitget não consegue mostrá-la de novo Crie uma chave nova e use Substituir a chave
Esta chave pode operar. (um aviso) A chave é de leitura e escrita Crie uma chave Read-only nova e substitua
Faltam trades spot Spot não está marcado Edite a conexão e marque o mercado
Os trades são mais antigos que três meses A API não os entrega Importe um CSV do histórico mais antigo com Outro CSV (mapear colunas)

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 somente leitura não consegue enviar uma ordem nem sacar, e o SetupBook não tem código que tente isso. A chave e a passphrase são guardadas seladas no servidor e nunca são enviadas ao seu navegador. Para parar, apague a chave na Bitget e a conexão para.

Por que o SetupBook precisa da passphrase?

A Bitget assina cada requisição com a passphrase, além da chave e do secret. Sem ela a Bitget rejeita a requisição. Você escolheu a passphrase ao criar a chave.

Preciso restringir o endereço IP?

Não. 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. Uma chave somente leitura não consegue operar nem sacar, com ou sem regra de IP.

Quais mercados da Bitget são lidos?

Futuros USDT-M 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 BingX.