Langue du manuel

BtcTrader — User Manual

Last updated: 2026-05-22

Welcome to BtcTrader. This manual explains every part of the platform: the web app, the backtesting dashboard, the Strategy and Indicator Designers, the Telegram bot, the mobile app, risk management, and billing. Read the Getting Started section first, then jump to whatever feature you need.

Getting started
Plans & subscriptions
The web app
The backtesting dashboard
Strategy Designer & custom rules
Indicators
Risk management
Paper trading
Backtesting modes & validation
The Telegram bot
The mobile app
Tools & calculators
Account & security
FAQ & support

1. Getting started

BtcTrader is a research and paper-trading platform for crypto strategies. You build trading rules, test them on historical data, validate that they are robust, and run them in paper mode (simulated, no real money) before deciding anything.

Important: BtcTrader is an educational and research tool. Paper trading uses simulated capital. Nothing here is financial advice.

Create an account

Open the website and click Sign up.
Enter your email and a password.
Confirm your email if prompted.
Log in with Login.

First steps after signing up

Complete the Onboarding flow — it walks you through your first strategy.
Visit Docs → Getting Started for a guided tour.
Try the Quiz to check your trading knowledge.
Open the Strategy Designer and load a quick-start template.

Changing language

The website is available in English, German, Italian, Spanish, and French. Use the language switcher in the page header. Your choice is saved in a cookie for one year. This manual is also available in Persian.

2. Plans & subscriptions

BtcTrader offers three plans. See the Pricing page for current details.

Feature	Free	Pro — 15 USDT/mo	Desk — 49 USDT/mo
Custom rule sets	1	Unlimited	Unlimited
Active paper-trade strategies	1	Unlimited	Unlimited
Alerts per month	10	100	500
Backtest history	Limited	6 months	Unlimited
Marketplace access	—	Yes	Yes
Priority support	—	Yes	Yes
White-label / custom	—	—	Yes

How to upgrade

Go to Pricing or Billing.
Choose Pro or Desk.
You are sent to a NOWPayments hosted checkout.
Pay in USDT (TRC-20, BEP-20, or Polygon networks).
Once the payment confirms, your plan activates for 30 days.

Payments are processed by NOWPayments. Each payment covers a 30-day period. If you hit a limit on the Free plan (for example, your monthly alert cap), an upgrade prompt links you straight to the Pricing page.

Billing page

The Billing page shows your current plan, payment history, and lets you upgrade or downgrade. Subscriptions can be pending, active, past_due, canceled, or trialing.

3. The web app

The web app is the main hub. Below are the key areas.

Core pages

Home — landing page and overview.
Pricing — subscription plans.
Billing — manage your subscription and payments.
Profile — account settings; includes account deletion.
About / Contact / Status — company info, contact form, system health.

Documentation & learning

Docs hub — Getting Started, Backtesting, Strategy Designer, Indicator Designer, Telegram Bot, Mobile App, Paper Trading, Walk-Forward, Billing, and FAQ.
Blog — articles and updates (with RSS feed).
Glossary — definitions of trading terms.
Guides — exchange-specific setup guides (e.g. Binance).
News — a market news feed.

Strategies & community

Strategies — your strategy library; open any strategy to see details or publish it to the community.
Marketplace — browse and obtain strategies built by others; compare listings side by side.
Compare — side-by-side comparison of strategies by trading pair.
Leaderboard — top-performing strategies.
Roadmap — see upcoming features and vote on them.
Refer — invite friends through the referral program.

Tools

Strategy Builder (/builder) — a visual rule-set builder.
What-If Simulator — adjust fees and slippage and see how your equity curve changes.
Tools hub — calculators (see section 12).

Any backtest result can be shared with a public link via the Share page, so you can show results without giving access to your account.

4. The backtesting dashboard

The backtesting dashboard is the most powerful part of BtcTrader. It runs in four modes and produces detailed analytics.

Modes

Backtest — test a strategy on a single historical window.
Walk-Forward — rolling train/test windows; reports out-of-sample (OOS) Sharpe for each window.
CPCV — Combinatorial Purged Cross-Validation; tests every combination of folds for a tougher robustness check.
Paper — live, simulated trading with real-time market data.

Built-in strategies

Strategy	What it does
`ema_crossover`	Trades fast/slow EMA crossovers.
`momentum`	Cross-sectional momentum (buy strong, sell weak).
`breakout`	Donchian channel breakouts.
`buy_and_hold`	Benchmark; just holds the asset.
`pairs`	Statistical arbitrage between two symbols.
`ml_alpha`	Machine-learning meta-labeling.
`rl`	Reinforcement-learning agent (PPO/SAC).
`deep_classifier`	Deep network (LSTM/TCN/Transformer).
`online_river`	Streaming logistic regression.

