Skip to main content
Início›Integrações›Webhook → Bybit
Guia de integração de webhook personalizado para Bybit

Webhook para Bybit — o JSON chega como sinal registrado

Você pode fazer POST de um payload JSON plano para a sua URL de webhook da PipSync: ela o transforma em um sinal na página Sinais, onde você o revisa. Um webhook do seu próprio sistema nunca é operado automaticamente: ele sempre é salvo como sinal para a sua aprovação. As contas da Bybit são conectadas pelo gateway, então por enquanto o risco de uma operação de cripto não pode ser medido nelas: um alerta do TradingView não é operado automaticamente ali e fica apenas registrado como sinal e por enquanto não pode ser colocado ali a partir da PipSync (sinais do Telegram e do Discord continuam sendo executados ali). O webhook exige um plano que inclua a integração por webhook (o plano Advanced).

Cobrança no checkout · Cancela quando quiseres · Plano Free disponível

Aviso de risco: Negociar CFDs e outros produtos alavancados é complexo e apresenta alto risco de perder dinheiro rapidamente devido à alavancagem. Dados do setor indicam que 70–80% das contas de negociação de varejo perdem dinheiro com esses produtos. Aviso de risco · Desempenho passado.

Esta rota é agnóstica em relação à origem: qualquer sistema capaz de fazer um POST por HTTPS pode enviar sinais para a PipSync pelo mesmo contrato JSON. Webhooks do seu sistema sempre ficam como sinais para a sua aprovação; alertas do TradingView também não são operados automaticamente na Bybit, por enquanto, e sinais do Telegram e do Discord continuam sendo executados.

Webhook para Bybit em resumo

OrigemQualquer sistema capaz de fazer POST por HTTPS de JSON plano (scripts, bots, serverless, no-code)
DestinoBybit — webhooks e alertas viram apenas sinais registrados; sinais do Telegram e do Discord são executados
PayloadJSON plano: instrument, direction (buy / sell), entry, sl e tp1 (sl e tp maiores que 0); texto simples é sempre salvo como sinal para a sua aprovação
Chave APISua própria chave Bybit só de trade, com saques desativados; nunca usada para transferências
Segurança da ordemUm webhook do seu próprio sistema nunca é operado automaticamente; reduce-only vale nas rotas de Telegram e Discord
Trading automáticoNão para webhooks do seu próprio sistema; alertas do TradingView também não são operados automaticamente na Bybit, por enquanto, porque o risco de cripto não pode ser medido nas contas conectadas pelo gateway
FeedbackWebhooks de saída assinados (HMAC-SHA256) mais API REST de leitura
PreçoO webhook exige um plano que inclua a integração por webhook (o plano Advanced); confira os planos atuais no checkout

Como envio um webhook à PipSync?

Envie sinais do seu próprio código ou automação à PipSync: ela te dá uma URL de webhook com token e cria um sinal para a sua aprovação; um webhook do seu próprio sistema nunca é operado automaticamente. A chave API só de trade serve às rotas de Telegram e Discord.

  1. Crie sua conta na PipSync e escolha um plano

    Cadastre-se em app.pipsync.io e assine um plano que cubra esta rota (é necessário um meio de pagamento).

  2. Contas de destino

    Sinais do Telegram e do Discord são executados na Bybit. Um webhook do seu próprio sistema nunca é operado automaticamente: este fluxo termina em webhook → sinal para a sua aprovação na página Sinais. As contas da Bybit são conectadas pelo gateway, então por enquanto o risco de uma operação de cripto não pode ser medido nelas: um alerta do TradingView não é operado automaticamente ali e fica apenas registrado como sinal e por enquanto não pode ser colocado ali a partir da PipSync.

  3. Adicione uma origem de webhook personalizada

    Na PipSync, gere a URL do webhook em Configurações → Avançado → Alertas do TradingView. O token secreto da URL, mostrada uma única vez, é a credencial — mantenha-o privado e rotacione-o pelo painel se suspeitar de um vazamento.

  4. Configure regras de risco no servidor

    Os webhooks do seu sistema chegam como sinais na página Sinais. Cada sinal aguarda a sua confirmação na página Sinais, e um webhook do seu próprio sistema nunca é operado automaticamente.

  5. Faça POST do seu primeiro payload JSON

    Do seu script ou automação, envie um corpo JSON plano com instrument, direction, entry, sl e tp1 para a URL do webhook. Use o nome exato do contrato na Bybit; sl e tp1 precisam ser maiores que 0.

  6. Verifique em Alertas recentes

    Dispare um payload e confira em Alertas recentes (Configurações → Avançado → Alertas do TradingView) se a PipSync o interpretou corretamente.

Tempo de configuração típico: cerca de 11 minutos.

Como é o payload JSON de um webhook para a Bybit?

