Guides Guia Bybit

Como criar e configurar uma chave API da Bybit

Intermediário
Guia Bybit
2023年6月14日

APIs de trading têm sido amplamente usadas por sua versatilidade e flexibilidade para personalização. A integração de uma API de trading é especialmente útil para a automação que permite que os traders gerenciem seus portfólios, analisem tendências de mercado ou implementem estratégias de trading sofisticadas. À medida que o mercado de cripto continua evoluindo, mais atualizações e recursos de produtos estão sendo integrados para atender ao aumento da demanda, incluindo a implantação de APIs da Bybit. 

Neste guia, você aprenderá como integrar a API da Bybit com outros aplicativos de trading automatizados. 

Principais conclusões:

  • As APIs e chaves API trabalham lado a lado, permitindo que os aplicativos de software interajam entre si.

  • A Bybit oferece muitas APIs, desde a WebSocket API e a API REST até a API de histórico de dados de mercado. 

  • Os usuários podem se beneficiar dessas APIs personalizando sua interface de usuário e preferências e automatizando suas estratégias de copy trading para aumentar sua velocidade e precisão de trading. 

O que é a API da Bybit?

A API da Bybit é um conjunto de interfaces de programação de aplicativos (Application Programming Interfaces, “APIs”) que permitem que os desenvolvedores interajam com a plataforma da Bybit de maneira programática. A Bybit é uma corretora de alto nível para derivativos de criptomoedas que oferece opções de negociação para vários ativos digitais. Com APIs, os desenvolvedores podem acessar dados de mercado, gerenciar ordens, executar trades e se inscrever em fluxos de dados. 

A API tem várias versões que atendem a diferentes propriedades e produtos. Por exemplo, a API V3 suporta contratos de spot trading, perpétuos de USDC e opções, e a API V2 suporta contratos perpétuos inversos e futuros. Para maximizar a segurança, a API da Bybit usa criptografia HMAC para a autenticação. Os desenvolvedores podem usar uma variedade de ferramentas e linguagens, incluindo Python, Node.js e WebSocket, para integrar-se à API da Bybit.

Entendendo a API e as chaves API

API refere-se a um protocolo de comunicação que usa um conjunto diferente de regras e linguagens, permitindo que aplicativos de software interajam entre si. Por exemplo, a API da web usa protocolos HTTP, permitindo que os desenvolvedores acessem recursos baseados em web por meio de formatos de dados comumente usados, como JSON e XML

As chaves API, por sua vez, podem aparecer como chaves públicas ou privadas. Elas funcionam como chaves de autenticação ou tokens de acesso, usando uma sequência de caracteres exclusivos que servem como uma forma de autenticação para solicitar acesso à função de API. Essas chaves de autenticação são geradas pelo provedor da API principalmente para rastrear o uso da API por diferentes clientes ou aplicativos. 

Diferenças entre a API V3 e V5 da Bybit

A API V3 da Bybit é a versão anterior da API da Bybit. Ela suporta contratos lineares e inversos para contas regulares e unificadas. Por outro lado, a API V5 da Bybit é a versão mais recente, atualizada para oferecer suporte a contratos spot, derivativos e opções para contas unificadas Bybit.

Aqui estão algumas das diferenças entre a API V3 e V5:

  • A API V3 da Bybit abrange apenas produtos de trading específicos, sendo que outros produtos têm seus próprios conjuntos de APIs. Por outro lado, a API V5 combina as APIs de vários produtos de trading em uma única, permitindo que os usuários façam trades com contratos de spot, derivativos e opções por meio de uma única API.

  • Ao contrário da V3, a API V5 da Bybit permite que os usuários atualizem suas contas para uma conta de trading unificado, permitindo o compartilhamento de fundos e a utilização cruzada em diferentes tipos de contrato.

  • A API V5 suporta empréstimos por meio de uma conta de trading unificado, usando vários ativos como garantia para margem no trading de diferentes produtos.

  • A API V5 também permite margens combinadas entre os contratos perpétuos de USDT, perpétuos de USDC, futuros de USDC e opções para contas de trading unificado.

A API V5 do Bybit é construída sobre a API V3, facilitando a atualização pelos usuários simplesmente ajustando o URL e os campos de interface.

Saiba mais:Documentação de API da Bybit (documentos de API)

Como criar uma chave API na Bybit

Para usar a Bybit com aplicativos de terceiros, você deve primeiro criar uma chave API na plataforma da Bybit. Mas antes de fazer isso, é essencial entender o limite de taxas de IP.

