WCWebLib

Biblioteca Pine Script para construção de payloads JSON padronizados para webhooks do TradingView: BUY, SELL, TP e SL com estrutura configurável.

Tipo: Biblioteca (library) Categoria: Webhooks e Alertas Fonte: TradingView Script

Visão geral

WCWebLib é uma biblioteca para construção de mensagens JSON padronizadas para envio via webhooks do TradingView. Ela abstrai a formatação do payload, garantindo que os alertas enviados para bots ou exchanges sigam sempre a mesma estrutura.

Problema que resolve: Construir strings JSON manualmente em Pine Script é propenso a erros de formatação. WCWebLib encapsula essa construção em funções tipadas.

Como funciona

Estrutura do payload

{
  "action": "BUY",
  "symbol": "BTCUSDT",
  "price": 50000.00,
  "quantity": 0.01,
  "tp": 52000.00,
  "sl": 49000.00,
  "comment": "EMA crossover signal"
}

Fluxo de envio

WCWebLib.buildBuyOrder(...)
         ↓
Retorna string JSON formatada
         ↓
alert(json, alert.freq_once_per_bar_close)
         ↓
TradingView envia HTTP POST para URL do webhook
         ↓
Bot/Exchange processa a ordem

API / Funções

Função	Parâmetros	Retorno	Descrição
`buildBuyOrder()`	`symbol`, `price`, `qty`, `tp`, `sl`	`string`	JSON de compra
`buildSellOrder()`	`symbol`, `price`, `qty`, `tp`, `sl`	`string`	JSON de venda
`buildTPAlert()`	`symbol`, `tp_level`, `qty`	`string`	JSON de take-profit atingido
`buildSLAlert()`	`symbol`, `sl_price`, `qty`	`string`	JSON de stop-loss atingido
`buildCustom()`	`action`, `params`	`string`	JSON com campos customizados

Exemplo de uso

//@version=6
strategy("WCWebLib — Automação de Ordens", overlay=true)

import author/WCWebLib/1 as wc

atr = ta.atr(14)
longSignal  = ta.crossover(ta.ema(close, 10), ta.ema(close, 30))
shortSignal = ta.crossunder(ta.ema(close, 10), ta.ema(close, 30))

if longSignal
    entry = close
    tp    = close + atr * 2.0
    sl    = close - atr * 1.0

    // Construir payload JSON
    msg = wc.buildBuyOrder(syminfo.ticker, entry, 0.01, tp, sl)

    // Enviar via webhook do TradingView
    alert(msg, alert.freq_once_per_bar_close)
    strategy.entry("Long", strategy.long)

if shortSignal
    msg = wc.buildSellOrder(syminfo.ticker, close, 0.01, na, na)
    alert(msg, alert.freq_once_per_bar_close)
    strategy.close("Long")

Configuração do webhook no TradingView

No TradingView, crie um alerta no script
No campo "Webhook URL", insira a URL do seu bot
No campo "Mensagem", use {{strategy.order.alert_message}}
O JSON construído pelo WCWebLib será enviado automaticamente

Integrações

Script	Como combinar
AlertSenderLibrary	AlertSender para payloads mais complexos (20 campos)
LevelsManager	Enviar alerta para cada TP atingido
LiveTracker	Disparar webhook quando MTM atinge limiar

Limitações

Limitação	Impacto
Formato de payload fixo	Bots com formato diferente precisam de adaptação
Sem autenticação no payload	Implementar token de segurança manualmente no campo `comment`
Alertas do TradingView têm delay de até 10 segundos	Não adequado para scalping de alta frequência

Aviso Legal: Conteúdo educativo. Não constitui recomendação de investimento. Resultados passados não garantem resultados futuros.

WCWebLib

On this page