Getting Started with Shisha Traders

Server Mode (API Execution)

~100-300ms latency

• Trades are executed directly through the broker's API -- the fastest method available
• Orders are submitted programmatically without any UI interaction
• This is considered automated trading by brokers and prop firms
• Best for: Brokers and firms that explicitly allow automated/API-based trading (e.g., TopStepX, personal Tradovate accounts)

Stealth Mode (DOM Automation)

~500-1000ms initially, speeds up over time

• Trades are executed by simulating real human interactions on the broker's trading interface (DOM/order ladder)
• The app mimics actual clicking and typing behavior -- indistinguishable from manual trading
• Classified as manual trading by all prop firms, even though it is fully automated on your end
• Best for: Prop firms that prohibit bots or automated trading -- Stealth Mode keeps you compliant with their rules
• Speed improves significantly after the first few trades as the system optimizes and caches interface elements

Quantity Multiplier

The quantity multiplier lets you scale the number of contracts traded. If your incoming signal says to trade 1 contract and your multiplier is set to 2x, the app will trade 2 contracts. If the multiplier is 3x, it trades 3 contracts -- and so on.

This is useful for scaling the same strategy across different account sizes without modifying your TradingView alerts:

• 50K account = 1x multiplier (1 contract)
• 100K account = 2x multiplier (2 contracts)
• 150K account = 3x multiplier (3 contracts)

Core Settings

Stop Loss (in ticks)

How many ticks away from your entry price to place your protective stop order. For example, if you enter a Long at 20,000 with a 10-tick stop loss, your stop is placed at 19,990.

Take Profit (in ticks)

How many ticks away from your entry price to place your profit target. Using the same example, a 20-tick take profit places your target at 20,020.

Default Quantity

The number of contracts traded per signal. This is the base quantity before the multiplier is applied.

Signal Management

Signal management controls what happens when a new signal arrives while you already have an open position. There are four modes:

Trading Window

Restrict when your strategy is allowed to accept and execute signals. Any signals received outside the trading window are silently ignored.

• Set a start time and end time (e.g., 9:30 AM to 3:30 PM)
• Choose the timezone (e.g., America/New_York, America/Chicago)
• Select which days of the week the strategy should be active

Trades outside this window are ignored -- your strategy only operates during the hours you define.

Auto-Flatten at Market Close

When enabled, the app automatically closes all open positions before the market closes. This eliminates overnight risk and is essential for:

• Day traders who never hold positions overnight
• Prop firm compliance -- many firms penalize or disqualify traders who hold through the close

The flatten occurs at a configurable time before the market session ends, ensuring your positions are closed cleanly.

Partial Take Profits

Instead of closing your entire position at a single take profit level, partial TPs let you split your exit into multiple levels using R-multiples (risk-to-reward ratios).

How R-Multiples Work

Your Stop Loss distance equals 1R (one unit of risk). Each partial take profit level is defined as a multiple of that risk distance.

Each level's R-multiple and quantity (number of contracts to close) can be configured independently, giving you full control over your exit strategy.

Auto Breakeven

After price moves a specified distance in your favor, the app automatically moves your stop loss to breakeven (your entry price). This eliminates risk on the trade once it has moved into profit.

• Trigger Distance: How far price must move in your favor (in ticks) before the breakeven is activated
• Once triggered, your stop is moved to your entry price -- the trade becomes risk-free
• You can optionally set a small offset (e.g., +2 ticks above entry) to lock in a tiny profit instead of exact breakeven

Auto Trailing Stop

A dynamic stop loss that automatically follows price as it moves in your favor. Instead of a fixed stop, the trailing stop ratchets up (for longs) or down (for shorts) to protect your growing profits.

Save and Activate Your Strategy

Set Up the Alert in TradingView

Using Text Keywords (Dumb) Mode?

If your strategy uses the Text Keywords indicator mode, you need to create two separate alerts in TradingView -- one for each direction:

• Alert 1 (Long signals): Set the condition to your indicator's bullish signal. The message should contain your long keyword (e.g., +BB).
• Alert 2 (Short signals): Set the condition to your indicator's bearish signal. The message should contain your short keyword (e.g., -BB).

Make sure both keywords are mapped in your strategy's keyword configuration (Long direction for +BB, Short direction for -BB, etc.). Both alerts should use the same Webhook URL.

Full JSON Mode -- Implementing in PineScript

For the Full JSON (Smart) indicator mode, your PineScript indicator must output a JSON string in the alert message. This gives you complete control -- your indicator decides the action, quantity, contract, stop loss, and take profit for every trade.

JSON Structure

{
  "action": "buy" or "sell",
  "contracts": 1,
  "ticker": "MNQ",
  "sl": 10,
  "tp": 20
}

Example PineScript Implementation

// Example PineScript JSON alert
alertMessage = '{"action": "' + (longCondition ? "buy" : "sell") + '", "contracts": 1, "ticker": "MNQ", "sl": 10, "tp": 20}'

if longCondition
    alert(alertMessage, alert.freq_once_per_bar)
if shortCondition
    alert(alertMessage, alert.freq_once_per_bar)

The app parses this JSON and executes exactly what your indicator specifies. Your PineScript indicator has full control over every parameter of the trade.

Text Keywords Mode -- Finding Placeholders

Many TradingView indicators already have built-in alert placeholders and keywords. You do not need to write any code -- just find the keywords your indicator uses and map them in the app.

How to Find Your Indicator's Keywords

Mapping Keywords in the App

In your strategy's keyword mapping configuration:

• Add +BB and map it to Long
• Add -BB and map it to Short

You can use any text your indicator outputs -- custom words, symbols, abbreviations -- as long as you map each one to a direction (Long or Short) in the app.