You can also select any of your custom rule sets built in the Strategy Designer.

Setting up a run

In the sidebar:

Pick a mode and a strategy.
Choose a timeframe (1m up to 1M).
Set starting cash (minimum $100).
Choose a data source — CCXT (live exchange data) or fixture (synthetic).
Pick an exchange (Binance, Coinbase, Kraken, Bybit) and symbols.
Open Advanced parameters to set fees, costs, and (in paper mode) risk limits and circuit breakers.
Click run.

Costs & fees

Set realistic trading costs so results are honest:

Taker fee (basis points, default 5)
Half-spread (bps, default 1.5)
Slippage (random noise, σ ≈ 1.5 bps)

See Docs → Fees Explained for details.

Results & analytics

After a run finishes you get:

KPI cards — equity, P&L %, drawdown %, trade count.
Validation chips — PSR (Probabilistic Sharpe Ratio), DSR (Deflated Sharpe Ratio), and PBO (Probability of Backtest Overfitting, after a sweep).
Equity + drawdown chart — with green ▲ buy and red ▼ sell markers.
Returns distribution — histogram with VaR and CVaR at 5%.
Attribution — performance broken down by symbol, hour of day, day of week.
Underwater (drawdown) chart, strategy vs buy-and-hold, monthly returns heatmap, position timeline, hold-time histogram, best/worst trades, drawdown episodes, rolling Sharpe, and fills by signal reason.

Presets, sweeps & auto-tuning

Presets — save your full configuration to a file and reload it later.
Parameter sweep — test a range of values for one parameter in parallel; the dashboard tracks the best Sharpe and computes PBO.
Optuna auto-tune — automated hyperparameter search; shows a per-trial Sharpe scatter and a top-5 leaderboard.

Run management

Run history — the 40 most recent runs, with phase, P&L, and tags.
Star runs to bookmark them; filter by tag; bulk delete old runs.
External sessions — attach to a running paper session and see if it is LIVE or STALE.
Stop, Panic Flat (close all positions), and Clear controls.
Rerun a run with the exact same parameters.

Downloads

For finished backtests you can download a tearsheet (HTML), the full trades CSV, and the bar-level equity CSV.

5. Strategy Designer & custom rules

The Strategy Designer lets you build your own trading strategy without code. It is available inside the dashboard, and the Indicator Designer is its own dedicated page that shares the same draft.

Building a rule set

A rule set has four parts:

Indicators — choose from 10+ types (see section 6). Each indicator can optionally run on a higher timeframe (1h, 4h, or 1d).
Entry rules — AND/OR trees of conditions that trigger a buy.
Exit rules — AND/OR trees of conditions that trigger a sell.
Risk guards — stop loss %, take profit %, trailing stop %, and a cooldown (bars to wait before re-entering).

Operators

Conditions compare two references using:

< — less than
> — greater than
crosses_up — value crossed from below to above
crosses_down — value crossed from above to below

A reference can be a number, an indicator value, or a bar value (open, high, low, close, volume).

Quick-start templates

Three templates get you going fast: RSI mean-reversion, EMA golden cross, and Bollinger bounce. Load one, then adjust it.

Quick test

Click Quick test to run an instant backtest on 500 recent bars from Binance. You get metrics, an equity sparkline, and a price chart with colored signal markers: green = entry, orange = stop loss, blue = take profit, purple = trailing stop, red = rule exit.

Validity panel

