Trend Scalper Strategy Documentation

Version: v0.0.3

Developer: TradeStaq Technologies

Market: Futures

Table of Contents

  1. Overview
  2. Key Features
  3. Configuration Parameters
  4. Strategy Logic Summary
  5. Trading Scenarios
  6. 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, and WALLET for 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.

ParameterDefaultDescription & Examples
TRADE_MODEAUTODirection Control. AUTO: Takes Longs or Shorts based on algorithm signals. LONG: Only takes Longs. SHORT: Only takes Shorts.
TRADING_LIMIT_TYPEvalueSizing Model. Select value for fixed quote amount or percentage to scale automatically based on your Wallet Balance.
MF_TRADING_LIMIT10Position Size. The quote currency amount (if value) or % of balance (if percentage) used for the entry.
OPEN_ORDER_TYPEQUOTEEntry Currency. QUOTE uses USDT amount; BASE uses Coin amount.
CLOSE_ORDER_TYPEQUOTEExit Currency. QUOTE is recommended for linear contracts.
MIN_VOLUME_TO_SELL1Dust 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.

ParameterDefaultDescription & Examples
SNIPER_CONF4Min Confluence. The minimum score (0-5) required to open a trade. Higher = Fewer, safer trades. Lower = More aggressive.
SNIPER_USE_VOLfalseActivity Filter. If true, requires a surge in market activity to enter.
SNIPER_USE_ADXfalseStrength Filter. If true, requires Trend Strength to be above the threshold.
SNIPER_ADX_LVL20Strength Threshold. The minimum trend strength value required if SNIPER_USE_ADX is enabled.
SNIPER_USE_HTFtrueMacro Bias. If true, checks the Higher Timeframe Trend. It will NOT go Long if Macro Trend is Bearish.
SNIPER_SUPER_ATR10HTF Sensitivity. Controls the sensitivity of the macro trend calculation.
SNIPER_SUPER_FACTOR3HTF Factor. Multiplier for the macro trend detection. 3 is standard for detecting major trends.
RSI_BUY_LEVEL30Oversold Limit. Prevents Shorting into a bottom.
RSI_SELL_LEVEL70Overbought Limit. Prevents Longing into a top.

3. Conditional Risk & Exits

The heart of the strategy: Logic for managing losses and protecting gains.

ParameterDefaultDescription & Examples
ENABLE_STOP_LOSStrueMaster Switch. Enables the Conditional Stop Loss logic.
SL_CONF_REQ3Conditional 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_REQ4Panic 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_MODEATRSL Type. ATR: Calculates SL distance based on market volatility. Percentage: Uses fixed %.
SL_VAL2.0SL Distance. If Mode is ATR, this is the multiplier (2x Volatility). If Mode is %, this is the raw percent (2%).
TP_MODEATRTP Type. ATR (Volatility based) or Percentage (Fixed).
TP_VAL1.5TP Distance. Target profit distance. Example: 1.5x Volatility is a standard scalp target.
MIN_PROFIT_FLOOR1Minimum Gain. Ensures the target is never less than this % (useful when volatility is very low).

4. Trailing & Automation

Settings to maximize profit runs.

ParameterDefaultDescription & Examples
ENABLE_TRAILINGtrueTrailing Switch. If true, uses a trailing stop to exit instead of a fixed Take Profit limit order.
TRAILING_START0.5Activation Point. The ROE % required to start trailing. Example: Start trailing once we are 0.5% in profit.
TRAILING_SPREAD0.2Trail Distance. The callback %. Example: If price drops 0.2% from the peak, sell.
PERIOD240Timeframe. Timeframe (in minutes) used for trend calculation (Default 240m = 4h).
PERIOD_MEDIUM1440Macro Timeframe. Timeframe (in minutes) used for Macro Bias calculation (Default 1440m = 1 Day).
ENTRY_ON_CLOSEtrueBar 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_REENTRYtrueTV Mode Re-entry. If true, allows the bot to re-enter a trade immediately after a full exit within the same bar.
ENTRY_WINDOW_MINS5Entry Depth. Max minutes allowed into a new bar for a brand-new entry. Prevents chasing late signals. (Set to 0 to disable).
REENTRY_WINDOW_MINS30Re-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

  1. 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.
  2. 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).
  3. 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.