Entendendo o limite de taxas de IP

O limite de taxas de IP regula o tráfego da rede, com base nos endereços IP das solicitações recebidas, e impede que os usuários repitam ações com muita frequência dentro de um prazo específico. A Bybit tem diferentes limites de taxas para diferentes solicitações, como dados públicos, dados privados e envio de ordens. 

Se você exceder o limite de taxas para um determinado tipo de solicitação, você receberá um código de erro e sua solicitação será rejeitada. Para evitar isso, você deve monitorar sua frequência de solicitação e ajustar conforme necessário. Além disso, considere usar a WebSocket API em vez da API REST para algumas solicitações, já que as solicitações WebSocket não entram na contagem para o limite de taxas.

Instruções passo a passo para conectar sua API

Para usar a API da Bybit com um aplicativo ou plataforma, primeiro crie uma chave API na Bybit e depois conecte-a à plataforma desejada. Prossiga com o seguinte:

  1. Faça login em sua conta da Bybit ou vá para Criar conta para abrir uma conta na Bybit.

  2. Clique no ícone da sua conta no canto superior direito da tela e selecione API no menu suspenso.

  3. Navegue até a aba de Gerenciamento de API e clique em Criar nova chave.

  4. Selecione Chaves API geradas pelo sistema ou Chaves API geradas automaticamente.

  5. Selecione Conectar a aplicativos de terceiros, selecione o aplicativo de terceiros no menu suspenso e nomeie a chave API.

  6. Defina as permissões para a chave API (por exemplo, informações da conta, envio de ordens, informações da posição) e clique em Enviar.

  7. Copie a chave e o segredo da API e salve-os em um lugar seguro.

  8. Faça login no aplicativo de terceiros e vincule a API salva. 

Como conectar a API 3Commas na Bybit

Se quiser usar a plataforma de trading de cripto 3Commas na Bybit, primeiro, conecte-a usando uma chave API. Siga os passos abaixo:

  1. Faça login em sua conta da Bybit ou vá para Criar conta para abrir uma conta na Bybit.

  2. Clique no ícone da sua conta no canto superior direito da tela e selecione API no menu suspenso.

  3. Navegue até a aba de Gerenciamento de API e clique em Criar nova chave.

  4. Escolha Chaves API geradas pelo sistema.

  5. Altere para Conectar a aplicativos de terceiros e escolha 3Commas na lista suspensa com os nomes dos aplicativos.

  6. Selecione as permissões para a chave API: informações da conta, envio de ordens, informações da posição etc. (Você também pode selecionar Somente leitura se quiser apenas visualizar os dados da sua conta na 3Commas).

  7. Clique em Enviar para gerar a chave API. Você poderá visualizar sua chave API e a chave secreta na tela. Você pode copiá-las para sua área de transferência ou baixá-las como um arquivo.

  8. Faça login em sua conta 3Commas ou crie uma nova.

  9. Vá para a página Minhas corretoras e clique em Adicionar corretora.

  10. Selecione Bybit na lista de corretoras suportadas, insira sua chave API e a chave secreta que você gerou na Bybit. Você também precisa inserir sua ID de cliente, que pode ser encontrada na página Alterar senha da Bybit.

  11. Clique em Conectar para vincular sua conta da Bybit à 3Commas.

Depois de concluir essas etapas, você pode usar a 3Commas com a Bybit e acessar várias ferramentas e recursos de trading. Se precisar atualizar ou excluir sua chave API, você poderá fazer isso na página de gerenciamento de API na Bybit ou na página Minhas corretoras na 3Commas.

Como conectar a API Insilico na Bybit

Insilico é uma plataforma de trading de criptomoedas que oferece uma variedade de ferramentas e recursos, como gráficos interativos, livros de ordens, trades, instrumentos, atividades, ordens, posições, configuração, painéis de execução e painéis laterais. 

