AlertSenderLibrary (TradingFinder)

Biblioteca Pine Script avançada para envio de alertas com até 20 parâmetros configuráveis: OHLC, preço de entrada, take-profits, stop-loss e timestamp para automação completa.

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

Visão geral

AlertSenderLibrary é a biblioteca de alertas mais completa da coleção, suportando até 20 parâmetros em cada payload de alerta — incluindo dados OHLC da barra atual, preço de entrada, múltiplos TPs, SL, timestamp e campos customizados.

Diferença da WCWebLib: WCWebLib oferece simplicidade com 5–6 campos. AlertSenderLibrary oferece controle granular sobre cada campo do payload para integrações avançadas.

Estrutura do payload completo

{
  "symbol":    "BTCUSDT",
  "exchange":  "BINANCE",
  "action":    "BUY",
  "timeframe": "1h",
  "timestamp": 1704067200000,
  "open":      49000.00,
  "high":      50200.00,
  "low":       48800.00,
  "close":     50000.00,
  "volume":    1234.56,
  "entry":     50000.00,
  "tp1":       51500.00,
  "tp2":       53000.00,
  "tp3":       55000.00,
  "sl":        49000.00,
  "risk_pct":  2.0,
  "qty":       0.01,
  "comment":   "EMA crossover — bullish alignment",
  "version":   "2.1",
  "custom1":   "MY_SIGNAL_ID"
}

API / Funções

Função	Parâmetros	Retorno	Descrição
`build()`	`AlertParams`	`string`	Constrói o JSON completo
`send()`	`AlertParams`, `freq`	—	Constrói e dispara o alerta
`quickBuy()`	`entry`, `tp`, `sl`	`string`	Atalho para alerta de compra
`quickSell()`	`entry`, `tp`, `sl`	`string`	Atalho para alerta de venda

Objeto `AlertParams`

Campo	Tipo	Obrigatório	Descrição
`action`	`string`	✅	"BUY", "SELL", "CLOSE", "TP1", "SL"
`entry`	`float`	✅	Preço de entrada
`sl`	`float`	✅	Stop-loss
`tp1`	`float`	—	Take-profit 1
`tp2`	`float`	—	Take-profit 2
`tp3`	`float`	—	Take-profit 3
`qty`	`float`	—	Quantidade (em moeda base)
`risk_pct`	`float`	—	Risco em % do capital
`comment`	`string`	—	Comentário livre
`custom1`	`string`	—	Campo customizável

Exemplo de uso

//@version=6
strategy("AlertSender — Payload Completo", overlay=true)

import TradingFinder/AlertSenderLibrary/1 as als

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

if longSignal
    params = als.AlertParams.new(
        action   = "BUY",
        entry    = close,
        sl       = close - atr,
        tp1      = close + atr * 1.5,
        tp2      = close + atr * 3.0,
        tp3      = close + atr * 5.0,
        qty      = 0.01,
        risk_pct = 1.0,
        comment  = "EMA crossover — " + syminfo.ticker,
        custom1  = str.tostring(bar_index)
    )

    // Enviar uma vez por barra fechada
    als.send(params, alert.freq_once_per_bar_close)
    strategy.entry("Long", strategy.long)

Integrações

Script	Como combinar
WCWebLib	WCWebLib para casos simples; AlertSender para integrações avançadas
LevelsManager	Enviar TP1/TP2/TP3 como campos separados no payload
LiveTracker	Disparar alerta quando cada TP parcial for atingido

Limitações

Limitação	Impacto
Payload com 20 campos pode exceder limite de string do Pine	Testar em scripts com outros strings volumosos
Delay de até 10 segundos nos alertas TradingView	Não adequado para HFT ou scalping agressivo
Sem autenticação nativa	Usar campo `custom1` para HMAC ou token de segurança

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