Como usar e configurar o trading com sinal de webhook na Bybit

logo
Última atualização em 2026-03-03 18:23:38
Compartilhar

O trading com sinal de webhook na Bybit é uma ferramenta poderosa que permite o trading automatizado de contratos perpétuos e futuros usando sinais do TradingView. Ao aproveitar a funcionalidade de webhook do TradingView, os traders podem enviar solicitações para URLs específicas cada vez que um alerta for acionado, automatizando o processo de trading.


Antes de começar a usar o trading com sinal de webhook, leia as observações importantes abaixo:

– Certifique-se de estar usando uma assinatura paga do TradingView (Essential/Plus/Premium) para poder usar webhooks.

– NÃO compartilhe o URL do seu webhook com outras pessoas, pois isso pode permitir que você receba mensagens falsas/golpes ou ordens falsas feitas por outras pessoas.

– Todos os alertas do TradingView recebidos são enviados apenas em função das configurações do usuário, e a Bybit não é responsável por nenhuma perda de trading decorrente.

– Observe que pode haver riscos de perda ou atraso de sinal, pois o acionamento de sinais depende de plataformas de terceiros.

– Esse recurso está disponível exclusivamente para trading de derivativos, incluindo perpétuos de USDT, perpétuos de USDC, perpétuos inversos e futuros inversos no site oficial da Bybit e requer a existência de fundos em sua conta de trading unificado.




Nas seções a seguir, guiaremos você pelo processo passo a passo de configuração e uso do trading com sinal de webhook na Bybit. Antes de começar, certifique-se de que sua conta tenha fundos suficientes.



  1. Criar um webhook

  2. Executar uma estratégia no TradingView

  3. Visualizar detalhes do seu sinal

  4. Pausar ou encerrar o sinal de webhook

  5. Limites de ordem



Criar um webhook

1.º passo: Insira a página do contrato que você gostaria de negociar na guia Trade, clique em Ferramentas na área de ordens e, em seguida, selecione Trading com sinal de webhook.






2.º passo: Clique em Criar agora. Certifique-se de entender a visão geral desta função. Para obter mais informações sobre como executar o trading com sinal de webhook, procure assistir ao vídeo tutorial fornecido e clique em Confirmar o disposto acima.






3.º passo: Siga estas etapas para configurar seu webhook:

  1. Selecione o símbolo: escolha o símbolo desejado para o trading com webhook. Certifique-se de que esta observação corresponde ao símbolo que você está usando para a estratégia no TradingView.
  2. Modo da posição: modo unidirecional. Certifique-se de que o modo da posição para o símbolo para o qual você está executando a estratégia esteja definido como modo unidirecional, pois o trade automático para o modo da posição de hedge não está disponível.
  3. Nome do sinal: insira o nome do sinal para sua estratégia do TradingView.

Em seguida, clique em Criar webhook.

Observações:

– Certifique-se de que seu script de estratégia não dependa do modo da posição de hedge, pois o trading com sinal de webhook só está disponível para o modo da posição unidirecional.

– Observe que você precisa criar o webhook separadamente para cada par de trading.



Parabéns! O webhook foi criado com sucesso.








Executar uma estratégia no TradingView

1.º passo: Depois de criar o webhook, clique no respectivo contrato para executar uma estratégia no TradingView (se necessário).






2.º passo: Na página TradingView, clique em Testador de estratégia para carregar sua estratégia.

Observe que o trading com sinal de webhook foi projetado exclusivamente para executar estratégias e não acomoda indicadores. Para determinar se um indicador ou uma estratégia está em uso em seu gráfico, inspecione o segmento inicial do código-fonte do Pine Script. Se mostrar Estratégia, então, uma estratégia está sendo utilizada. Por outro lado, se mostrar indicador, significa que um indicador estará ativo no seu gráfico.






3.º passo: Abra as configurações e os parâmetros da sua estratégia.

  1. Defina o capital inicial do saldo da sua conta Bybit
  2. Insira a quantidade desejada por ordem. As ordens serão enviadas para você com essa quantidade após receber o sinal.

Notas:

— Para Contratos Inversos, apenas o tamanho do pedido em Contratos é suportado no momento. Inserir o tamanho do pedido em USD ou % do patrimônio pode levar à falha na colocação do pedido.