The designer checks your rule set and lists any issues (for example, a rule referencing an indicator that doesn't exist).

Robustness Validator

From the strategy library you can run the Robustness Validator: a walk-forward analysis that produces a 6-axis scorecard — OOS Sharpe, % of positive windows, the in-sample vs out-of-sample gap (an overfitting signal), minimum trades per window, worst-window drawdown, and profit factor. The verdict is Strong (≥80), Cautious (≥50), or Weak (<50).

Strategy comparison (bake-off)

Pick several saved rule sets and run them over the same bars. You get a ranked metrics table and an overlaid, normalized equity chart.

Live Signal Monitor

A card grid showing each saved rule set's current state: LONG or FLAT, an ENTRY or EXIT pulse, unrealized P&L, and the last action with its timestamp, price, and reason. It auto-refreshes.

6. Indicators

The Indicator Designer offers these building blocks:

Indicator	Parameters	Outputs	Typical use
RSI	period	value 0–100	Overbought / oversold
EMA	period	value	Trend, crossovers
SMA	period	value	Moving average, support/resistance
MACD	fast, slow, signal	line, signal, histogram	Trend + momentum
Bollinger	period, std multiplier	mid, upper, lower	Volatility bands
ATR	period	value	Volatility, stop placement
Stochastic	period, smoothing	%K, %D	Oscillator
ADX	period	ADX, +DI, −DI	Trend strength
VWAP	period	value	Volume-weighted price
Volume MA	period	value	Volume filters
Swing	lookback	last/prev high & low	Pivot detection
S-Trend	lookback	+1 / −1 / 0	Swing regime (up/down/flat)

Multi-timeframe

Any indicator can be set to a higher timeframe (1h, 4h, 1d) so it gives you broader context while your strategy runs on a faster timeframe. Block boundaries are aligned to UTC.

Swing detection

The Swing indicator finds pivot highs and lows. It powers the swing-related Telegram commands and the S-Trend regime indicator, which reports up, down, or flat based on consecutive pivots.

7. Risk management

Risk controls protect you in paper and live trading.

Sizing modes

Fixed weight — a fixed % of equity per position.
Risk-based — sizing based on a notional % of the account.
Kelly — available as a meta-parameter in advanced strategies.

Risk limits

Max trade notional % — cap on the size of any single trade (default 0.5).
Max position concentration — no single symbol above this share (0.6).
Max gross leverage — total absolute exposure (1.5).
Max net leverage — net long-minus-short exposure (1.0).
Max daily loss % — daily loss floor (0.03).
Max drawdown % — equity drawdown from peak (0.10).

Circuit breakers

Circuit breakers pause trading automatically when conditions get dangerous:

Max consecutive losses — pause after N losing trades in a row.
Volatility threshold — pause when market volatility exceeds a limit.
Breaker drawdown % — pause when drawdown crosses a threshold.
Cooldown bars — how long to wait before resuming after a breaker trips.

Watchdog

Max stale seconds — if the data feed goes silent too long, the kill switch trips.
Reconcile every N bars — periodically sync internal state with the exchange.

Kill switch & panic flat

Kill switch — a hard stop; closes the session immediately, no cleanup.
Panic flat — closes all open positions and exits cleanly.

Both can be triggered from the dashboard or the Telegram bot.

8. Paper trading

Paper trading runs your strategy against live market data with simulated money — a safe way to see how a strategy behaves in real time.

In the dashboard, set the mode to Paper.
Choose your strategy, symbols, timeframe, and starting cash.
Set warmup bars, max live bars, and a poll interval.
Configure risk limits and circuit breakers.
Start the run.

You can run multiple paper strategies at once; capital is split proportionally and the dashboard shows a combined equity view.

Drift detection

After 30+ samples, the dashboard checks whether your strategy's behavior is drifting from expectations using PSI (Population Stability Index), the KS test, and ADWIN. This warns you when a strategy may no longer be working as it did.

Alerts

A rolling alert history shows the last 20 events, with the most recent 5 as colored chips. Alerts fire on kill-switch trips, circuit-breaker trips, and large drawdowns.

9. Backtesting modes & validation

Good results come from good validation. BtcTrader gives you several layers.

Walk-Forward — splits history into rolling train/test windows and reports OOS Sharpe per window, plus mean/median and % of positive windows.
CPCV — Combinatorial Purged Cross-Validation tests every combination of test folds, a stricter check against luck.
Parameter sweep — runs many parameter values in parallel and computes PBO (Probability of Backtest Overfitting).
Optuna auto-tune — Bayesian search for the best parameters.
PSR / DSR — Probabilistic and Deflated Sharpe Ratios adjust the Sharpe ratio for sample size and the number of trials, so you don't fool yourself.
Monte Carlo — resamples trades to estimate the range of outcomes.
Scheduled backtests — run saved presets on a schedule and get a decay alert when realized Sharpe drops below baseline.

Rule of thumb: a strategy that looks great in one backtest but fails walk-forward or has a high PBO is probably overfit. Trust the out-of-sample numbers.

10. The Telegram bot

The Telegram bot gives you BtcTrader on the go. Only chat IDs on the allowlist can use it, and destructive commands require a PIN.

Information

/help — list all commands.
/strategies — list your saved rule sets.
/templates — list bundled templates.
/show <strategy> — print a strategy's definition.

Backtest & validation

/backtest <strategy> [symbol] [tf] [days] — run a backtest, get a summary and a PDF report.
/validate <strategy> [symbol] [tf] [days] — check arguments before running.
/optimize <strategy> [symbol] [tf] [days] — run hyperparameter optimization.
/montecarlo <strategy> [symbol] [tf] [days] — Monte Carlo resampling.

Market analysis

/swings [symbol] [tf] [bars] [lookback] — detect swing pivots.
/dswings — double swings (consecutive same-side pivots).
/breaks [symbol] [tf] [bars] [lookback] — breakouts of swing levels.
/validbreaks [...] — breakouts confirmed by the next close.
/crosses [symbol] [tf] — indicator crossover signals.
/trends [symbol] [tf] [bars] — trend regime (up/down/range).
/tradechart [strategy] [symbol] [tf] [days] — candlestick chart with entry/exit markers.

Monitoring

/runs — last 10 backtest runs.
/run <id> — details of one run.
/equity — current paper/live equity.
/positions — open positions.
/pulse — BTC price, 24h change, funding rate.
/status — engine health (kill switch, breaker, last fill).
/alerts — recent alerts.
/watchlist [symbol] [tf] [bars] — track watchlist symbols.
/whatif [strategy] [symbol] [tf] [bps] — cost-impact simulation.

Paper trading

/start_paper <strategy> [symbol] [tf] [cash] — start a paper trade.
/papertrade — current paper-trade status.
/journal, /jstats, /jset <key> <value> — trading journal and stats.

Destructive commands (PIN required)

/kill [pin] — hard kill switch.
/flatten [pin] — close all positions.
/stop <run_id> [pin] — stop a specific run.

The PIN is the last word of the command. If the bot's PIN is not configured, these commands are disabled for safety.

11. The mobile app

The mobile app (Android / iOS) puts the core of BtcTrader in your pocket.

Main tabs

Home — your dashboard overview.
Paper Trade — start/stop paper trades, watch positions and equity.
Scanner — scan many symbols for signals (swings, breakouts, crosses).
Strategies — view, quick-test, and launch your strategies.
Marketplace — browse strategies.
Alerts — alert management and history.
Watchlist — watched symbols with prices and signals.
Feed — market feed and news.
Webhooks — set up Discord/Telegram integrations.
Notifications — push-notification history.

Extra screens

AI Assistant — a chat-based trading helper.
AI Critic — automated feedback on your strategy.
Compare — side-by-side strategy comparison.
Charts — detailed equity and price charts.
Stress Test — robustness testing.
Trends — market trend analysis.
Perps — perpetual-futures view.

Sign in with the same email and password as the website. Biometric unlock is optional, and Android receives push notifications for alerts.

12. Tools & calculators

The Tools hub on the website offers free calculators:

Position Size Calculator — size a position from your risk per trade.
Risk/Reward Ratio — analyze entry, stop, and target.
Liquidation Price — find the liquidation price for a leveraged position.
Drawdown Recovery — how much gain is needed to recover a drawdown.
Compound Calculator — project compounded growth.
Sharpe / Drawdown — quick risk metrics.

The What-If Simulator lets you re-apply different fee and slippage assumptions to an existing equity curve, from cheaper (−50 bps) to far more expensive (+200 bps), so you can stress-test your cost assumptions.

13. Account & security

Profile

The Profile page holds your account settings. To remove your account, use Profile → Delete, which can also wipe your data.

Password

Reset your password from the login page; you receive a reset link by email.

Sessions

Dashboard sessions use secure tokens and time out after 15 minutes of inactivity (configurable). Each browser tab gets its own session.

Referrals

Share your referral link from the Refer page. Referred users earn you credit on their first payment.

Keep your account safe

Use a strong, unique password.
Never share your dashboard session link — it grants access.
Keep the Telegram destructive PIN private.

14. FAQ & support

Is this real trading? No. Paper trading uses simulated money. BtcTrader is a research and education platform.

Why does my strategy do worse in walk-forward than in a single backtest? That gap is a sign of overfitting. Trust the out-of-sample (walk-forward, CPCV) numbers and watch the PBO value.

What payment methods are accepted? USDT only, on the TRC-20, BEP-20, and Polygon networks, via NOWPayments. Each payment covers 30 days.

How many strategies can I run? Free: one custom rule set and one active paper strategy. Pro and Desk: unlimited.

I hit my alert limit. Free plans get 10 alerts/month, Pro 100, Desk 500. Upgrade on the Pricing page.

Which exchanges are supported for data? Binance, Coinbase, Kraken, and Bybit for market data via CCXT.

Where do I get help? Check the Docs hub and FAQ page first. Use the Contact page to reach support. Pro and Desk plans get priority support. The Status page shows current system health.

Trading carries risk. BtcTrader provides research and simulation tools only and does not provide financial advice. Past performance — including backtest results — does not guarantee future results.