Documentation

Getting Started

Everything you need to backtest strategies, automate trading, and track performance with Backpulse.

Quick Start

What is Backpulse?

Backpulse is a backtesting and trading automation platform for TradingView traders. Connect your Pine Script strategy via webhook — Backpulse validates the signal, calculates position size, and sends real orders to your exchange in under 300ms. It also provides Bayesian & Brute Force parameter optimization and a pre-built strategy library.

What do I need to get started?

You need: (1) A Backpulse account (free forever), (2) A TradingView Pine Script v5 strategy with alerts, (3) An exchange API key with Trade permission only — never enable Withdraw.

How long does setup take?

Usually under 10 minutes: sign up → go to Hub → create a Provider (connect exchange) → add a Route for your trading pair → copy the Webhook URL → paste into your TradingView alert with the JSON payload.

Does Backpulse support Google login?

Yes. You can sign up and log in with your Google account (OAuth). Sessions last 7 days so you won't need to re-authenticate frequently.

Browser Extension

What is the Backpulse browser extension?

The Backpulse extension (free) installs into Chrome, Opera, or Firefox and lets you optimize TradingView strategy parameters directly from your browser — no account required. Open any TradingView chart with a Pine Script strategy, click the Backpulse icon, configure parameter ranges, and run Bayesian or Brute Force optimization without leaving the page.

Which browsers are supported?

Chrome (Chrome Web Store), Opera (Opera Add-ons), and Firefox (Mozilla Add-ons). Cốc Cốc and Safari are on the roadmap.

Do I need a Backpulse account to use the extension?

No account is needed for basic parameter optimization. The extension works standalone right after install. If you sign in with your Backpulse account inside the extension, optimization results sync to the cloud and are accessible from any device.

How is the extension different from cloud backtest on the web?

The extension runs inside your browser — fast to start, free, no server required. Cloud backtest runs on Backpulse servers with headless Chromium — supports multiple parallel parameters, multiple symbols per job, long-term history, and runs without keeping your machine on. Use the extension for quick experiments; cloud backtest for large-scale optimization.

Backtesting & Optimization

How does backtesting work?

Backpulse runs a headless Chromium browser to open your TradingView chart, iterates over parameter combinations, and reads Net Profit, Drawdown, Win Rate, and Profit Factor directly from the Strategy Tester. Candle data comes straight from TradingView — results match exactly what you see manually.

What is the difference between Brute Force and Bayesian Optimization?

Brute Force tests every parameter combination exhaustively (best for small spaces — up to 100 iterations on Free, 500 on Pro, unlimited on Scale). Bayesian Optimization uses a Gaussian Process surrogate model — it learns from previous results to predict where good parameters lie, typically needing only 10–20% of the evaluations for equivalent results.

What is the difference between Public and Private strategies?

Public: a published community script on TradingView — Backpulse finds and adds it to the chart automatically using the strategy name and author.

Private: a personal or invite-only script — it must already be on your TradingView chart before running optimization. A valid TradingView session is required.

Where do I see optimization results?

After a job completes, open the Job Detail page to see a results table. Filter and sort by Net Profit, Drawdown, Profit Factor, or trade count. Each row is a parameter set — click to see the full breakdown and apply it to your strategy.

How reliable are backtest results?

Backpulse reads results directly from TradingView's Strategy Tester — they are exactly what you see manually. However, backtests are historical simulations — real performance may differ due to changing market conditions, slippage, and real-world liquidity.

What is Python Backtest?

Python Backtest (Beta, at /backtest/freqtrade) lets you write a custom trading strategy in Python using the quantbt library, then run it against years of Binance Futures OHLCV historical data. Results include 15+ performance metrics — Sharpe ratio, CAGR, max drawdown, win rate, profit factor — plus an equity curve and full trade log. Best for traders who want algorithmic control beyond Pine Script.

Webhooks & Signals

How do I connect TradingView to Backpulse?

1. Go to Webhooks → Quick Connect (or Webhook Hub → create a new Provider)

2. Select your exchange and enter your API key, then add a Route for your trading pair (e.g. BTC/USDT)

3. Copy the Route's Webhook URL (format: https://...backpulse.io/tv/TOKEN)

4. In TradingView, create an Alert for your strategy → paste the Webhook URL

5. Fill in the JSON payload in the alert's Message field

What is the correct JSON payload format?

{
  "side": "{{strategy.order.action}}",
  "market_position": "{{strategy.market_position}}",
  "qty": "{{strategy.order.contracts}}",
  "symbol": "{{ticker}}",
  "price": "{{close}}",
  "entry_price": "{{strategy.position_avg_price}}",
  "ts": "{{timenow}}"
}

Fields:

- side: "buy" or "sell" — required

- market_position: "long" / "short" / "flat" — used for automatic open/close detection

