BlueJackal Dashboard

⚡ BlueJackal — User Manual

Complete reference for the BlueJackal automated trading dashboard.

1. Overview

BlueJackal is an autonomous BTC/USDT spot trading bot. It continuously monitors price and automatically enters and exits positions using a configurable trough-buy and peak-sell strategy. Every parameter is hot-reloaded from the dashboard — no restarts required.

Key principles: no hardcoding, fund safety (live balance checked before every order), mode parity (same code path across simulation, testnet, and live), and full auditability (all trades and settings changes persisted in the database).

2. Trading Strategy

Buy Trigger — Trough Detection

The monitor tracks a rolling price high. When price falls drop_pct% from that high, it enters Trough Zone. It then waits for a bounce of recovery_pct% from the lowest point seen — this confirms the trough and fires a market BUY.

Rolling high: $100,000 drop_pct = 2% → price falls to $98,000 → Trough Zone entered recovery_pct = 0.5% → price recovers to $98,490 → BUY at $98,490

Sell Trigger — Peak Detection

Each open trade has its own peak detector. Once price rises rise_pct% from entry, the trade enters Peak Zone. Inside Peak Zone a rolling high is tracked continuously. A sell fires only when price pulls back pullback_pct% from the highest price ever reached — not from the Peak Zone entry price. This lets winners run.

Entry: $100.00 | rise_pct = 1.5% | pullback_pct = 0.3% Tick 1: $101.50 → Peak Zone entered (no sell yet) Tick 2: $103.50 → rolling_high = $103.50 Tick 3: $105.00 → rolling_high = $105.00 Tick 4: $104.69 → pullback from $105.00 = 0.30% → SELL ✓ (TP)

Hard Stop-Loss

Before the peak detector runs, price is checked against entry_price × (1 − sl_pct / 100). If price falls to or below this level the trade closes immediately (reason: SL), regardless of peak zone state.

Multiple Concurrent Trades

A second trade only opens after a new, independent trough cycle — not simply because price is still low. Each trade has its own stop-loss and peak detector.

Price $100,000 ── rolling_high │ drop 2.1% → TROUGH ZONE ▼ $97,900 ── trough_low │ recovery 0.5% ▼ $98,390 ── ✅ BUY Trade 1 detector resets, rolling_high = $98,390 │ │ price climbs → new rolling_high $99,000 │ drop 2.04% → TROUGH ZONE ▼ $96,980 ── trough_low │ recovery 0.5% ▼ $97,465 ── ✅ BUY Trade 2 (Trade 1 still open) Trade 1 │ own sl_price · own PeakDetector · independent Trade 2 │ own sl_price · own PeakDetector · independent

A buy is suppressed if max_open_trades is already reached. A 3rd trade requires a 3rd full trough cycle.

3. Process Map

Monitor TickFetch live price

→

Trough Zone?Drop ≥ drop_pct

→ Yes →

Recovery?Bounce ≥ recovery_pct

→ Yes →

BUYMarket order

→

SL hit?Price ≤ sl_price

→ No →

Peak Zone?Rise ≥ rise_pct

→ Yes →

Pullback?Drop ≥ pullback_pct

→ Yes →

SELL TPMarket order

If SL is hit → SELL SL. If Trough Zone or Recovery check fails → monitor continues watching next tick. If Peak Zone not yet reached → SL check runs every tick.

4. Modes Reference

Trading Mode

Mode	Exchange Orders	Price Source	Use Case
Simulation	None (no-op)	Binance live prices	Safe testing — no funds needed
Testnet	Binance Spot Testnet	Testnet REST	Realistic order flow with paper funds
Live	Binance Spot Live	Live REST	Real money trading

Trader Controls

Control	Auto Buys	Manual Buys	Auto Exits (SL/TP)	Manual Sells
▶ Active	✓	✓	✓	✓
⏸ Soft Pause	✗	✗	✓	✓
⏹ Hard Stop	✗	✗	✗	✗

5. Settings Reference

Setting	What it controls
Symbol	Trading pair (e.g. BTCUSDT)
USDT / Trade	Capital allocated per buy order in USDT
Drop %	Price drop from rolling high required to enter Trough Zone
Recovery %	Price bounce from trough low required to confirm a buy
Rise %	Price rise from entry required to activate Peak Zone (sell tracking begins)
Pullback %	Price pullback from the peak high required to trigger a sell
Stop-Loss %	Maximum loss from entry before the trade is force-closed (SL)
Max Open Trades	Maximum number of simultaneously open positions
Qty Precision	Decimal places for order quantity (required by Binance per symbol)
Monitor Interval (s)	How often the monitor checks price and evaluates signals
Dashboard Refresh (s)	How often the dashboard auto-refreshes

6. User Journeys

First-time Setup

Configure trading parameters in the Settings panel and click Save
Click 🔒 → log in → enter your Binance API keys for the appropriate mode
Switch to Testnet to run with paper funds first
Set trader mode to ▶ Active — the bot will begin monitoring immediately

Place a Manual Buy

Click + Buy in the Open Trades panel header
Confirm the symbol and enter the USDT amount
Click Buy at Market — order is placed at the current live price

Close a Trade Manually

Find the trade in the Open Trades table
Click Sell — a confirmation dialog shows the estimated PnL
Confirm to place a market sell order immediately

Pause or Stop Trading

⏸ Soft Pause — blocks new buys; open trades continue to be monitored and will exit via SL/TP automatically
⏹ Hard Stop — suspends all trading immediately; open positions are frozen and require manual action to close

Interpret P&L

Use the date filter bar to compare performance across different periods
P&L = sum of all closed trade profits minus losses (Binance fees not yet deducted — see open backlog item)
Win Rate = TP exits ÷ total closed trades
Unrealized P&L on the Open Trades card uses the current live price and updates every refresh