Advanced Trade Signals

TradeStaq supports advanced signal types for sophisticated trading strategies including trailing stops, DCA, grid trading, and more.

Signal Types Overview

Basic Signals

Long Entry

// Simple market buy
td.trade.buy({
    amountPercent: 50,
    stopLoss: td.market.price * 0.98,
    takeProfit: td.market.price * 1.06,
    reason: 'RSI oversold'
});

// Short entry
td.trade.sell({
    amountPercent: 50,
    stopLoss: td.market.price * 1.02,
    takeProfit: td.market.price * 0.94,
    reason: 'RSI overbought'
});

Trailing Stop Entries

Enter with an automatic trailing stop that follows price.

Usage

// Trailing with percentage and activation
td.trade.buyTrail({
    amountPercent: 50,
    trailPercent: 2,              // Trail 2% behind price
    activationPercent: 0.5,       // Start trailing after 0.5% profit
    stopLoss: 49000,              // Initial SL before trail activates
    reason: 'Trend entry with trail'
});

// OR with fixed trail amount
td.trade.buyTrail({
    amount: 0.1,
    trailAmount: 500,             // Trail $500 behind price
    reason: 'Fixed trail entry'
});

// Short with trailing
td.trade.sellTrail({
    amountPercent: 50,
    trailPercent: 2,
    activationPercent: 1.0,       // Start after 1% profit
    reason: 'Short with trail'
});

Parameters

How Trailing Works

Long Position with 2% Trail:
─────────────────────────────────────────────────
Entry: $50,000 → Initial Stop: $49,000 (2% below)
Price rises to $52,000 → Stop moves to $50,960
Price rises to $55,000 → Stop moves to $53,900
Price falls to $53,900 → STOP TRIGGERED
─────────────────────────────────────────────────
Profit locked: $3,900 (7.8%)

Risk-Based Position Sizing

Automatically calculate position size based on account risk.

Usage

td.trade.buyRisk({
    riskPercent: 2,               // Risk 2% of account
    stopLoss: td.market.price * 0.97,  // 3% stop loss
    takeProfit: td.market.price * 1.06,
    reason: 'Risk-based entry'
});

How It Works

// The system calculates:
const accountBalance = td.account.balance;              // $10,000
const riskAmount = accountBalance * (riskPercent / 100); // $200
const stopLossDistance = entryPrice - stopLossPrice;     // $1,500
const positionSize = riskAmount / stopLossDistance;      // 0.133 BTC

// If stopped out, you lose about $200 (2% of account) before fees and slippage

Leverage does not change the size: it changes the margin the position holds, not what the stop loses. Backtests size the same way.

Parameters

ATR-Based Stops

Set stop loss and take profit based on ATR (Average True Range).

Usage

td.trade.buyAtr({
    amountPercent: 50,
    atrMultiplierSL: 1.5,         // Stop Loss = Entry - (1.5 × ATR)
    atrMultiplierTP: 3.0,         // Take Profit = Entry + (3.0 × ATR)
    reason: 'ATR-based entry'
});

How It Works

// Example with ATR = $1,000, Entry = $50,000
const atr = td.indicators.atr;                    // $1,000
const stopLoss = entryPrice - (atr * 1.5);        // $48,500
const takeProfit = entryPrice + (atr * 3.0);      // $53,000

// Risk:Reward = 1:2 (risking 1.5 ATR for 3.0 ATR)

Parameters

Benefits

• Stops adapt to market volatility
• Wider stops in volatile markets
• Tighter stops in calm markets
• Consistent risk/reward ratio

Dollar-Cost Averaging (DCA)

Enter positions gradually at multiple price levels.

Usage

td.trade.dcaBuy({
    totalAmount: 1.0,             // Total 1 BTC across all levels
    dcaLevels: 4,                 // Split into 4 entries
    dcaSpread: 2,                 // 2% between each level
    stopLoss: td.market.price * 0.92,  // Overall stop
    reason: 'DCA entry'
});

How It Works

