๐ฎ Trading Simulator - User Guide
Watch your strategy execute with realistic market conditions, configurable speed controls, and stress testing scenarios.
๐ Table of Contents
| Section | Description |
|---|---|
| 1. Overview | What is the Trading Simulator |
| 2. Quick Start | Get started in 5 steps |
| 3. Interface Overview | Understanding the UI |
| 4. Strategy Selection | Loading your strategy |
| 5. Market Selection | Choosing markets and timeframes |
| 6. Test Settings | Configuring your simulation |
| 7. Speed Control | Controlling replay speed |
| 8. Execution Realism | Modeling real-world conditions |
| 9. Scenario Injection | Testing edge cases |
| 10. Starting Simulation | Launch sequence |
| 11. Live Monitoring | Real-time telemetry |
| 12. Playback Controls | Control the simulation |
| 13. Results Analysis | Reviewing performance |
| 14. Templates | Saving configurations |
| 15. Tips & Best Practices | Pro tips |
| 16. FAQ | Common questions |
| 17. Related Guides | Continue learning |
1. Overview
๐ฏ What is the Trading Simulator?
The Trading Simulator replays historical data at configurable speeds, testing your strategy's behavior under realistic execution conditions. Unlike instant backtesting, the simulator lets you watch your strategy execute in real-time (or accelerated time) and test edge cases with scenario injection.
Your Strategy Journey:
- Strategy Builder - Design your strategy
- Backtesting Lab - Quick historical validation
- Trading Simulator - Realistic execution testing โ You are here
- Paper Trader - Live data simulation
- Live Trading - Real money
Key Features:
- โฏ๏ธ Replay Mode - Watch strategy execute in real-time or accelerated
- โก Speed Control - 6 speed modes from Realtime to 10x Fast
- ๐ฅ Scenario Injection - Test flash crashes, volatility spikes, liquidity droughts
- ๐ฒ Execution Realism - Model latency, slippage, market impact
- ๐ก Live Telemetry - Real-time streaming of execution events
- ๐ Progress Tracking - Progress bar with time estimates
๐ Simulator vs Other Tools
| Feature | Backtesting | Simulator | Paper Trading |
|---|---|---|---|
| ๐ Data Source | Historical | Historical (replayed) | Live Market |
| โก Speed | Instant | Configurable | Real-Time |
| ๐ฒ Realism | Basic | Configurable | Full |
| ๐ฅ Scenarios | โ | โ Supported | โ |
| โฑ๏ธ Duration | Seconds | Minutes-Hours | Hours-Days |
| ๐ฏ Use Case | Rapid iteration | Stress testing | Pre-live validation |
2. Quick Start
Get Started in 5 Steps:
- Navigate - Dashboard โ Platform โ Trading Simulator
- Select Strategy - Choose from your saved strategies
- Configure Market - Pick symbol, timeframe, and date range
- Set Speed Mode - Choose Auto (recommended), Fast, Balanced, or Accurate
- Click Start - Watch your simulation run!
๐ก First time? Use Auto speed mode with 1 week of data for a quick test
3. Interface Overview
Left Panel (Configuration):
- Strategy Selection - Load from library or Strategy Builder
- Market Selection - Choose symbol and timeframe
- Test Settings - Date range, capital, fees
- Speed Control - Replay speed mode
- Execution Realism - Latency, slippage, market impact
- Scenario Injection - Add stress test events
Main Panel (Live Monitoring):
- Progress Bar - Current progress with ETA
- Portfolio Stats - Real-time equity, P&L, positions
- Equity Curve - Portfolio value over time
- Trade List - Executed trades with details
Telemetry Panel (Health Monitoring):
- Tick counter and processing speed
- Execution latency metrics
- Memory usage
- Connection status
4. Strategy Selection
๐ Loading Your Strategy
Select a strategy to simulate:
| Source | Description |
|---|---|
| ๐ Strategy Library | Previously saved strategies |
| โ๏ธ Strategy Builder | Currently open strategy |
| ๐ฅ Import | Load from JSON file |
โ Strategy Requirements
| Requirement | Description |
|---|---|
| โ Valid DSL | Strategy must compile without errors |
| โ Entry Rules | At least one entry condition |
| โ Exit Rules | At least one exit condition |
| โ Backtested | Should pass backtesting first |
5. Market Selection
Market Types:
- Crypto - Binance data (BTC/USDT, ETH/USDT, etc.)
- US Stocks - TwelveData (AAPL, TSLA, MSFT, etc.)
- Forex - TwelveData (EUR/USD, GBP/USD, etc.)
- Indian Equities - Demo data (RELIANCE, TCS, INFY, etc.)
Available Timeframes:
| Timeframe | Best For | Data Points (1 year) |
|---|---|---|
| 1m | Scalping | 525,600 |
| 5m | Day trading | 105,120 |
| 15m | Intraday swing | 35,040 |
| 1h | Swing trading | 8,760 |
| 4h | Position trading | 2,190 |
| 1d | Long-term | 365 |
6. Test Settings
Configuration Options:
- Capital Settings - Initial portfolio size and currency
- Date Range - Start/end dates with quick selects (1W, 1M, 3M, 6M, 1Y)
- Session Templates - Market hours (NSE, NYSE, Forex 24/5, Crypto 24/7)
- Trading Fees - Commission and slippage rates
๐ฐ Capital Options
| Currency | Symbol | Typical Range |
|---|---|---|
| ๐ฎ๐ณ Indian Rupee | โน | โน1,00,000 - โน50,00,000 |
| ๐บ๐ธ US Dollar | $ | $10,000 - $500,000 |
| ๐ช๐บ Euro | โฌ | โฌ10,000 - โฌ500,000 |
| ๐ฌ๐ง British Pound | ยฃ | ยฃ10,000 - ยฃ500,000 |
| โฟ Bitcoin | BTC | 0.1 - 10 BTC |
| ๐ Ethereum | ETH | 1 - 100 ETH |
๐ฑ Currency Display: All P&L values in the simulation results are automatically converted to your profile's display currency. The simulation runs in the configured currency, but dashboard views show converted values using live FX rates.
๐ Date Range Quick Selects
| Period | Description | Data Volume |
|---|---|---|
| 1W | Last week | ~2,000 candles (5m) |
| 1M | Last month | ~8,600 candles (5m) |
| 3M | Last 3 months | ~26,000 candles (5m) |
| 6M | Last 6 months | ~52,000 candles (5m) |
| 1Y | Last year | ~105,000 candles (5m) |
โฐ Session Templates
| Template | Hours | Time Zone |
|---|---|---|
| ๐ฎ๐ณ NSE | 09:15 - 15:30 IST | Asia/Kolkata |
| ๐บ๐ธ NYSE | 09:30 - 16:00 EST | America/New_York |
| ๐บ๐ธ NASDAQ | 09:30 - 16:00 EST | America/New_York |
| ๐ฑ Forex | 24/5 | UTC |
| โฟ Crypto | 24/7 | UTC |
| ๐ Custom | User-defined | User-defined |
7. Speed Control
โฏ๏ธ Speed Modes
| Mode | Speed | Description | Use Case |
|---|---|---|---|
| ๐ข Realtime | 1x | Actual market speed | Watch every tick |
| ๐ Slow | 0.5x | Half speed | Detailed analysis |
| ๐ค Auto | Optimized | System decides | Recommended |
| โก Fast | 10x | Quick completion | Validation runs |
| โ๏ธ Balanced | 5x | Speed + accuracy | General testing |
| ๐ฏ Accurate | Tick-by-tick | Every data point | Precision testing |
๐ก Tip: Start with Auto mode. The system optimizes based on your data volume and complexity.
โฑ๏ธ Time Estimates
| Data Period | Auto Mode | Fast Mode | Realtime |
|---|---|---|---|
| 1 Week | ~2 min | ~30 sec | ~35 hours |
| 1 Month | ~8 min | ~2 min | ~7 days |
| 3 Months | ~20 min | ~5 min | ~21 days |
| 1 Year | ~1 hour | ~15 min | ~3 months |
8. Execution Realism
Simulate Real-World Trading Conditions:
โก Network Latency - Delay between order submission and execution ๐ Order Book & Liquidity - Partial fills and order rejections ๐ Market Impact - Large orders move prices ๐ Dynamic Slippage - Slippage increases during volatility
โก Network Latency
Models the delay between order submission and execution:
| Setting | Description | Typical Values |
|---|---|---|
| Min Latency | Best-case delay | 10-50ms |
| Max Latency | Worst-case delay | 100-500ms |
| Jitter | Random variation | On/Off |
๐ Order Book & Liquidity
| Setting | Description |
|---|---|
| Liquidity Threshold | Orders > X% of daily volume may be rejected |
| Partial Fills | Large orders may fill in parts |
| Rejection Probability | Chance of order rejection |
๐ Market Impact
Large orders move prices:
| Model | Description | Use Case |
|---|---|---|
| Linear | Impact proportional to order size | Simple approximation |
| Square Root | Impact = k ร โ(Order Size) | Institutional standard |
๐ Dynamic Slippage
Slippage increases during volatile periods:
Actual Slippage = Base Slippage ร Volatility ร Multiplier| Setting | Description | Range |
|---|---|---|
| Base Slippage | Normal market conditions | 0.01% - 0.1% |
| Volatility Multiplier | Scales with market volatility | 1x - 3x |
9. Scenario Injection
Test Your Strategy Under Stress:
Inject market events to see how your strategy handles extreme conditions:
- ๐ Volatility Spike - Sudden price movement increase
- ๐ Flash Crash - Rapid price drop and recovery
- ๐ง Liquidity Drought - Reduced market depth and wider spreads
- ๐ฐ News Shock - Price gap simulation
- ๐ Regime Shift - Trend reversal
๐ Scenario Types
| Scenario | Description | Effect |
|---|---|---|
| ๐ Volatility Spike | Sudden increase in price movement | Tests stop-loss behavior |
| ๐ Flash Crash | Rapid price drop and recovery | Tests panic scenarios |
| ๐ง Liquidity Drought | Reduced market depth | Tests fill quality |
| ๐ฐ News Shock | Price gap on news event | Tests gap handling |
| ๐ Regime Shift | Trend reversal | Tests adaptation |
๐ Volatility Spike Settings
| Setting | Description | Range |
|---|---|---|
| Intensity | How much volatility increases | 2x - 10x |
| Duration | How long the spike lasts | 5 - 60 minutes |
| Trigger Time | When to inject (random or specific) | Auto / Manual |
๐ Flash Crash Settings
| Setting | Description | Range |
|---|---|---|
| Drop Magnitude | How far price drops | 5% - 20% |
| Drop Duration | How fast the drop occurs | 1 - 5 minutes |
| Recovery Time | How fast price recovers | 5 - 30 minutes |
| Recovery % | How much price recovers | 50% - 100% |
๐ง Liquidity Drought Settings
| Setting | Description | Range |
|---|---|---|
| Spread Widening | How much spread increases | 2x - 10x |
| Duration | How long the drought lasts | 5 - 60 minutes |
| Fill Rate | Percentage of orders that fill | 20% - 80% |
10. Starting Simulation
Launch Process:
- Click Start button
- System validates your configuration
- Historical data is fetched from provider
- Simulation engine initializes
- Strategy begins executing on replayed data
- Live telemetry streams to your browser
Simulation States:
- Idle โ Initializing โ Loading โ Running โ Completed
- Can pause/resume at any time
- Stop ends simulation permanently
๐จ Status Indicators
| Status | Color | Description |
|---|---|---|
| โฌค Idle | Gray | Ready to start |
| โฌค Initializing | Blue | Validating configuration |
| โฌค Loading | Orange | Fetching historical data |
| โฌค Running | Green | Simulation in progress |
| โฌค Paused | Yellow | Temporarily stopped |
| โฌค Completed | Green | Successfully finished |
| โฌค Stopped | Gray | Manually stopped |
11. Live Monitoring
Real-Time Telemetry:
The simulator streams live updates via Server-Sent Events (SSE) as your strategy executes:
- Tick Events - Each candle processed
- Order Events - Entries, exits, fills
- Portfolio Updates - Equity, positions, P&L
All updates appear instantly in the interface with no page refresh needed.
๐ฐ Live Portfolio Stats
| Metric | Description |
|---|---|
| ๐ต Equity | Total portfolio value |
| ๐ณ Cash | Available cash balance |
| ๐ Open P&L | Unrealized profit/loss |
| ๐ Total P&L | Realized + unrealized |
| ๐ฆ Positions | Current open positions |
| ๐ Orders | Pending orders |
| ๐ Trades | Total executed trades |
| ๐ฏ Win Rate | Percentage of winning trades |
๐ฅ๏ธ Runtime Health
| Metric | Healthy Range | Warning |
|---|---|---|
| Tick Counter | Progressing | Stuck for 10s+ |
| Exec Latency | Under 100ms | Over 500ms |
| Memory Usage | Under 500MB | Over 1GB |
| SSE Status | ๐ข Connected | ๐ด Disconnected |
12. Playback Controls
โฏ๏ธ Controlling the Simulation
| Button | Action | Description |
|---|---|---|
| โถ๏ธ Start | Begin simulation | Starts from beginning |
| โธ๏ธ Pause | Temporarily stop | Can resume later |
| โถ๏ธ Resume | Continue from pause | Picks up where you left off |
| โน๏ธ Stop | End simulation | Cannot resume |
โธ๏ธ When to Use Pause
| Scenario | Why Pause |
|---|---|
| Observe a specific event | Pause to analyze what just happened |
| Scenario triggered | Watch how strategy responds |
| Large trade executed | Review order details |
| Take a break | Return later without losing progress |
๐ก Tip: Pausing does NOT reset the simulation. You can resume from exactly where you left off.
13. Results Analysis
Comprehensive Performance Summary:
After completion, view detailed results across three categories:
๐ Returns:
- Total Return %
- Sharpe Ratio (risk-adjusted return)
- Sortino Ratio (downside risk)
๐ Risk:
- Max Drawdown %
- Volatility
- Value at Risk
๐ Trading:
- Total Trades
- Win Rate %
- Profit Factor
๐ Key Metrics
| Metric | Description | Good Value |
|---|---|---|
| ๐ Total Return | Overall profit/loss | Positive |
| ๐ Sharpe Ratio | Risk-adjusted return | > 1.0 |
| ๐ Max Drawdown | Largest peak-to-trough loss | < 15% |
| ๐ฏ Win Rate | Percentage of winning trades | > 50% |
| โ๏ธ Profit Factor | Gross profit / gross loss | > 1.5 |
| ๐ Avg Trade | Average profit per trade | Positive |
๐ Available Charts
| Chart | Shows |
|---|---|
| ๐ Equity Curve | Portfolio value over time |
| ๐ Drawdown Chart | Peak-to-trough losses |
| ๐ Win/Loss Distribution | Trade outcome histogram |
| ๐ Monthly Returns | Calendar heatmap of returns |
๐พ Exporting Results
| Format | Contents |
|---|---|
| ๐ CSV | All trades, metrics, timestamps |
| ๐ JSON | Full simulation data including configuration |
14. Templates
๐พ Saving Configuration Templates
Save your simulation setup for reuse:
| Component | Saved |
|---|---|
| โ Strategy Reference | Yes |
| โ Market Selection | Yes |
| โ Test Settings | Yes |
| โ Execution Realism | Yes |
| โ Scenario Injection | Yes |
| โ Speed Mode | Yes |
๐ Example Templates
| Template | Description |
|---|---|
| ๐ AAPL Stress Test | AAPL 5m, $100k, Flash Crash enabled |
| ๐ Quick Validation | Any symbol, 1 week, Fast mode |
| ๐ Full Realism Test | All realism options, Slow mode |
15. Tips & Best Practices
Pro Tips:
โ Start with Auto Speed - Let the system optimize for your data volume โ Enable Execution Realism - At least latency (50-200ms) and slippage (0.01-0.1%) โ Test Stress Scenarios - Every strategy should survive a flash crash โ Compare with Backtesting - Results should be similar but slightly worse due to realism โ Save Configuration Templates - Maintain consistency across tests โ Use Sufficient Data - Minimum 1-3 months for statistical significance
Common Mistakes:
โ Zero slippage/latency - Unrealistic execution (always enable realism) โ Fast mode only - May miss execution issues (test slower modes too) โ No stress testing - Creates false confidence (add scenarios) โ Too short date range - Statistical noise (use 1-3 months minimum)
๐ฏ When to Use Simulator vs Others
| Use Case | Best Tool | Why |
|---|---|---|
| Rapid iteration | Backtesting | Fastest results |
| Execution testing | Simulator | Realistic fills |
| Stress testing | Simulator | Scenario injection |
| Pre-live validation | Paper Trading | Real market data |
| Parameter optimization | Backtesting | Many runs needed |
16. FAQ
How long does a simulation take? Depends on data volume and speed mode. Typical times: 1 week (~2 min), 1 month (~8 min), 3 months (~20 min) on Auto speed.
Can I change speed during simulation? Not currently - stop and restart with different speed.
Why are results different from backtesting? Execution realism (latency, slippage, market impact) makes fills more realistic, usually slightly worse than backtesting.
What if I close the browser during simulation? Simulation continues on server. Reconnect to see progress and results.
How many scenarios can I add? No hard limit, but too many creates unrealistic conditions.
Does scenario injection modify historical data? No - scenarios are overlaid. Original data unchanged.
What if SSE connection fails? Page automatically attempts to reconnect. If issues persist, check network connection.
17. Related Guides
Your Trading Journey:
- Strategy Builder - Create your strategy
- Backtesting Lab - Quick historical validation
- Trading Simulator - Realistic execution testing โ You are here
- Paper Trader - Live data simulation
- Dashboard - Platform navigation
๐ Need Help?
- In-app support: Press
Ctrl + ? - Email: support@flytradr.com
- Documentation: docs.flytradr.com
Test your strategy with realistic execution conditions! ๐ฎ