O que é negociação via API e como configurá-la na Bybit EU
Resumo de IA
Mostrar mais
Entenda rapidamente o conteúdo do artigo e avalie o sentimento do mercado em apenas 30 segundos!
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 é:
O utilizador cria umChave da APIna sua conta Bybit UE.
O utilizador seleciona o que a chave tem permissão para aceder.
A chave está ligada ao software selecionado.
O software autentica-se e envia pedidos à Bybit EU.
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 LeituraUma 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 escritaUma 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 IPApenas 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 IPA 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 UnificadoSpot Trading: Ver informações da Spot ordem e submeter ou cancelar Spot ordens. | AtivosTransferê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.