Entry Price: $50,000
DCA Levels: 4
DCA Spread: 2%
Total Amount: 1 BTC
─────────────────────────────────────────────────
Level 1: 0.25 BTC @ $50,000 (entry)
Level 2: 0.25 BTC @ $49,000 (-2%)
Level 3: 0.25 BTC @ $48,020 (-4%)
Level 4: 0.25 BTC @ $47,060 (-6%)
─────────────────────────────────────────────────
Average Entry: $48,520 (if all levels fill)

Parameters

Scale Out (Progressive Profit Taking)

Take profits at multiple levels as price moves in your favor.

Usage

// After entry, set up scale out
td.trade.scaleOut({
    scaleOutTargets: [
        { percent: 25, price: td.position.entryPrice * 1.02 },  // 25% at +2%
        { percent: 25, price: td.position.entryPrice * 1.04 },  // 25% at +4%
        { percent: 25, price: td.position.entryPrice * 1.06 },  // 25% at +6%
        { percent: 25, price: td.position.entryPrice * 1.10 },  // 25% at +10%
    ],
    reason: 'Progressive profit taking'
});

Parameters

Scale Out Target

Grid Trading

Place buy and sell orders at regular intervals within a range.

Usage

td.trade.grid({
    gridLevels: 10,               // 10 grid levels
    gridSpacing: 1,               // 1% between levels
    gridUpperBound: td.market.price * 1.05,
    gridLowerBound: td.market.price * 0.95,
    amountPercent: 50,            // Use 50% of balance for grid
    reason: 'Grid trading range'
});

How It Works

Upper Bound: $52,500
Lower Bound: $47,500
Levels: 10
─────────────────────────────────────────────────
$52,500 ─── Sell order
$52,000 ─── Sell order
$51,500 ─── Sell order
$51,000 ─── Sell order
$50,500 ─── Sell order
───────────  Current Price: $50,000
$49,500 ─── Buy order
$49,000 ─── Buy order
$48,500 ─── Buy order
$48,000 ─── Buy order
$47,500 ─── Buy order
─────────────────────────────────────────────────

Parameters

Position Management Signals

Flip (Reverse Position)

Close current position and open opposite.

td.trade.flip({
    reason: 'Trend reversal detected'
});

// Equivalent to:
// 1. Close current long
// 2. Open new short of same size

Hedge Position

Open an opposite leg without closing the main position. Requires an exchange account in hedge mode, and the hedge must be opted into explicitly (opposite-side entries are refused by default so a bot never accidentally holds both directions).

td.trade.hedge({
    percent: 50,                  // Hedge 50% of position
    reason: 'Hedging before news'
});

// Or opt a normal entry into hedging with the hedge:true flag:
td.trade.sell({ amountPercent: 50, hedge: true, reason: 'hedge the long' });

After both legs are open, read each with td.position.long / td.position.short. On a one-way account a hedge request is ignored.

Move to Breakeven

Move stop loss to entry price after reaching profit target.

td.trade.breakeven({
    breakevenTrigger: 2,          // Trigger at 2% profit
    breakevenOffset: 0.1,         // Small offset (0.1% profit locked)
    reason: 'Moving to breakeven'
});

Lock Profits (Progressive Stop)

Move stop loss up as profits increase.

td.trade.lockProfits({
    lockProfitStep: 1,            // Move SL every 1% profit
    lockProfitTrail: 0.5,         // Trail 0.5% behind current price
    reason: 'Locking profits'
});

Advanced Exit Signals

Trailing Exit

Set up a trailing stop that follows price and closes the position when triggered.

td.trade.closeTrail({
    trailPercent: 1.5,
    activationPercent: 1.0,  // Activate after 1% profit
    reason: 'Trailing exit'
});

Check Before Setting (Recommended)

To avoid duplicate signals when closeTrail is called on every spin, check if trailing is already configured:

// Only set up trailing if not already configured
if (td.position.hasPosition && !td.position.trailingStop?.enabled) {
    td.trade.closeTrail({
        trailPercent: 1.5,
        activationPercent: 1.0,
        reason: 'Setting up trailing stop'
    });
}

// Or check if trail has already activated
if (td.position.trailingStop?.activated) {
    td.utils.log('Trail active at', td.position.trailingStop.highWaterMark);
}