Veja como vincular sua conta da Bybit à Insilico:

  1. Faça login na sua conta da Bybit e clique no ícone Conta no canto superior direito da tela.

  2. Clique no ícone da sua Conta no canto superior direito da tela e selecione API no menu suspenso.

  3. Navegue até a aba de Gerenciamento de API e clique em Criar nova chave.

  4. Escolha Chaves API geradas pelo sistema.

  5. Mude para Conectar a aplicativos de terceiros e selecione Insilico Terminal no menu suspenso. Isso garante que a chave esteja restrita ao intervalo de IP do servidor da Insilico.

  6. Selecione as permissões para a chave API: informações da conta, envio de ordens e informações da posição. Você também pode escolher Somente leitura para apenas visualizar os dados da conta na Insilico.

  7. Clique em Enviar para gerar a chave API. Você poderá visualizar a chave API e a chave secreta na tela. Se desejar, você também pode copiá-las ou baixá-las como um arquivo.

  8. Faça login na sua conta Insilico (ou crie uma nova).

  9. Vá para a página Configurações e clique em Adicionar corretora.

  10. Selecione Bybit na lista de corretoras suportadas, insira sua chave API e a chave secreta gerada na Bybit. Você também precisa inserir sua ID de cliente, que pode ser encontrada na página Alterar senha da Bybit.

  11. Clique em Conectar para vincular sua conta Bybit à Insilico.

Posso usar o ambiente de teste da Bybit para testes de API?

Sim. Você pode usar o ambiente de teste da Bybit para testes de API pelo tempo que quiser, mas os dados e as transações não são reais e podem não refletir as condições reais do mercado. O ambiente de teste Bybit, também conhecido como testnet, é uma plataforma de trading virtual que permite testar suas estratégias e códigos de API sem arriscar fundos reais. Ele fornece acesso aos serviços de API da Bybit, como API REST, WebSocket API e histórico de dados de mercado.

Tipos de APIs da Bybit

A API da Bybit tem três tipos de interfaces. 

API REST 

A API REST é uma interface que permite enviar solicitações e receber respostas usando métodos HTTP, como GET, POST, PUT e DELETE. Você pode usar a API REST para executar várias ações na plataforma da Bybit: consultar dados de mercado, enviar ordens, modificar ordens e verificar posições. A API REST é ideal para solicitações de baixa frequência e alta latência.

WebSocket API

Essa interface permite estabelecer uma conexão persistente com o servidor da Bybit e receber atualizações em tempo real usando o protocolo WebSocket. Você pode usar a WebSocket API, equipada com os dados WebSocket, para se inscrever em vários mercados e tópicos de dados privados, como livro de ordens, linha K, trades, taxa de financiamento, status da ordem e status da posição. A WebSocket API é mais adequada para solicitações de alta frequência e baixa latência.

ExploreInscreva-se na WebSocket API.

Histórico de dados de mercado

Você pode baixar dados históricos do mercado aberto em formato CSV e usá-los para testar suas estratégias e analisar tendências de mercado. O histórico de dados de mercado inclui snapshots do livro de ordens, dados da linha K, dados comerciais e dados de taxas de financiamento.

Saiba maisbaixe a API Bybit Market Data aqui.

Como você pode se beneficiar da API da Bybit?

A API da Bybit é uma ferramenta poderosa que pode ajudar a melhorar sua experiência e desempenho de trading. Aqui estão algumas das maneiras pelas quais você pode se beneficiar:

  • Automatize suas estratégias de trading com velocidade e precisão. A API da Bybit permite criar e executar robôs de trading que podem enviar, modificar e cancelar ordens e gerenciar posições com base em seus parâmetros e lógica e predefinidos. A API também permite que você se integre com ferramentas e recursos de trading de terceiros.

  • Acesse histórico de dados de mercado e dados em tempo real. Inscreva-se em vários tópicos de dados de mercado e receba atualizações em tempo real usando a WebSocket API. Você também pode baixar dados históricos do mercado aberto em formato CSV para analisar tendências de mercado, identificar oportunidades de trading e testar suas estratégias.

  • Personalize sua interface de usuário e preferências. Crie sua própria interface de usuário e painel para exibir informações e funções personalizadas para suas necessidades. Você pode ajustar suas definições e configurações, como modo de margem, nível de alavancagem e limite de risco.

A API da Bybit é gratuita?

A API da Bybit é gratuita para usuários da Bybit, sem taxas ou cobranças adicionais. No entanto, taxas regulares de trading e de financiamento ainda se aplicam às suas transações na plataforma.

Conclusão

A API da Bybit oferece aos desenvolvedores ferramentas e interfaces úteis para que possam interagir com a plataforma da Bybit por meio de códigos. Essas ferramentas permitem automatizar estratégias de trading, acessar dados de mercado em tempo real e personalizar a interface do usuário. 

Siga as etapas acima para configurar uma Chave API na Bybit e conectá-la a aplicativos de terceiros, como 3Commas ou Insilico. É importante observar as diferenças entre as versões de API V3 e V5 da Bybit e manter-se dentro dos limites de taxas de IP para um trading descomplicado.