Multi-symbol 3 modes Optional signal check

TradingView integration —
Your Pine Scripts, traded automatically

FuturesBot turns your TradingView alerts into real trades on Kraken, Bybit and Bitget. Two supplied Pine Scripts (v11 Master + v12.4 Precision) are included in the download — or use your own scripts. Risk management, stop-loss, stop trailing and partial sales run automatically in both ways. Multi-symbol works on all 3 exchanges.

🚀 Two Pine Scripts (v11 Master + v12.4 Precision) included in the bot download

📈 View older versions on TradingView →

Try free for 14 days → View all features

📈 TradingView

What is the TradingView integration?

FuturesBot starts an integrated Webhook server, which receives TradingView alerts, validates them and executes them in real time on Kraken, Bybit or Bitget. Your Pine Script sends a JSON signal — the bot does the rest.

Works with any Pine Script, which can send JSON webhooks. Locally, the server listens on port 5000 (adjustable). TradingView sends webhooks only to port 80 or 443 — for this you need a reverse proxy (e.g. nginx, Caddy), a tunnel or port forwarding. Token/secret protection cannot be used in the current version; protect the endpoint via reverse proxy or firewall.

No intermediary cloud service. The webhook server runs directly on your system — full control over your signals and trades.

Example display with fictitious values — not a real signal, not a result

--- Webhook flow ---

1. TradingView alert fires
→ POST https://dein-server/webhook (port 443 → reverse proxy → local 5000)

2. Webhook server receives JSON
→ {"signal":"long","symbol":"ETH","price":3421.5,"timeframe":"5"}

3. Signal check (bundled Pine Scripts)
→ Format ✓ Dedup ✓ Timeframe ✓ Risk ✓
→ Quality-Score + Regime-Check (adjustable)

4. Execution on Kraken / Bybit / Bitget
→ LONG 2.5 ETH @ $3,421
→ Trailing stop activated
→ Smart Profit Management active

3 modes — Your trading, your rules

Decide for yourself how much control you give the bot. From full Pine Script autonomy to an additional review layer.

⚡

Raw Execution

Direct execution without the bot's signal checks (no trend, RSI, regime, cooldown or timeframe filter); the price deviation check and paper mode remain active according to the configuration. For traders who trust their Pine Scripts 100% — higher risk of loss, every entry signal becomes a trade.

All protection systems remain active:

Trailing stop, Smart Profit Management, stop-loss on the exchange — also active with Raw Execution (not a reliable protection against losses).

TV_RAW_EXECUTION=true

Target

Confluence (full version only)

The trade is only executed if the TradingView signal and the bot strategy point in the same direction — fewer signals are executed. Confluence scoring with timeframe weighting.

How it works:

Your Pine Script says long + bot strategies say long = trade is executed. Contradiction = no trade.

TRADINGVIEW_USE_AS_CONFLUENCE=true

Shield

Filters (full version only)

TradingView signals block conflicting bot trades. Your Pine Script acts as an additional checking layer — the bot trades only if TradingView does not contradict.

Your script as veto right:

The bot wants long, your script says short? The trade is blocked. No contradiction? The trade runs.

TRADINGVIEW_USE_AS_FILTER=true

NEW 🧠 Smart Side Detection

Smart Side Detection — Trend protection block in unsuitable market conditions

Pine Scripts sometimes send signals into a clearly unsuitable market situation — classic example: an entry at an extreme position within a range. Smart Side Detection recognizes such constellations automatically and blocks the signal, instead of executing it blindly. Signals are never flipped into the opposite direction — they run in the original direction or not at all.

Multi-level trend score

A proprietary trend score made of EMA structure, momentum and RSI zone evaluates the current market direction. The exact factors and thresholds are part of the engine.

Block only in clearly unsuitable conditions

Only when the market situation clearly speaks against the signal (e.g. range extreme position) is it blocked. In an unclear trend, the original signal runs unchanged — conservative and traceable.

The original direction is always preserved

Your signal is executed or skipped — never reversed. You keep full control over which direction your strategy trades.

Works with any Pine Script