— Se você inserir o tamanho do pedido por contrato, observe que a unidade por contrato para Contrato Inverso é igual a 1 USD, enquanto para Contrato USDT ou USDC, tome BTCUSDT ou BTC-PERP como exemplo, 1 contrato é igual a 1 BTC.






4o passo: Crie o alerta de estratégia para sua estratégia.

Parâmetro

Valores

Descrição

symbol

{{ticker}} from TradingView

O símbolo do alerta

side

  1. {{strategy.order.action}} from TradingView
  2. ENTER_LONG
  3. EXIT_LONG
  4. ENTER_SHORT
  5. EXIT_SHORT

Apenas modo unidirecional é suportado. Você pode selecionar o lado para a sua ordem no menu suspenso.

O side do Tradingview significa que não há direção de negociação fixa — as ordens serão feitas com base na direção da estratégia do TradingView.

trigger_time

{{timenow}} from TradingView

Este é o momento em que o alerta foi acionado. Você não precisa fazer alterações neste parâmetro.

strategy_id

Created by Bybit upon signal trigger

O ID da estratégia deste alerta de webhook

amount_type

  1. absolute.quantity
  2. position.percentage
  1. Você pode escolher o tipo de quantidade na página de configurações do Webhook ou editar o valor do parâmetro diretamente no modelo colado no TradingView.
  2. O tipo de quantidade é Opcional e o padrão é Valor absoluto (valor=absolute.quantity).
  3. Valor absoluto significa que o webhook fará seu pedido com base na quantidade configurada.
  4. Posição % (valor=position.percentage) a seleção está disponível apenas para ordem de saída. Ele fecha sua posição com base na porcentagem selecionada da posição aberta.

quantity

  1. strategy.order.contracts
  2. Contract quantity
  3. Position percentage
  1. Se a quantidade definida for {{strategy.order.contracts}}, o Webhook fará seu pedido com base nas configurações no Tradingview.
  2. Você também pode inserir uma quantidade específica no próprio modelo e isso substituirá o sinal original. Pegue BTC como exemplo, se você definiu "quantity": "1". Para contratos lineares USDT/USDC, 1 contrato é igual a 1 BTC. Para contratos Inversos, 1 contrato é igual a 1 USD.
  3. Se o tipo de quantia que você selecionou for porcentagem de posição, a quantidade definida será a porcentagem da posição que você quer sair (para saída - Long e saída - Short), o valor flutuante estará entre [0.01, 100] em %. O nivelamento da porcentagem da posição é baseado na quantidade da última posição aberta a cada vez.

price

Trigger price from tradingview strategy

Este é o resultado do preço onde o alerta foi acionado. Você não precisa fazer alterações neste parâmetro.

max_lag

Non-negative integer value between [5, 300].

Este é o máximo de latência de sinal que você pode aceitar. Por padrão, está configurado para 20 segundos. Se a latência estiver além do que você configurou, o webhook não fará os pedidos.






5.º passo: Clique no ícone Alerta no testador de estratégia para criar um alerta para sua estratégia e cole o modelo de mensagem e o URL do webhook na janela pop-up Alerta.

Observações:

– Você pode copiar o modelo de mensagem da página da Bybit e colá-lo na caixa de mensagem na guia de configurações de alerta.



– A URL do Webhook será encontrada na página da Bybit e deve ser colada no campo URL do Webhook na guia de notificação de alerta.







6o passo: Defina seu tipo de ordem após o sinal ser acionado e TP/SL se quiser configurar um.


  1. Tipos de Ordem: Você pode definir uma Ordem de Mercado ou uma Ordem de Limite.
  2. Uma ordem de mercado é executada imediatamente após receber o sinal do TradingView.
  3. Uma ordem de limite coloca um preço especificado ao receber o sinal. Para ordens de limite, você pode definir o quão distante o preço limite é definido em relação ao preço de disparo

Uma vez que o alerta é acionado, a respectiva ordem será colocada.

  1. Ordens Long: Preço limite = Preço de disparo × (1 - porcentagem)
  2. Ordens Short: Preço limite = Preço de disparo × (1 + porcentagem)


  1. TP/SL: A ordem TP/SL será colocada com a execução da ordem de entrada (ordem de saída não é suportada). As quantidades de take-profit e stop-loss são baseadas no tamanho de cada sinal. Os preços TP (Take Profit) e SL (Stop Loss) são calculados com base no preço de disparo do sinal recebido.
  2. Para ordens Long:
  3. TP = preço de disparo × (1 + % de alteração de preço)
  4. SL = preço de disparo × (1 - % de alteração de preço)
  5. Para ordens Short:
  6. TP = preço de disparo × (1 - % de alteração de preço)
  7. SL = preço de disparo × (1 + % de alteração de preço)





