Home  ›  SignalPipe  ›  Documentation  ›  How It Works

How It Works

How SignalPipe Works

SignalPipe connects TradingView to Capital.com through a four-step execution pipeline. Every step is automated -- once configured, no manual intervention is required.

The Execution Flow

Step 1: Signal Detection

The vyn premium Pine Script strategy runs on your TradingView charts, monitoring price action across your selected instruments. When the strategy's technical analysis detects a buy or sell condition, it fires an alert.

Step 2: Webhook Delivery

TradingView sends an HTTP POST request to the Blockresearch SignalPipe endpoint. The webhook payload contains:

FieldDescriptionExample
tickerThe instrument epicAAPL or GOLD or EURUSD
actionBuy or sellbuy
quantityPosition size (units)10
pointerYour unique authentication tokena7f3...
prev_positionPrevious position stateflat or long
The webhook URL format is:
https://europe-west3-blockalgo-quant.cloudfunctions.net/capitalWebhook

Step 3: Authentication and Processing

SignalPipe receives the alert and performs the following checks in order:

  1. Pointer authentication -- Looks up the user by their unique webhook pointer (stored as signalPipeSecret in the database). If no matching user is found, the request is rejected.
  2. Subscription check -- Verifies that the user has an active SignalPipe or vyn premium subscription. Without an active subscription, signals are logged but skipped.
  3. Automation check -- Verifies that the user has Capital.com connected and automation enabled. If either is off, the signal is logged but skipped.
  4. Session creation -- Creates a new Capital.com API session using the user's stored encrypted credentials. Capital.com uses session-based authentication with CST and security tokens.
  5. Action routing -- Routes to the buy handler or sell handler based on the action field.

Step 4: Order Execution on Capital.com

The appropriate handler places orders on your Capital.com account:

  • Buy signals open new positions or add safety order sub-positions to existing deals
  • Sell signals close all sub-positions for the instrument and record realized P&L

All buy orders are placed as market orders for immediate execution. Take-profit levels are set directly on the position via Capital.com's position modification API.

Important: SignalPipe always returns HTTP 200 to TradingView, even when an error occurs internally. This prevents TradingView from retrying alerts, which could cause duplicate orders. All errors are logged to the activity log on your dashboard.

This is a static view of a single section. For full search and interactivity visit the docs app. Open interactive docs →