Also with community scripts that have not been specifically adapted for FuturesBot. The bot checks the market situation independently of the script.

The goal: Block entries when, according to the configured rules, the market situation clearly speaks against the signal. Your Pine Script supplies direction and entry timing — Smart Side Detection checks whether the market situation allows the entry.

Example display with fictitious values — not a real signal, not a result

--- Signal from Pine Script ---
Symbol: BTC/USD
Signal: SHORT (RSI overbought)

--- Smart Side Detection ---
Check trend score:
✓ EMA structure bullish
✓ Momentum bullish
✓ RSI in a healthy range
Range position: Extreme zone

⚡ Unsuitable market situation detected
⛔ Signal blocked — no trade

--- Result ---
→ No entry against the market conditions
→ Next signal is checked normally

Conservative by default: If the trend is unclear, nothing blocked — the Pine Script retains full control. Only clearly unsuitable market conditions are skipped.

🔀 Multi-symbol

Multi-Symbol Trading — 17 symbols at the same time

Without TradingView

1 symbol

(ACTIVE_SYMBOL)

→

With TradingView

ALL 17 symbols

Symbol from the signal

17 markets, one bot, no manual switching

Your Pine Script sends alerts for BTC, ETH, SOL, XRP and all other symbols — the bot trades the symbol from the incoming signal in each case. Each symbol has its own trailing-stop levels, adapted to the respective volatility. Multi-symbol works on all 3 exchanges (Kraken, Bybit, Bitget).

Automatic symbol detection

Your Pine Script sends a BTC signal, then an ETH signal — the bot recognizes the symbol from the signal and uses its parameters. No manual switching needed.

Optional symbol restriction

With TV_MULTI_SYMBOL_LIST in the .env you specify exactly which symbols may be traded (empty = all trading symbols). Everything else is ignored — full control.

🆕 Multiple symbols at the same time

In the delivered .env there are three trading profiles (Single / Multi-Symbol / Multi-3). The one delivered is Profile B (multi-symbol) for all exchanges (technical starting value, not a recommendation): the bot scans the symbols of the scan list in turn (at most 6) using its own strategies — combinable with TradingView alerts, shared position budget. Switch: MULTI_SYMBOL_ENABLED + MULTI_SYMBOL_SCAN_LIST + MAX_CONCURRENT_SYMBOLS.

Example display with fictitious values — not a real signal, not a result

--- Multi-symbol active ---
Allowed: BTC, ETH, SOL, XRP, DOGE, ADA, LINK, BNB, AVAX, SUI, TAO, XAUT, ZEC, WIF, XMR, HYPE, XLM

--- Signal 1 ---
Symbol: ETH/USD
Action: LONG
→ Trade on ETH/USD (symbol from the signal)
→ Trailing adjusted (ETH volatility)
→ LONG 2.5 ETH @ $3,421

--- Signal 2 ---
Symbol: SOL/USD
Action: SHORT
→ additional position on SOL/USD (ETH continues)
→ SHORT 40 SOL @ $142

# config/tradingview_config.py (as shipped)
TV_MULTI_SYMBOL = True
# config/.env (optional, empty = all trading symbols)
TV_MULTI_SYMBOL_LIST=ETH/USD,BTC/USD,SOL/USD

Signal check — active by default, tuned to the supplied Pine Scripts

The strategic signal check (quality score, regime check) is matched to the bundled Pine Scripts (v11 Master + v12.4 Precision) and switched on by default. For your own or third-party Pine Scripts, you switch the check off in the configuration — the signals are then adopted directly; risk management, stop trailing and partial sales remain active.

Box

With the bundled Pine Scripts (v11 Master + v12.4 Precision)

Signal check is active by default. It knows the JSON fields of these scripts (qscore, ATR, regime, Confluence). Which signals it accepts and which it does not is shown to you by paper mode in the log.

In config/tradingview_config.py (on first start, from bin/config_template/ created): enabled: True

🛠️

With your own or third-party Pine scripts

Set the signal check to "off" yourself (by default it is set to "on"). The signals are adopted directly — risk management, stop-loss, trailing stop and Smart Profit Management remain fully active.