7.º passo: clique em Executar o webhook.

Você configurou o trading com sinal com sucesso! Você receberá uma notificação push no seu aplicativo da Bybit ou navegador sobre o sinal da sua estratégia.








Visualizar detalhes do seu sinal

Para visualizar os detalhes específicos do sinal webhook, vá para a guia Ferramentas e selecione Webhook. Aqui, você pode visualizar o nome do sinal, tempo de acionamento/trade, P&L realizado, além da data e hora de criação.



Para ver mais detalhes do sinal, clique no botão Detalhes ao lado e você poderá revisar o URL do webhook e o modelo de mensagem. Além disso, você poderá ver o trade executado por meio dessa estratégia.



Observe que o P&L realizado exibido na guia Estratégia de webhook é o P&L realizado para os trades executados pela respectiva estratégia de webhook. Qualquer P&L derivado de trade manual feito pelos usuários não será refletido aqui.



Como alternativa, você pode ir para Histórico de ferramentas → Tipo de ferramentas, selecionar Webhook para visualizar os detalhes.








Encerrar o sinal do webhook

Encerramento ou pausa manual: para encerrar manualmente o sinal de webhook, navegue até a guia Ferramentas. Encontre o sinal iniciado pelo webhook que deseja encerrar e clique em Encerrar. Por outro lado, se quiser interromper temporariamente a estratégia, clique em Pausar.




Encerramento automático: o sinal de webhook pode ser automaticamente encerrado por vários motivos:

  1. Se ocorrerem 10 falhas consecutivas de ordens, a estratégia será encerrada.
  2. Se o tipo de contrato selecionado não for suportado no TradingView.
  3. Parâmetros de ajuste incompletos podem levar ao encerramento automático.
  4. Se for selecionado um modo da posição não suportado (modo hedge).
  5. Se o contrato futuro selecionado estiver próximo da data de entrega.
  6. Você atingiu o número máximo de estratégias de webhook que podem ser criadas. Cada símbolo pode ter 5 estratégias de webhook sendo executadas simultaneamente, e cada UID pode ter um máximo de 30 estratégias de webhook executadas ao mesmo tempo.
  7. Sua conta está restrita.








Limites de ordem

Observe que a ordem enviada por meio da estratégia de webhook está sujeita a todos os limites da ordem de trade manual em trading de perpétuos e de futuros, incluindo o tamanho mínimo ou máximo da ordem, limites de preço de contrato e muito mais.

Sua ordem pode não ser enviada via estratégia de webhook devido aos seguintes motivos:

Mensagem de erro

Explicação

A ordem falhou devido ao atraso do sinal.

O sinal transmitido está atrasado e pode se desviar da sua estratégia se a ordem for enviada e executada. Portanto, a ordem foi cancelada.

A ordem falhou devido a um símbolo inválido.

O par de trading declarado na estratégia não está disponível ou foi removido da listagem na Bybit.

A ordem falhou devido a parâmetros ausentes. Copie e use o modelo de mensagem novamente.

O conjunto de parâmetros não está completo, execute novamente um webhook.

A ordem foi cancelada devido à insuficiência do saldo disponível.

Você não tem margem suficiente para enviar a ordem. Anexe fundos adicionais à sua conta de trading unificado.

A ordem falhou devido a não correspondência do modo da posição.

O trading com sinal de webhook é suportado apenas para um modo da posição unidirecional. O modo da posição foi alterado para o modo hedge e a ordem enviada não foi executada.

A ordem falhou pois o limite de risco foi excedido.

O limite de risco excederá o nível atual definido se a ordem for enviada. Você pode ajustar seus limites de risco a partir das preferências de trading.

Apenas ordens de reduce-only podem ser enviadas para contratos que estão próximos da entrega.

O contrato futuro está se aproximando da data de entrega e, portanto, nenhuma ordem em aberto pode ser enviada.

A ordem falhou pois o limite de posições em aberto foi excedido.

O limite de posições em aberto será excedido se a ordem for enviada.


Foi útil?