O payload é um único objeto JSON plano — sem aninhamento — que a PipSync transforma em um sinal para a Bybit. Os campos obrigatórios são instrument, direction ("buy" ou "sell"), entry, sl e tp1. O instrument deve corresponder ao nome exato do contrato na Bybit.

Os preços são valores absolutos, e sl e tp1 precisam ser maiores que 0. O payload não define o tamanho. Mensagens em texto simples são sempre salvas como sinal para a sua aprovação.

  • instrument: o nome exato do contrato na Bybit (por exemplo, um perpétuo USDT)
  • direction: "buy" ou "sell"
  • entry: preço de entrada absoluto
  • sl: preço absoluto de stop-loss, maior que 0
  • tp1: preço absoluto de take-profit, maior que 0
  • texto simples: sempre salvo como sinal para a sua aprovação; envie JSON

Por que usar uma chave API só de trade na Bybit?

Uma chave API só de trade permite que a PipSync, nas rotas de Telegram e Discord, coloque e gerencie ordens na sua Unified Trading Account sem nunca conseguir mover fundos para fora da exchange. Você cria a chave na Bybit com saques desativados, então mesmo que a credencial fosse exposta, ela não poderia iniciar uma transferência.

O seu próprio código também nunca precisa embutir chaves da Bybit — você faz POST para uma URL de webhook da PipSync cujo token secreto é a única credencial que seus scripts guardam. A PipSync armazena a chave da exchange no servidor, separando o código da sua estratégia do acesso à sua conta.

Como a PipSync lida com o fechamento de uma posição na Bybit?

O webhook cria sinais de entrada e não existe um payload "close": a PipSync não fecha posições a partir de webhooks nem de alertas do TradingView, e a saída acontece pelo SL/TP do sinal ou por uma decisão sua.

Isso importa na Unified Trading Account, onde a margem unificada e os perpétuos tornam a exposição fácil de inverter nas rotas de Telegram e Discord.

Como recebo feedback de execução dos trades na Bybit?

Para sinais do Telegram e do Discord executados na Bybit, a PipSync te dá três canais de feedback para que o seu sistema sempre saiba o que aconteceu. Os webhooks de saída assinados disparam nos eventos trade.opened, trade.closed, tp_hit e sl_hit, cada um carregando uma assinatura HMAC-SHA256 no cabeçalho X-PipSync-Signature e reenviado até cinco vezes com backoff. Uma API REST de leitura (GET /v1/signals e GET /v1/trades, documentada via OpenAPI 3.1) permite consultar o estado sob demanda, e o painel mostra todo sinal e ordem processados em todos os planos.

Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter. A API de leitura faz parte do plano Enterprise.

O webhook funciona 24/7 sem um servidor meu?

Sim. O recebimento de webhooks na PipSync é totalmente baseado na nuvem e funciona 24/7, o que combina com os mercados cripto que nunca fecham. Não há VPS, plugin nem terminal para manter aberto — depois que a URL do webhook e a chave só de trade estão configuradas, o webhook continua recebendo com o seu notebook ligado ou desligado.

Como a rota é agnóstica em relação à origem, a mesma configuração serve para um script disparado por cron, um bot hospedado ou uma função orientada a eventos. O seu trabalho é fazer POST de JSON válido; a PipSync cuida da autenticação e da criação do sinal.

Analise de graça, execute com um plano pago

Conecte uma fonte de sinais e veja o PipSync analisar em tempo real. Comece no plano Free a 0 $ sem cartão, ou assine a partir de 24 $/mês para a execução: cobrado no checkout, cancele quando quiser.

Cobrança no checkout · Cancela quando quiseres · Plano Free disponível

Aviso de risco: Negociar CFDs e outros produtos alavancados é complexo e apresenta alto risco de perder dinheiro rapidamente devido à alavancagem. Dados do setor indicam que 70–80% das contas de negociação de varejo perdem dinheiro com esses produtos. Aviso de risco · Desempenho passado.

FAQ

Perguntas frequentes

Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter. Um webhook para a Bybit pela PipSync deixa você fazer POST de um payload JSON plano e receber um sinal para revisar, com eventos de feedback assinados. Seus scripts guardam apenas um token de webhook, não as suas chaves da Bybit.

Escrito pela equipe do PipSync · Revisado por PipSync Editorial, Equipe editorial · Publicado · Última atualização

O PipSync é uma plataforma de automação de sinais baseada na nuvem que encaminha sinais de trading do Telegram, Discord, alertas do TradingView e webhooks personalizados para contas de corretora no MetaTrader 5, cTrader, Match-Trader, Binance Futures e Bybit, com gestão de risco no lado do servidor e sem necessidade de VPS. O PipSync é uma ferramenta de execução, não um provedor de sinais nem aconselhamento de investimento.

O PipSync é uma ferramenta de execução de sinais. Não fornece sinais de trading, não garante nenhum resultado e não constitui aconselhamento de investimento. Operar produtos alavancados envolve risco substancial de perda. Consulte o aviso de risco e o aviso de desempenho.