Trailing Stop Properties

Access trailing stop state via td.position.trailingStop:

Stepped Exit

td.trade.closeSteps({
    closeSteps: [
        { percent: 33, afterCandles: 24 },    // 33% after 24 candles
        { percent: 33, afterSeconds: 3600 },  // 33% after 1 hour
        { percent: 34, atPrice: targetPrice }, // Rest at target
    ],
    reason: 'Systematic exit plan'
});

Time-Based Exit

td.trade.closeAfter({
    closeAfterCandles: 48,        // Close after 48 candles
    reason: 'Time limit reached'
});

// OR
td.trade.closeAfter({
    closeAfterSeconds: 86400,     // Close after 24 hours
    reason: 'Daily trade limit'
});

Alerts

Send notifications without executing trades.

td.trade.alert({
    level: 'warning',             // info, warning, error
    title: 'RSI Oversold',
    message: `RSI reached ${td.indicators.rsi.toFixed(2)}`,
    data: {
        rsi: td.indicators.rsi,
        price: td.market.price,
        timestamp: Date.now()
    }
});

Alert Levels

Complete Strategy Example

// Multi-feature strategy combining advanced signals

// Helper to get custom indicator value safely
function getIndicator(key) {
    const val = td.indicators.custom[key];
    if (val === undefined || val === null) return 0;
    if (Array.isArray(val)) return val[val.length - 1];
    return val;
}

const rsi = td.indicators.rsi;
const atr = td.indicators.atr;
const ema9 = getIndicator('ema_9');
const ema21 = getIndicator('ema_21');

// Track previous values for crossover detection
const prevEma9 = td.state.get('prevEma9', ema9);
const prevEma21 = td.state.get('prevEma21', ema21);
td.state.set('prevEma9', ema9);
td.state.set('prevEma21', ema21);

// Entry logic with risk-based sizing
if (!td.position.hasPosition) {
    // Bullish setup - EMA crossover
    const emaCrossUp = prevEma9 <= prevEma21 && ema9 > ema21;
    if (rsi < 35 && emaCrossUp) {
        // Risk-based entry with ATR stops
        const stopLoss = td.market.price - (atr * 1.5);
        const takeProfit = td.market.price + (atr * 3);

        td.trade.buyRisk({
            riskPercent: 2,
            stopLoss,
            takeProfit,
            reason: 'RSI oversold + EMA crossover'
        });

        // Set up scale out after entry
        td.state.set('pendingScaleOut', true);
    }
}

// Position management
if (td.position.hasPosition && td.position.side === 'long') {
    const profitPercent = td.position.pnlPercent;

    // Setup scale out targets
    if (td.state.get('pendingScaleOut') && profitPercent > 0) {
        td.trade.scaleOut({
            scaleOutTargets: [
                { percent: 33, price: td.position.entryPrice * 1.03 },
                { percent: 33, price: td.position.entryPrice * 1.05 },
                { percent: 34, price: td.position.entryPrice * 1.08 },
            ]
        });
        td.state.set('pendingScaleOut', false);
    }

    // Move to breakeven at 2% profit
    if (profitPercent >= 2 && !td.state.get('atBreakeven')) {
        td.trade.breakeven({
            breakevenOffset: 0.1,
            reason: 'Securing entry'
        });
        td.state.set('atBreakeven', true);
    }

    // Lock profits progressively after 3%
    if (profitPercent >= 3) {
        td.trade.lockProfits({
            lockProfitStep: 1,
            lockProfitTrail: 0.5
        });
    }

    // Alert on significant profit
    if (profitPercent >= 5 && !td.state.get('alertedProfit')) {
        td.trade.alert({
            level: 'info',
            title: 'Position +5%',
            message: `Position is up ${profitPercent.toFixed(2)}%`
        });
        td.state.set('alertedProfit', true);
    }
}

Next Steps

• Multi-Timeframe Analysis - Use multiple timeframes
• Risk Management - Bot-level risk controls
• Testing Strategies - Validate before live
• Order Types - Detailed order reference