O que é negociação via API e como configurá-la na Bybit EU

Bybit Learn
Aug 27, 2026
3 min de leitura

Resumo de IA

Mostrar mais

Entenda rapidamente o conteúdo do artigo e avalie o sentimento do mercado em apenas 30 segundos!

Resumo detalhado

O que é a Negociação via API e como configurá-la na Bybit EU

Negociação via APIpermite que software externo ou desenvolvido pelo próprio se ligue a uma conta Bybit EU através de uma interface de programação de aplicações, ou API. Em vez de concluir cada ação manualmente através do website ou da aplicação, os utilizadores podem ligar software como robôs de negociação, terminais personalizados, painéis de portefólio ou sistemas de negociação internos. Dependendo das permissões concedidas, o software ligado pode obter dados, monitorizar a atividade da conta e colocar ou gerir ordens.

O que é a negociação por API?

Uma API é uma ligação estruturada entre a Bybit EU e outra aplicação de software. O Trading com API pode ser utilizado para:

  • Aceder a dados de mercado

  • Visualizar saldos e informações da conta

  • Consultar ordens e posições

  • Colocar, alterar ou cancelar ordens

  • Monitorizar atualizações de ordens e execuções

  • Obter registos de transferência ou conversão autorizados

  • Automatizar processos de negociação pré-definidos



A API não cria uma estratégia nem decide autonomamente quando negociar. Processa pedidos e instruções gerados pelo software conectado. Por exemplo, um utilizador pode ligar:

  • Um Trading Bot que executa ordens quando as condições pré-definidas são cumpridas.

  • Um painel de portfólio que exibe saldos e posições

  • Um sistema de monitorização de risco que monitoriza a exposição

  • Um terminal de negociação personalizado

  • Uma aplicação de Terceiros suportada

Como funciona o Trading com API

O processo geral é:

  1. O utilizador cria umChave da APIna sua conta Bybit UE.

  2. O utilizador seleciona o que a chave tem permissão para aceder.

  3. A chave está ligada ao software selecionado.

  4. O software autentica-se e envia pedidos à Bybit EU.

  5. A Bybit EU processa os pedidos e devolve os dados relevantes, a confirmação ou a mensagem de erro.

As permissões da chave API determinam o que o software ligado pode fazer. Uma chave de apenas leitura pode obter informações aprovadas, mas não pode colocar ou gerir ordens. Uma chave de leitura e escrita pode realizar as ações de negociação ou de conta específicas selecionadas pelo utilizador.

API REST e API WebSocket

Uma integração típica de API utiliza as interfaces REST e WebSocket.

API REST

O REST é utilizado para enviar pedidos ou instruções individuais. Por exemplo:

  • Obter o saldo da conta

  • Ver ordens em aberto

  • Colocar uma ordem

  • Alterar uma ordem

  • Cancelar uma encomenda

  • Solicitar informações sobre transações recentes

Os pedidos REST V5 da Bybit retornam uma resposta estruturada contendo um resultado, uma mensagem de resposta e um código de sucesso ou erro.

API WebSocket

O WebSocket mantém uma ligação em tempo real entre a Bybit e o software conectado. Pode ser utilizado para receber atualizações contínuas sobre:

  • Preços de mercado

  • Negociações públicas

  • Estado da ordem

  • Execuções de negociação

  • Posições

  • Atividade da conta

Os dados públicos do WebSocket normalmente não requerem autenticação. Dados privados de conta e de negociação requerem uma ligação autenticada.

Como criar uma Chave API na Bybit EU

Passo 1: Aceder à gestão de API

Inicie sessão na Bybit EU, abra o menu suspenso do perfil e selecioneAPI



Passo 2: Painel da API

Isto abre oGerenciamento de APIPainel, onde as chaves de API podem ser criadas, revistas, editadas e eliminadas.

  • SelecionarCriar Nova Chaveno canto superior direito para começar.

Passo 3: Escolha o tipo de Chave API

Os utilizadores podem escolher entre uma chave API gerada pelo sistema e uma chave API autogerada.

Chave de API Gerada pelo Sistema

Chave API Auto-gerada

Uma chave API gerada pelo sistema é criada pela Bybit EU e utiliza autenticação HMAC. Após a conclusão da configuração, a Bybit EU fornece:

Uma chave de API

Um segredo de API

O software ligado utiliza o segredo da API para assinar pedidos autenticados. Esta é a configuração padrão para muitos bots de negociação, terminais e outras integrações.

Uma Chave API gerada pelo próprio utiliza autenticação RSA. Antes de concluir a configuração, o utilizador gera:

Uma chave pública RSA

Uma chave privada RSA correspondente

A chave pública é submetida à Bybit EU. A chave privada permanece sob o controlo do utilizador e é utilizada para assinar pedidos. A Bybit EU não detém a chave privada RSA.



Passo 4: Selecione a utilização da chave API

A informação necessária depende do tipo de chave selecionado. Escolha uma das seguintes opções:

  • Transação API:Selecione esta opção ao conectar o seu próprio software diretamente à Bybit EU.

  • Conectar a Aplicações de Terceiros:Selecione esta opção ao autorizar uma plataforma externa suportada a ligar-se à sua conta Bybit EU.

Passo 5: Fornecer as informações chave

As informações necessárias dependem do tipo de chave selecionado.

