Trend Scalper Strategy Documentation
Version: v0.0.3
Developer: TradeStaq Technologies
Market: Futures
Table of Contents
- Overview
- Key Features
- Configuration Parameters
- Strategy Logic Summary
- Trading Scenarios
- Strategic Mastery & Success Guide
Overview
Trend Scalper is a precision-focused strategy designed to eliminate noise and trade only when high-probability market conditions are met. Unlike spray-and-pray bots, it utilizes a proprietary "Sniper Score" engine that aggregates multiple layers of market data—including momentum, trend strength, and volatility—into a single actionable signal.
Its defining feature is the Conditional Risk Logic. Instead of blindly stopping out at a fixed percentage, Trend Scalper analyzes the context of the drawdown. It distinguishes between a "temporary wick" (where it holds) and a "trend reversal" (where it force-exits), drastically reducing premature stop-losses while protecting capital from catastrophic moves.
Key Features
- Proprietary Sniper Engine: A composite scoring system (0-5) that evaluates hidden market flows, trend exhaustion, and volume anomalies before entering.
- Conditional Stop Loss: A smart defensive layer that only executes a Stop Loss if the price is below your threshold AND the internal algorithm confirms a true trend reversal.
- Force Exit Protocol: A "panic button" that bypasses all profit/loss checks to immediately close a position if the algorithm detects a violent market shift.
- Macro Bias Filter: Automatically aligns trades with the higher timeframe trend to prevent trading against the dominant market flow.
- Enhanced Visual Dashboard: Displays real-time Sniper Scores, Market Bias, and detailed Position Data. The interface now provides separated fields for
ENTRY PRICE,LIQ PRICE,LEVERAGE, andWALLETfor absolute clarity. - Execution Guardrails: Includes granular controls over entry timing, such as bar-close enforcement and time-windows to avoid mid-candle volatility.
Configuration Parameters
The following settings can be configured in your config.js or via the Gunbot GUI "Override" menu.
1. Trade Configuration
Core settings defining direction and sizing.
| Parameter | Default | Description & Examples |
|---|---|---|
| TRADE_MODE | AUTO | Direction Control. AUTO: Takes Longs or Shorts based on algorithm signals. LONG: Only takes Longs. SHORT: Only takes Shorts. |
| TRADING_LIMIT_TYPE | value | Sizing Model. Select value for fixed quote amount or percentage to scale automatically based on your Wallet Balance. |
| MF_TRADING_LIMIT | 10 | Position Size. The quote currency amount (if value) or % of balance (if percentage) used for the entry. |
| OPEN_ORDER_TYPE | QUOTE | Entry Currency. QUOTE uses USDT amount; BASE uses Coin amount. |
| CLOSE_ORDER_TYPE | QUOTE | Exit Currency. QUOTE is recommended for linear contracts. |
| MIN_VOLUME_TO_SELL | 1 | Dust Filter. Minimum value ($) required to attempt a sell. Prevents errors on tiny dust balances. |
2. Sniper Entry Filters
Controls the strictness of the "Sniper Score" engine.
| Parameter | Default | Description & Examples |
|---|---|---|
| SNIPER_CONF | 4 | Min Confluence. The minimum score (0-5) required to open a trade. Higher = Fewer, safer trades. Lower = More aggressive. |
| SNIPER_USE_VOL | false | Activity Filter. If true, requires a surge in market activity to enter. |
| SNIPER_USE_ADX | false | Strength Filter. If true, requires Trend Strength to be above the threshold. |
| SNIPER_ADX_LVL | 20 | Strength Threshold. The minimum trend strength value required if SNIPER_USE_ADX is enabled. |
| SNIPER_USE_HTF | true | Macro Bias. If true, checks the Higher Timeframe Trend. It will NOT go Long if Macro Trend is Bearish. |
| SNIPER_SUPER_ATR | 10 | HTF Sensitivity. Controls the sensitivity of the macro trend calculation. |
| SNIPER_SUPER_FACTOR | 3 | HTF Factor. Multiplier for the macro trend detection. 3 is standard for detecting major trends. |
| RSI_BUY_LEVEL | 30 | Oversold Limit. Prevents Shorting into a bottom. |
| RSI_SELL_LEVEL | 70 | Overbought Limit. Prevents Longing into a top. |
3. Conditional Risk & Exits
The heart of the strategy: Logic for managing losses and protecting gains.
| Parameter | Default | Description & Examples |
|---|---|---|
| ENABLE_STOP_LOSS | true | Master Switch. Enables the Conditional Stop Loss logic. |
| SL_CONF_REQ | 3 | Conditional Trigger. The opposing score required to confirm a Stop Loss. Example: If Price hits SL, but opposing score is only 1, it HOLDS. If score becomes 3, it EXITS. |
| FORCE_EXIT_REQ | 4 | Panic Trigger. The opposing score that forces an immediate close, regardless of PnL. Example: If you are Long, but Short Score hits 4, it closes immediately to prevent liquidation. |
| SL_MODE | ATR | SL Type. ATR: Calculates SL distance based on market volatility. Percentage: Uses fixed %. |
| SL_VAL | 2.0 | SL Distance. If Mode is ATR, this is the multiplier (2x Volatility). If Mode is %, this is the raw percent (2%). |
| TP_MODE | ATR | TP Type. ATR (Volatility based) or Percentage (Fixed). |
| TP_VAL | 1.5 | TP Distance. Target profit distance. Example: 1.5x Volatility is a standard scalp target. |
| MIN_PROFIT_FLOOR | 1 | Minimum Gain. Ensures the target is never less than this % (useful when volatility is very low). |
4. Trailing & Automation
Settings to maximize profit runs.
| Parameter | Default | Description & Examples |
|---|---|---|
| ENABLE_TRAILING | true | Trailing Switch. If true, uses a trailing stop to exit instead of a fixed Take Profit limit order. |
| TRAILING_START | 0.5 | Activation Point. The ROE % required to start trailing. Example: Start trailing once we are 0.5% in profit. |
| TRAILING_SPREAD | 0.2 | Trail Distance. The callback %. Example: If price drops 0.2% from the peak, sell. |
| PERIOD | 240 | Timeframe. Timeframe (in minutes) used for trend calculation (Default 240m = 4h). |
| PERIOD_MEDIUM | 1440 | Macro Timeframe. Timeframe (in minutes) used for Macro Bias calculation (Default 1440m = 1 Day). |
| ENTRY_ON_CLOSE | true | Bar Close Entry. If true, the bot only opens new positions when a candle closes. Set to false for mid-candle "every tick" entries. |
| ALLOW_SAME_CANDLE_REENTRY | true | TV Mode Re-entry. If true, allows the bot to re-enter a trade immediately after a full exit within the same bar. |
| ENTRY_WINDOW_MINS | 5 | Entry Depth. Max minutes allowed into a new bar for a brand-new entry. Prevents chasing late signals. (Set to 0 to disable). |
| REENTRY_WINDOW_MINS | 30 | Re-entry Depth. Max minutes allowed into a bar for a re-entry (TV Mode). Prevents re-entering into a dying move. (Set to 0 to disable). |
[!TIP] Precision Trading: Use
ENTRY_WINDOW_MINS(e.g., 5 mins) on higher timeframes like 1H or 4H. This ensures the bot only "snipes" the high-probability move right at the candle open and avoids chasing noise mid-candle.
Strategy Logic Summary
- Sniper Scoring: Every tick, the bot calculates a Score (0-5) for both Long and Short directions using a proprietary blend of Volume Analysis, Trend Flow, and Momentum Oscillators. It does not rely on a single indicator but requires a "Confluence" of factors to generate a signal.
- Entry Execution: A trade is entered only if:
- Score >= SNIPER_CONF (Default 4).
- Market Strength and Volume filters pass (if enabled).
- Macro Bias confirms the direction (Trend Alignment).
- Exit Hierarchy:
- Priority 1 (Force Exit): If Opposing Score >= FORCE_EXIT_REQ, close immediately. (Trend Reversal Protection).
- Priority 2 (Conditional SL): If Price <= SL Level AND Opposing Score >= SL_CONF_REQ, close. (Confirmed Loss).
- Priority 3 (Trailing/TP): If Price >= TP Level, engage trailing stop logic.
Trading Scenarios
Scenario A: The "Fakeout" Wick (Holding the Bag)
- Condition: You are Long. The asset suddenly wicks down -2% due to a large market sell order, hitting your SL price. However, the internal algorithm determines the underlying trend is still intact (Score is low).
- Bot Action: The bot sees the price is below SL, but Opposing Score (1) < SL_CONF_REQ (3).
- Result: It HOLDS the position. The price snaps back up as the wick is bought up, and the trade eventually closes in profit. (Standard bots would have stopped out).
Scenario B: The Trend Reversal (Force Exit)
- Condition: You are Long. Slowly, the market structure shifts. Momentum flips bearish, and selling pressure increases.
- Bot Action: The Score_S (Short Score) climbs to 4 based on the algorithm's detection of the shift.
- Result: The bot triggers a FORCE EXIT immediately. It does not wait for the price to hit the Stop Loss level. It cuts the trade early to prevent a larger drawdown.
Scenario C: The Sniper Entry
- Condition: Market is quiet. Suddenly, the algorithm detects a confluence of Volume and Momentum aligning with the Macro Trend.
- Bot Action: Score_L hits 4.
- Result: The bot fires a Sniper Long entry immediately at the breakout point, riding the momentum up.
Strategic Mastery & Success Guide
- Risk vs. Reward: The default SL_VAL is 2.0 ATR and TP_VAL is 1.5 ATR. This gives the bot room to breathe. Do not set SL too tight (e.g., 0.5%) when using Conditional Logic, or you will negate its benefits.
- The "Force" Setting: If you find the bot is exiting too early on chop, increase FORCE_EXIT_REQ to 5. This will strictly require every factor in the algorithm to flip before force-closing.
- Timeframe Selection: This strategy works best on 15m candles (PERIOD in Gunbot config) with a 1h or 4h HTF Bias (PERIOD_MEDIUM). Avoid using it on 1m candles unless SNIPER_CONF is set to 5 (Max Strictness).
- Visual Debugging: Always open the Gunbot GUI Chart. Look at the Sidebar.
- If "Risk Mode" says CONDITIONAL, the logic is active.
- Watch the "Opposing Conf" stars. If you are Long, and you see 3 Red Stars appear, prepare for a Conditional Stop.