# Webhook para Bybit — o JSON chega como sinal registrado

Source: https://pipsync.io/pt/webhook-to-bybit
Last updated: 2026-06-08

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).

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

| | |
|---|---|
| Origem | Qualquer sistema capaz de fazer POST por HTTPS de JSON plano (scripts, bots, serverless, no-code) |
| Destino | Bybit — webhooks e alertas viram apenas sinais registrados; sinais do Telegram e do Discord são executados |
| Payload | JSON 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 API | Sua própria chave Bybit só de trade, com saques desativados; nunca usada para transferências |
| Segurança da ordem | Um webhook do seu próprio sistema nunca é operado automaticamente; reduce-only vale nas rotas de Telegram e Discord |
| Trading automático | Nã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 |
| Feedback | Webhooks de saída assinados (HMAC-SHA256) mais API REST de leitura |
| Preço | O 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.

## 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.

## FAQ

### Qual é a diferença entre um webhook para a Bybit e usar a API da Bybit diretamente?

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.

### Qualquer sistema pode enviar um webhook para a Bybit, ou só o TradingView?

Qualquer sistema capaz de fazer um POST por HTTPS pode operar a rota — ela é agnóstica em relação à origem. Isso inclui scripts Python, bots de backtesting, funções serverless, automações no-code e alertas do TradingView. Todos usam o mesmo contrato JSON plano e a mesma URL de webhook da PipSync com token. Só os alertas que o próprio TradingView envia podem operar automaticamente e, na Bybit, por enquanto nem esses; todo o resto vira sinal para a sua aprovação.

### A PipSync é um provedor de sinais ou dá conselhos de trading?

Não. A PipSync é infraestrutura de execução baseada na nuvem que transforma o que você envia em sinais para você revisar. Não é um provedor de sinais, não é um fornecedor de estratégias e não é aconselhamento de investimento. Você fornece a lógica de trading; a PipSync aplica as configurações que você definir.

### Qual tipo de conta da Bybit a rota de webhook usa?

Ela usa a Unified Trading Account com margem unificada, para sinais do Telegram e do Discord, em derivativos cripto como perpétuos USDT e USDC. Você a conecta com a sua própria chave API só de trade que tem os saques desativados, então a PipSync pode colocar ordens, mas nunca mover fundos para fora da Bybit.

### Como fecho uma posição na Bybit a partir do meu código?

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

### Um webhook do meu próprio sistema pode operar automaticamente na Bybit?

Não. Um webhook do seu próprio sistema nunca é operado automaticamente: ele sempre é salvo como sinal para a sua aprovação. Só os alertas que o próprio TradingView envia podem operar automaticamente e, na Bybit, por enquanto nem esses: o risco de uma operação de cripto não pode ser medido nas contas conectadas pelo gateway, então o alerta 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 que acontece se eu enviar webhooks demais para a Bybit de uma vez?

Os pedidos são limitados; se receber HTTP 429, aguarde e tente de novo com backoff e jitter.

### Preciso de um VPS ou servidor para manter o webhook da Bybit rodando?

Não. A rota é totalmente baseada na nuvem e funciona 24/7 sem necessidade de VPS, plugin ou terminal aberto. Depois que a URL do webhook e a chave só de trade estão configuradas, a PipSync continua recebendo os payloads que você envia por POST mesmo com o seu próprio computador desligado.

## Related

- [Webhook para Binance — o JSON chega como sinal registrado](https://pipsync.io/pt/webhook-to-binance)
- [Sinais do Telegram para a Bybit — executados automaticamente](https://pipsync.io/pt/telegram-to-bybit)
- [TradingView para Bybit — alertas viram sinais; sem trading automático na Bybit por enquanto](https://pipsync.io/pt/tradingview-to-bybit)
- [Copiador de sinais de cripto — automatize sinais na Binance Futures e na Bybit](https://pipsync.io/pt/crypto-signal-copier)
- [Gestão de risco no servidor — regras de trading aplicadas antes do seu broker](https://pipsync.io/pt/server-side-risk-management)
- [Copiador de sinais sem VPS — a execução roda na nuvem](https://pipsync.io/pt/signal-copier-no-vps)

---

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.