- qty: number of contracts — required, must be > 0

- symbol, price, entry_price, ts: optional (fall back to Route config)

How does Backpulse detect open vs close orders?

Based on the market_position field:

- "long" or "short" → open order, reduceOnly=false

- "flat" → close order, reduceOnly=true (futures)

Without market_position, the system falls back to a legacy action field. We recommend always including market_position for accurate P&L tracking.

Are webhooks secure?

Yes. Each Route has a unique 16-character hex token — only you know it. Backpulse validates the token before processing any order. Exchange API keys are encrypted with AES-256-GCM before storage and only decrypted in an isolated environment when placing orders — never stored as plaintext.

How fast is order execution?

Typically under 300ms from webhook receipt to order sent to the exchange. A low-latency webhook mode for the Scale plan is in development and coming soon.

Can I test a webhook without TradingView?

Yes. On the Hub Detail page, each Route has a Test Signal button — sends a simulated signal directly from the UI. Test orders are marked simulated=true and appear in Signal Logs so you can verify the full flow.

Does Backpulse track P&L automatically?

Yes. For every close signal (market_position=flat), the system automatically:

- Finds the matching open signal for that symbol

- Calculates pnl = (fill_price − entry_price) × qty

- Calculates pnlPct and holdMs (position hold duration)

The full signal history and P&L are visible in Signal Logs, filterable by signal type (long/short/close) and date range.

Exchange Connections

Which exchanges does Backpulse support?

30+ exchanges via the CCXT library, including Binance, Bybit, OKX, Kraken, Bitget, MEXC, KuCoin, Coinbase, Gate.io, and many more. Both spot and futures markets are supported. See the full list in your account settings.

What API key permissions do I need?

Only Trade permission (place orders). Do NOT enable Withdraw permission. Backpulse only requests the minimum permissions needed — it never needs to withdraw funds.

Are my API keys safe?

Yes. Keys are encrypted with AES-256-GCM immediately on input and stored encrypted in the database. They are only decrypted temporarily in an isolated environment when placing an order, then cleared from memory. You can revoke keys anytime from your account page or directly from your exchange.

Is testnet supported?

Yes. When creating a Provider, enable Testnet mode — orders will be sent to the exchange's sandbox environment (no real money). Ideal for verifying your setup before going live.

How do I configure exchanges that require a passphrase (OKX, Bitget)?

When creating a Provider, a Passphrase field appears automatically for exchanges that require it (OKX, Bitget, KuCoin). The passphrase is encrypted the same way as your API key.

Strategies Studio & AI

What does Strategies Studio include?

Strategies Studio (at /strategies) includes:

- Strategy Library: pre-built strategies (EMA Cross, RSI Reversal, MACD Momentum, Bollinger Squeeze, Supertrend…). Select one and click 'Use in Backtest' to load it directly into the optimizer.

- My Strategies: saved strategies from Strategy Builder or AI Studio.

AI Studio and Visual Builder are accessible via the Strategies dropdown in the nav, or directly at /ai-studio and /ai-studio/visual.

Note: Marketplace → Trading Bot (at /trading-bot) is where you monetize your signals — separate from Strategies Studio.

How does the Strategy Builder work?

Strategy Builder is a visual drag-and-drop tool. Drag blocks from the left palette into the 6-step pipeline: Strategy Settings → Indicators → Filters → Entry & Exit → Risk Management → Display. Pine Script v5 is generated automatically in the correct order. Copy the code, test it on TradingView, or save the strategy to your library.

What is AI Studio?

AI Studio (at /ai-studio, under the Strategies nav dropdown) lets you describe a trading strategy in plain language (English or Vietnamese). The AI parses your entry conditions, exit conditions, and risk parameters, then generates complete Pine Script v5 code. Copy it into TradingView or save it to My Strategies.

What is the difference between AI Studio and Visual Builder?

AI Studio: describe your strategy in natural language — the AI analyzes your intent and generates the code. Best when you have a clear idea and want to express it quickly.

Visual Builder (at /ai-studio/visual): select and arrange indicator, filter, entry, and exit blocks step by step — best when you want precise control over each logic step without writing code.

Which AI models does AI Studio support?

You can choose from:

- Claude Opus 4.8 — most capable, best for complex strategies (default)

- Claude Sonnet 4.6 — balanced speed and quality

- Claude Haiku 4.5 — fastest, good for simple strategies

Is the generated Pine Script ready to use?

Generated code is standard Pine Script v5 with inputs, indicators, entry/exit conditions, stop loss, and take profit. Review the logic before live trading — AI can occasionally make syntax mistakes or misinterpret intent. Always backtest before running live.

Bot, Copy Trade & Dashboard

What is Trading Bot (Marketplace)?