In config/tradingview_config.py: enabled: False (set it yourself)

What the check brings along (when the mode is switched on)

Format check

Is the JSON valid? Does it contain all required fields (signal, symbol, price)? Invalid payloads are discarded immediately.
Dedup check

Cooldown between identical signals. Blocks duplicate trades caused by alerts that fire multiple times.
Timeframe check

Plausibility check of the timeframe; maximum timeframe configurable.
ATR and volatility floor

Signals with too small a movement range are filtered out (tiny-move protection, against fee erosion).

Quality score

Minimum quality level from the Pine Script (qscore). Threshold configurable.
Regime check

Does the market phase match the signal? A long signal in a strong downtrend is questioned.
Symbol/side filter

Blacklist per symbol+direction — BTC long is blocked by default (symbol_side_blacklist); further combinations can be excluded.
Risk check (always active)

Final check: position size, leverage (MIN/MAX/DEFAULT), available margin. Also runs when the signal check is switched off.

Important: The strategic filters are tailored to the supplied Pine Scripts. With third-party scripts, the check would filter based on wrong assumptions. Therefore: third-party scripts → check off, the bot takes over the signals directly and handles them with its full protection stack.

🔧 Setup

Setting up the webhook — in 4 steps

Step by step from your own Pine Script to the first automated trade – in paper mode first.

Step 1: Start the bot

FuturesBot starts the webhook server automatically on port 5000. No extra configuration needed — simply TRADINGVIEW_ENABLED=true set and start.

Step 2: Make the port reachable

TradingView only sends to port 80 (HTTP) or 443 (HTTPS). Forward this via reverse proxy (nginx, Caddy), tunnel or port forwarding to the local port 5000. Token protection is currently not usable – protect the endpoint via reverse proxy or firewall.

Step 3: Create a TradingView alert

In TradingView: create alert → enter webhook URL → configure JSON payload. Done — from now on your script sends signals automatically.

Step 4: Test

Activate paper trading mode and trigger the first alert. In the bot log you can see every step of the validation — so you know immediately whether everything works.

--- JSON Format ---

{
"signal": "long",
"symbol": "ETH",
"price": 3421.5,
"timeframe": "5"
}

--- Signal aliases ---
Long: "buy", "go_long", "enter_long", "long"
Short: "sell", "go_short", "enter_short", "short"
Close: "exit", "close", "flat", "close_all"
Close signals are accepted but do not close any position — exits are controlled by the bot.

--- Symbol aliases ---
Bitcoin "BTCUSDT", "XBTUSD", "BTC/USD", "Bitcoin"
ETH "ETHUSDT", "ETHUSD", "ETH/USD", "ETH"
Sun "SOLUSDT", "SOLUSD", "SOL/USD", "SUN"
XRP "XRPUSDT", "XRPUSD", "XRP/USD", "XRP"
DOGE: "DOGEUSDT", "DOGEUSD", "DOGE/USD", "DOGE"
ADA: "ADAUSDT", "ADAUSD", "ADA/USD", "ADA"
LINK: "LINKUSDT", "LINKUSD", "LINK/USD", "LINK"
BNB: "BNBUSDT", "BNBUSD", "BNB/USD", "BNB"
AVAX: "AVAXUSDT", "AVAXUSD", "AVAX/USD", "AVAX"
SUI: "SUIUSDT", "SUIUSD", "SUI/USD", "SUI"
TAO: "TAOUSDT", "TAOUSD", "TAO/USD", "TAO"
XAUT: "XAUTUSDT", "XAUTUSD", "XAUT/USD", "XAUT"
ZEC: "ZECUSDT", "ZECUSD", "ZEC/USD", "ZEC"
WIF: "WIFUSDT", "WIFUSD", "WIF/USD", "WIF"
Other symbols (XMR, HYPE, XLM) in the format "<SYMBOL>USD"

Pine Scripts — get started right away

Two scripts are included in the bot download (v11 Master + v12.4 Precision). Or use your own scripts — then you turn the signal check off.

