Tópicos
    Como usar e configurar o trading com sinal de webhook na Bybit
    bybit2025-07-10 14:23:31
    Guia Passo a PassoPerguntas Frequentes

    Isenção de responsabilidade: Este artigo é uma tradução preliminar em Português criada com ajuda de ferramentas de tradução automática. Uma versão aprimorada e atualizada estará disponível em breve.




    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.







    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.

    • Defina o capital inicial do saldo da sua conta Bybit
    • 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

    símbolo

    {{ticker}} do TradingView

    O símbolo do alerta

    lado

    • {{strategy.order.action}} do TradingView

    • ENTER_LONG

    • SAÍDA_LONG

    • ENTER_SHORT

    • SAÍDA_FONTE

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

     

    O lado do Tradingview significa que não há direção de trading fixa. As ordens serão enviadas com base na direção da estratégia do tradingview.

     

    tempo_disparo

    {{timenow}} do TradingView

    Este é o horário do alerta acionado. Você não precisa fazer alterações neste parâmetro.

    strategy_id

    Criado pela Bybit após o acionamento do sinal

    A ID da estratégia deste alerta de webhook

    valor_tipo

    • absoluta.quantidade

    • posição.porcentagem

    • Você pode escolher o tipo de valor na página de configurações do Webhook ou editar o valor do parâmetro diretamente do modelo colado no Tradingview.

    • O tipo de valor é Opcional e o padrão é Valor absoluto (value=absolute.quantity).

    • Valor absoluto significa que o webhook enviará sua ordem com base na quantidade configurada.

    • A seleção de % da posição (value=position.percentage) só está disponível para a ordem de saída. Ele fecha sua posição com base na porcentagem selecionada da posição aberta.

     

    quantidade

    • strategy.order.contracts

    • Quantidade do contrato

    • porcentagem da posição

    • Se a quantidade definida for {{strategy.order.contracts}}, o Webhook enviará sua ordem com base nas configurações do Tradingview.

    • Você também pode inserir uma quantidade específica no próprio modelo e isso substituirá o sinal original. Tome o BTC como exemplo, se você definiu "quantidade": "1". Para contratos USDT/USDC, 1 contrato é igual a 1 BTC. Para Contrato Inverso, 1 contrato é igual a 1 USD.

    • Se o tipo de valor selecionado for a porcentagem da posição, a quantidade definida será a porcentagem da posição que você deseja fechar, variando entre [0,01, 100] em %. A porcentagem de fechamento é sempre baseada no tamanho da posição no acionamento.

    preço

    Disparar preço da estratégia de tradingview

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

    max_lag

    Valor inteiro não negativo entre [5, 300].

    Esta é a latência máxima do sinal que você pode aceitar. Por padrão, ele é definido como 20 segundos. Se a latência estiver além do que você definiu, o webhook não enviará as ordens.

     

     

     

     

     

     

    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 TPL/SL se quiser configurar um.

    • Tipo de ordem: Você pode definir a ordem a mercado ou a ordem limitada. Assim que o alerta for acionado, a respectiva ordem será enviada. Para ordens limitadas, você precisará definir uma distância a ser acionada como o preço da ordem limitada.

      • Long: Preço limite = Preço de acionamento do sinal × (1 - distância até o acionamento)

      • Short: Preço limite = Preço de acionamento do sinal × (1 + distância para acionamento)

    • TP/SL: A ordem TP/SL será enviada com a execução da ordem de entrada (a ordem de saída não é suportada). As quantidades de take-profit e stop-loss são baseadas no tamanho de cada sinal. Você pode definir TP ou SL e, assim que a ordem for enviada, você pode editar o preço de acordo com sua preferência na guia posição. Seus preços são calculados com base no preço de entrada desse sinal.

      • Preço de acionamento do TP Long: Preço de entrada do sinal × (1 + % de variação de preço)

      • Preço de acionamento do TP Short: Preço de entrada do sinal × (1 - % de variação de preço)

      • Preço de acionamento da SL Long: Preço de entrada do sinal × (1 - % de variação de preço)

      • Preço de acionamento SL Short: Preço de entrada do sinal × (1 + % de variaçã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?
    yesSimyesNão