Webhook para Binance — o JSON chega como sinal registrado

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.

Qualquer programa, script, backtester ou bot que consiga fazer um POST HTTPS pode enviar sinais para a PipSync, porque ela se importa apenas com o corpo JSON, não com a origem. 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 Binance Futures, por enquanto, e sinais do Telegram e do Discord continuam sendo executados.

1. 1

   Crie sua conta no 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. 2

   Contas de destino

   Sinais do Telegram e do Discord são executados na Binance Futures. 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 Binance 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. 3

   Configure a sua fonte de webhook personalizado

   No PipSync, gere a URL do webhook em Configurações → Avançado → Alertas do TradingView. Ela contém um token secreto e é mostrada uma única vez; trate esse token como a credencial e rotacione-o no painel se suspeitar de um vazamento.

4. 4

   Monte o payload JSON

   Faça o seu sistema enviar via POST um JSON simples com instrument (o nome exato do contrato na Binance), direction (buy ou sell), entry, sl e tp1. Use preços absolutos para sl e tp1, ambos maiores que 0; o alerta não define o tamanho.

5. 5

   Revise os sinais na página Sinais

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

6. 6

   Verifique em Alertas recentes

   Dispare um payload e confira em Alertas recentes (Configurações → Avançado → Alertas do TradingView) se o PipSync o interpretou corretamente; cada sinal aguarda a sua confirmação na página Sinais.

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

Um webhook para a Binance Futures precisa de um único objeto JSON simples que o PipSync transforma em um sinal. Não há estruturas aninhadas nem campos específicos da Binance para aprender; você envia um corpo pequeno e previsível e o PipSync cuida da tradução.

Os campos são diretos, e o tamanho do lote não faz parte deles.

• instrument: deve corresponder ao nome exato do contrato na Binance para USD-M ou COIN-M
• direction: "buy" ou "sell"
• entry: preço de entrada
• sl e tp1: preços absolutos, ambos maiores que 0
• tamanho: não vai no payload
• texto simples: sempre salvo como sinal para a sua aprovação; envie JSON

A diferença é que esta rota é agnóstica à fonte: qualquer sistema capaz de fazer um POST HTTPS pode enviar sinais para a PipSync, não apenas alertas do TradingView. O PipSync lê o corpo JSON e não se importa se ele veio de um script Python, de um backtester, de um cron job, de uma automação no-code ou de um bot personalizado.

Os webhooks do TradingView também exigem um plano pago do TradingView, enquanto um webhook personalizado não tem essa dependência. Se a sua estratégia mora no seu próprio código ou em outra plataforma, um webhook JSON personalizado costuma ser o encaixe mais limpo, e o formato do payload é idêntico, então você pode migrar nos dois sentidos sem reescrever a sua lógica.

Há também uma diferença na execução: só os alertas que o próprio TradingView envia, a partir dos endereços de envio publicados por ele, podem operar automaticamente, e só depois que você ativar o recurso no plano Advanced. Um webhook do seu próprio sistema sempre é salvo como sinal para a sua aprovação. Na Binance, por enquanto, nem mesmo os alertas do TradingView são operados automaticamente, porque o risco de uma operação de cripto não pode ser medido nas contas conectadas pelo gateway.

Alavancagem e liquidação são regidas pela Binance, não pelo PipSync. Nas rotas de Telegram e Discord, o PipSync coloca ordens na sua conta, mas a sua configuração de alavancagem, o modo de margem e o preço de liquidação são determinados pelo motor de futuros da Binance e pelo contrato que você opera.

Como a Binance Futures é um produto alavancado, as perdas podem exceder a sua margem inicial e as posições podem ser liquidadas. O SL/TP do sinal e o dimensionamento por risco ajudam você a expressar o risco por trade, mas não eliminam o risco subjacente de liquidação. Dimensione as posições de forma conservadora e trate os stop-losses como controles de risco, não como garantia de um preço de saída exato durante mercados rápidos ou ilíquidos.

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.

Para sinais do Telegram e do Discord executados na Binance, como feedback de execução, o PipSync envia webhooks de saída assinados para eventos como trade.opened, trade.closed, tp_hit e sl_hit, cada um carregando uma assinatura HMAC-SHA256 no header X-PipSync-Signature e com até cinco novas tentativas com backoff. Uma API REST de leitura (GET /v1/signals e GET /v1/trades, documentada na especificação OpenAPI 3.1) está disponível no plano Enterprise, e o painel mostra cada sinal e ordem interpretados em todos os planos.

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

O seu remetente deve recuar e adicionar jitter para que as novas tentativas não cheguem todas no mesmo instante.