🚀

Included in the bot

Included Pine Scripts (v11 Master + v12.4 Precision)

Developed specifically for FuturesBot. The signal check in the bot is tailored to the JSON format of these scripts (Quality-Score, regime, Confluence). No profit guarantee - like any signal source, check it in paper mode first.

Included in the download ✓

🛠️

Custom Pine Scripts

Write your own strategies in Pine Script. Signal check in tradingview_config.py on enabled: False set (by default it is True) — signals are taken over directly, the risk/protection stack continues to run in full.

signal → action → side
symbol → ticker → instrument

🌍

TradingView Community

Thousands of community scripts with webhook support. Any script that can send JSON alerts works with FuturesBot — then leave the signal check set to “off”.

Browse scripts →

20+ field aliases: Whether your script uses signal, action or side used — FuturesBot understands them all. The same applies to symbol, ticker, instrument and many more.

Configuration at a glance

Two levels: simple switches in the .env for a quick start — and fine-grained control in tradingview_config.py for professionals.

.env — Simple switches

TRADINGVIEW_ENABLED=true/false

Switch TradingView integration on/off

TRADINGVIEW_WEBHOOK_PORT=5000

Port for the webhook server (default: 5000)

TV_RAW_EXECUTION=true/false

Direct execution without the bot's signal checks (false by default)

TV_MULTI_SYMBOL=true/false

Accept signals for all trading symbols (found in tradingview_config.py, True by default)

MULTI_SYMBOL_ENABLED=true (Default)

Bot strategies scan several symbols in turn. Profile B is activated in the .env (scan list by default: ETH/BTC/SOL/ADA).

MAX_CONCURRENT_SYMBOLS=3 / MAX_CONCURRENT_POSITIONS=4

Default setting (Profile B): up to 3 different symbols open at the same time, up to 4 positions in total (pyramiding adds do not count extra). Adjustable.

TRADINGVIEW_USE_AS_FILTER=true/false

Use TV signals as a veto filter (full version only; environment variable, true by default, not contained in the delivered .env)

TRADINGVIEW_USE_AS_CONFLUENCE=true/false

Use TV signals as a confluence confirmation (full version only; environment variable, true by default, not contained in the delivered .env)

tradingview_config.py — Fine-tuning

TV_VALIDATOR_CONFIG

Signal check (on by default): timeframe upper limit, minimum ATR per direction, minimum quality score (0–6), blocks per symbol/direction (by default BTC long) and per signal type

TV_MAX_HOLD_BY_TIMEFRAME

Maximum holding time of TradingView trades per timeframe

TRADINGVIEW_DIRECT_TRADE_* / TRADINGVIEW_WEEKEND_MIN_CONFIDENCE

Direct-Trade rules (minimum confidence, cooldown, maximum price deviation, trend condition) and the minimum confidence at the weekend

TRADINGVIEW_MIN_CONFIDENCE

Minimum confidence of a TV signal for filter/confluence (full version only, 0.6 by default). Signal buffer and quality ratings are internal values, not part of the customer configuration.

TradingView + FuturesBot — 14 days free

The complete TradingView integration is included in the trial. Paper trading mode active by default — test with real market data without real money (simulated).

Try free for 14 days → View all features

The chat bubble emoji.

Questions? Our AI helps you!

Our AI support assistant is usually around the clock available (voluntary additional service with a daily limit) — right here on the page (💬 bottom right). It helps with setup, configuration, strategies, TradingView setup, server installation and more.

📋 Search the FAQ ✉️ Email support

AI chat + FAQ answer many questions instantly. Email for everything else.

⚠️ Risk notice: FuturesBot is a technical analysis and automation tool — not a financial product, no investment advice, no investment recommendation, no asset management. You determine the signal source, leverage and stake yourself. Past results are no guarantee of future performance. Crypto futures trading involves considerable risks of loss and can lead to total loss; stop-loss and protection features do not reliably limit losses (price gaps, slippage, liquidation). No profit guarantee; simulated results are not an indication of future results either. Check every setting thoroughly in paper mode first. Full risk notice →