Para um chave gerada pelo sistema, introduza um nome para a chave de API.

Para um chave autogerada:

Gerar um par de chaves RSA pública e privada.

Cole a chave pública em A sua chave pública campo.

Introduza um nome para a chave de API.

Utilizar um nome que identifique claramente a finalidade da chave, como:

  • Bot de Negociação à Vista

  • Painel do Portefólio

  • Ferramenta de Monitorização de Risco

  • Sistema de Negociação Interno

Passo 6: Escolher Acesso Somente Leitura ou Acesso de Leitura e Escrita

Selecione o nível de acesso requerido pelo software conectado.

Apenas Leitura

Uma chave somente leitura pode recuperar informação permitida, mas não pode colocar, alterar ou cancelar ordens. Pode ser adequado para:

Painéis da Carteira

Ferramentas de relatório

Software fiscal

Sistemas de monitorização de contas

Painéis de controlo de riscos

Leitura e escrita

Uma chave de leitura-escrita pode executar as ações de negociação ou de conta selecionadas na secção de permissões. Dependendo das permissões concedidas, isto pode incluir:

Colocar ordens

Alterar ordens

Cancelar ordens

Gerir funções de conta suportadas

O acesso de leitura e escrita deve ser ativado apenas quando necessário.

Passo 7: Configurar restrições de IP

Os utilizadores podem escolher entre o acesso com restrição de IP e o acesso sem restrições.

lista de permissão de IP

Apenas pedidos de endereços IP aprovados serão aceites. Esta é a opção recomendada quando o software conectado opera a partir de um servidor conhecido ou de uma localização de rede fixa. Uma única Chave API pode ser associada a múltiplos endereços IP aprovados. A interface Bybit EU permite atualmente adicionar até 100 endereços IP a uma chave.

Sem restrição de IP

A Chave API pode ser utilizada a partir de qualquer endereço IP. Isto proporciona mais flexibilidade, mas aumenta o risco caso as credenciais sejam expostas. Algumas permissões sensíveis podem não estar disponíveis sem a lista de permissões de IP. As Chaves API sem um endereço IP associado perdem a validade após 90 dias. A associação da chave a endereços IP aprovados remove esta condição de validade de 90 dias.

Passo 8: Selecione as permissões da API

Escolha a que funções de negociação e conta a Chave API pode aceder. As permissões disponíveis incluem:

Trading Unificado

Spot Trading: Ver informações da Spot ordem e submeter ou cancelar Spot ordens.

Ativos

Transferência de ContaTransferir ativos.



Transferência de Subconta:Transfira ativos entre Contas Principais e Subcontas, visualize registos de transferências relacionados e aceda à lista de Subcontas.



Conversão da Bybit / Histórico de Conversão:Utilize o Bybit Convert e consulte os registos de conversão de ativos.

Passo 9: Submeter e verificar

Antes de submeter, revise:

  • O tipo de chave

  • A utilização da chave API

  • O nome da chave

  • Acesso apenas de leitura ou de leitura e escrita

  • Restrições de IP

  • Permissões de negociação e conta

Após a submissão, confirme os seus dados através da autenticação por e-mail e do Google 2FA.



SelecionarSubmeter assim que a configuração estiver correta.

Após a submissão, confirme os seus dados através da autenticação por e-mail e do Google 2FA.

Passo 10: Chave adicionada com sucesso

Após a submissão, receberá uma janela pop-up com a informação da sua chave

  • O nome da chave API

  • A chave de API

  • O segredo da API

  • As permissões selecionadas



O segredo da API é apresentado apenas uma vez. Copie-o imediatamente e guarde-o em segurança antes de selecionar.Compreendido. Para um Chave API auto-gerada, reter a Chave privada RSA criada antes da configuração. A Chave privada não deve ser submetida à Bybit EU nem partilhada com outra parte não autorizada.



Os segredos da API e as chaves privadas nunca devem ser:

  • Incluído em capturas de ecrã ou vídeos

  • Armazenado em código-fonte público

  • Carregado para repositórios públicos

  • Partilhado através de mensagens não seguras

  • Fornecido a pessoas não autorizadas

Passo 11: Gerir a chave API

Após o envio, a chave aparece na Gerenciamento de APIPainel. A partir do painel, os utilizadores podem:

  • Rever as permissões da chave

  • Editar a sua configuração

  • Adicionar ou atualizar endereços IP aprovados

  • Ativar uma lista branca de símbolos

  • Eliminar a chave

O segredo da API de uma chave gerada pelo sistema deixará de estar visível após o ecrã de criação inicial.

Comece a utilizar a API da Bybit EU

Assim que a sua Chave API estiver configurada, utilize a documentação Bybit V5 para ligar o seu software, autenticar pedidos e aceder aos endpoints da API disponíveis.



Explore a Documentação da API V5



Para questões de configuração e suporte contínuo, junte-se aComunidade do Telegram da API Bybit



Para mais assistência, contacte a nossa equipa de Apoio ao Cliente através de Chat em direto ou submeta um caso através de este formulário



O investimento em criptoativos está associado a riscos, incluindo a elevada volatilidade e a potencial perda de capital. Informe-se detalhadamente sobre os riscos antes de tomar uma decisão de investimento. A informação fornecida neste artigo destina-se estritamente a fins educativos e informativos e não deve ser interpretada como aconselhamento financeiro ou de investimento.

    roadmap