Trading Bot (at /trading-bot) is where you monetize your trading signals: register as a Provider, publish your track record, set a subscription price — other traders can subscribe to copy your signals. Separate from Strategies Studio, which is for managing your own personal strategies.

How does Copy Trade work?

Copy Trade (at /copy-trade) lets you mirror the positions of top traders from major exchanges. Choose a trader to follow, configure your capital allocation and risk limits — the system automatically places matching orders in real time.

What is Visual Dashboard?

Visual Dashboard (at /visual-dashboard) is a unified interface for managing all your activity: active bots, capital in use, open positions, and real-time P&L across all exchange connections. Instead of checking each Hub separately, you get a single screen for your entire portfolio.

How is FreqTrade Bot different from Trading Bot Marketplace?

FreqTrade Bot (at /freqtrade-bot) is a personal tool — you deploy your own Python IStrategy, monitor open trades, and receive Telegram alerts for your own positions.

Trading Bot Marketplace (at /trading-bot) is where you monetize signals: register as a Provider so others can copy-subscribe to your signals. Completely separate.

FreqTrade Bot

What is FreqTrade Bot?

FreqTrade Bot (at /freqtrade-bot) lets you deploy a Python FreqTrade IStrategy directly from Backpulse — no dedicated server required. Freqrunner (Backpulse's orchestration service) automatically manages containers, sessions, and exchange connections for you.

What is the difference between dry-run and live mode?

Dry-run (paper): the bot runs with virtual money — no real orders are placed, but all strategy logic runs fully. Use it to validate your strategy before risking real capital. Free plan supports 1 dry-run bot (auto-stops after 30 days).

Live: the bot connects to a real exchange via your API key and places real orders. Available from Pro and above.

How do I deploy a FreqTrade IStrategy?

1. Go to /freqtrade-bot → Launch tab

2. Paste your Python IStrategy code into the Strategy Code field

3. Select exchange, trading pair, timeframe, capital, and mode (dry/live)

4. Select an API credential (for live mode) — add your key in the API Keys tab first

5. Click Launch bot — Freqrunner starts the container within seconds

How do Telegram alerts work?

On the bot detail page (/freqtrade-bot/[id]), find the Telegram Alerts card and click Connect Telegram — the system generates a confirmation code. Send that code to @backpulse_bot on Telegram. Once confirmed, enable the toggle — the bot will send a message on every entry (⚡ LONG/SHORT) and exit (✅/🔻) with P&L.

What are the bot limits per plan?

Free: 1 dry-run bot, auto-stops after 30 days, no live bots.

Pro: 1 dry-run bot + 1 live bot.

Scale: 3 dry-run bots + 3 live bots.

Expired bots (Free plan) stop automatically — logs and results remain viewable.

Can I access FreqUI?

Yes. On the bot detail page, the FreqUI tab opens the native FreqTrade UI (freqtrade-ui.backpulse.io) embedded directly in Backpulse — view charts, open trades, and full trade history without SSH or any extra setup.

Billing & Plans

What are the differences between plans?

Free (forever): unlimited Bayesian & Brute Force, max 1 sweep parameter per run, max 100 iterations per run, 1 symbol per job, 1 concurrent job, 1 exchange connection, 30-day signal history, 1 FreqTrade dry-run bot (30-day limit).

Pro ($29/mo): unlimited params & iterations, max 500 Brute Force iterations per run, 3 symbols per job, 3 parallel jobs, 5 exchange connections, all 30+ exchanges, automatic P&L tracking, 90-day signal history, Telegram alerts, 1 dry-run + 1 live FreqTrade bot.

Scale ($79/mo): everything in Pro, unlimited iterations, 10 symbols per job, 10 parallel jobs, unlimited connections, 3 dry-run + 3 live FreqTrade bots, personalized 24/7 support + private Discord.

Is there a free trial for Pro?

Yes. You can activate a 3-day free Pro trial (one-time only). After 3 days you'll be asked whether to upgrade — no auto-charge.

What is the difference between a Provider and a Route?

A Provider (Hub) is an exchange account you connect with an API key. A Route is a trading pair or contract inside that Provider — each Route has its own unique webhook URL. The Free plan allows 1 Provider with unlimited Routes within it.

Can I change plans anytime?

Yes. Upgrades take effect immediately. Downgrades or cancellations take effect at the end of the current billing period — you keep access to your current plan's features until then.

Does Backpulse take a cut of profits?

No. You only pay a fixed monthly or yearly subscription. We never take commission on your trades or profits.

How is payment processed?

Backpulse uses Lemon Squeezy for payment processing — supports Visa, Mastercard, and other major payment methods. Lemon Squeezy acts as merchant of record; your card details never pass through Backpulse servers.

What happens when I hit a plan limit?

The system returns a clear 429 error showing your current plan, the limit, and how much you've used. You can upgrade directly from the error notification.

Still have questions?

Contact support