Technical Documentation
A complete reference for every parameter in BinanceTrader. The bot is split into two configuration files: filters.json (entry conditions) and strategy.json (position management and exits). Understanding these values is critical to building a profitable strategy.
The data engine snapshots all active USDT spot pairs on Binance every 30 seconds, calculating price changes across 8 time windows (M1 → H4) and volume/order book metrics per symbol. Entry filters are evaluated against these snapshots in real time.
1. Entry Filters
A symbol must pass all active filters simultaneously to be flagged as a signal. Configure these in the Entry Filters tab. Signals appear in the Signal Feed and may trigger a simulated buy.
Filters symbols by their total 24-hour trading volume in USDT.
— Min: Excludes illiquid or dead pairs. A minimum of 500,000 USDT is a reasonable starting point.
— Max: Optionally caps volume to avoid large-cap coins that tend to move slowly. Leave at 0 to disable.
Price change over the last 5 minutes.
— Min: The primary momentum trigger. A value of +1.0% to +2.0% ensures the coin is actively moving up.
— Max: Prevents buying into a coin that has already spiked excessively.
Price change over the last 3 minutes. A shorter confirmation window than M5. Useful for catching faster breakouts earlier. Leave empty to disable.
Price change over the last 1 hour. Provides macro context for the 5-minute move. Setting a max of +8% avoids coins that have already run hard in the last hour.
Excludes coins whose H1 change falls within this range. With Lo=0 and Hi=3, any coin up between 0% and 3% in the last hour is skipped — avoiding slow, sideways movers.
Minimum USDT volume traded in the last 5 minutes. Confirms there is active participation behind the move, not just a price change on thin volume.
Bid quantity divided by ask quantity at the best price. A value above 1.0 means more buy interest than sell interest. Setting a minimum of 0.8–1.0 filters for coins where buyers are in control.
Maximum allowed bid-ask spread. A tight spread (<0.15%) indicates a liquid market where your simulated fill price closely matches the displayed price.
Compares recent volume rate (5m normalized) to longer-term rate (30m normalized). A value of 1.5 means volume is flowing in 50% faster than its 30-minute baseline — a key early breakout indicator.
How far the current price is below the 24-hour high. A value of -10 means the coin must be at least 10% below its 24h high. Avoids buying at or near the daily peak.
Minimum distance above the 24-hour low. Ensures the coin has recovered meaningfully from its daily low before entry.
2. Strategy Parameters
Configure these in the Strategy tab. Controls position sizing, capital allocation, and fee simulation.
Your virtual starting balance for the paper trading session. Used as the baseline for ROI calculations and session-level stop loss / take profit checks.
The fixed USDT amount allocated to each simulated buy. Keep small enough relative to your balance to allow multiple concurrent positions.
Maximum simultaneous open positions. Once reached, new signals are logged in the Signal Feed but no new trades open until an existing position closes.
The Binance taker fee applied to both simulated buys and sells. Deducted automatically from every trade's P&L so results reflect real-world net returns.
3. Exit Logic
All exit rules are evaluated every 5 seconds per open position. The first rule that triggers closes the position immediately.
Hard take profit target. When the position's unrealised gain reaches this percentage, the position closes immediately and the profit is locked in.
Primary downside protection. If the position drops this percentage below entry at any point, it closes immediately.
The profit level at which the trailing stop activates. Until this threshold is reached, only the hard SL and take profit are active.
Once the trailing stop is active, the maximum allowed retracement from the highest price reached. Example: activation +2%, distance 1.5% — if price hits +5% then drops to +3.5%, the position closes at +3.5%.
Maximum hold time per position. If no exit rule triggers after this many minutes, the position force-closes at current market price.
A secondary, tighter stop loss that activates only after N minutes without reaching the trailing activation target. Effectively: "if this hasn't moved in 10 minutes, exit at -0.5%."
4. Session Controls
Session-level safety mechanisms that operate across all positions.
If the overall session balance drops by this percentage from the starting balance, the bot stops opening new positions and closes all open ones.
If the overall session balance grows by this percentage, the bot stops and closes all positions. Useful for locking in a daily target.
Minimum wait time before re-entering the same symbol after a close. Prevents chasing a falling knife after a stop loss.
5. Integrations
Optional external connections. The bot runs fully without these — they are for notification and remote control only.
The API token for your Telegram bot, obtained from @BotFather. Create a new bot with /newbot and copy the token it provides.
The destination for all bot messages. Start a conversation with your bot, then use @userinfobot to find your Chat ID. Commands supported: /status, /pause, /resume, /closeall.