User Manual

Professional Reference Guide v3.1.1

User Manual & Platform Guide

Welcome to the Cloud Trader Pro documentation portal. This user guide contains detailed operational walkthroughs, settings guides, and risk-management instructions to help you run options scalping and algorithmic trading strategies on the dashboard.

Platform Overview & Architecture

Cloud Trader Pro is a secure, decoupled algo trading platform and options scalping tool built for Flattrade, Shoonya, and Upstox. Designed for active retail traders in India, it connects broker APIs directly to your private cloud VPS or local machine. Automate Nifty, Bank Nifty, and Sensex index options trading with auto SL/target, trailing stop-loss, bracket orders, and multi-leg straddle or strangle execution with zero latency while simplifying SEBI IP compliance.

Decoupled Web-Native Execution

Unlike browser-dependent setups that crash or freeze during high volatility, Cloud Trader Pro maintains all positions, trailing stop-losses, and strategy decisions in server memory. If your internet disconnects, your laptop battery dies, or your browser is closed, the backend server continues managing your exits and target orders automatically.

Supported Trading Indices

The platform supports high-speed calculations, option chains, and automated execution for the following major Indian indices:

NSE Indices

Track premiums, Open Interest, and trade contracts for NIFTY, BANKNIFTY, FINNIFTY, and MIDCPNIFTY contracts with native NSE feeds.

BSE Indices

Fully compatible with BSE SENSEX and BANKEX contracts, managing strike offsets and trading calendars specific to BSE schedules.

Getting Started & Setup

Before deploying active trading algorithms or placing option orders, follow this step-by-step instructions checklist to activate and configure your system.

1
Enter License Key
If your system is newly installed or your key expired, the application boots in "Locked Setup Mode".
  • Open the dashboard URL in your browser. You will see an interactive License Activation Page.
  • Paste your cryptographically signed license key into the field.
  • Click Activate. The server will dynamically validate the key and unlock all features without requiring a server reboot.
2
Configure Broker Credentials & API Portals
Navigate to the Account page (using the gear icon in the sidebar). Select your active broker (Flattrade, Shoonya, or Upstox) and fill in your credentials: Client ID / API Key, API Secret, User ID, and Redirect URI.
Broker API Configuration Requirements:
  • Update Redirect URL: In your broker's developer console, set the redirect/callback URL exactly to:http://localhost:8002/api/auth/callback (for Flattrade and Upstox).
    For Shoonya, set the Redirect URL exactly to: https://cloudtraderpro.in/.
  • Custom Domain Notice:If you access the server using a custom domain name (such as mapping via a Cloudflare Tunnel or a remote VPS domain name setup), you MUSTreplace the localhost address above with your actual domain URL (e.g.https://yourdomain.com/api/auth/callback) inside the broker settings on their portal (does not apply to Shoonya if using standard redirects).
  • Update Registered IP: If your broker developer account restricts logins to registered IPs, ensure your server's public IP address is whitelisted in your developer portal. If running behind a Cloudflare Tunnel, the IP visible to the broker is the public IP of the host machine running the FastAPI backend.
3
Daily Broker Handshake Authorization
Stock exchanges require fresh API session tokens daily.
  • Every morning, prior to market open (09:15 AM IST), open the Accountpage.
  • Click the Generate Login URL or Login to Brokerbutton. This opens the broker portal login.
  • Authenticate with your broker.
  • For Flattrade / Upstox: Once successful, paste the returned authorization code or complete the verification.
  • For Shoonya: After logging in, the portal redirects you to the redirect page. Shoonya immediately strips the query code from the URL, so you must quickly copy the code parameter (e.g., ?code=xxxx...) directly from your browser's address bar after login and paste it into the authorization input.
  • A green indicator showing Connected will light up.
4
Verify Trading Margins
Open the Funds tab in your dashboard sidebar. Check the following:
  • Margin Available: The free cash balance available to open new options buyer or seller positions.
  • Margin Utilized: Tracks collateral blockages of open trades.
  • Ensure your available margin meets the requirements of the strategies you plan to start.

1. Monitor

The Monitor Tab is the main system screen of Cloud Trader Pro. It is designed to give you a consolidated, real-time view of your system health, active scripts, and cumulative daily trading results.

Key Components & Operations

1
Net Daily Profit & Loss (PnL) Counter
A large, highly visible counter at the top of the monitor display. It computes and shows the consolidated profit or loss across all running strategies and manual positions. The counter updates dynamically on every tick and is color-coded: green for positive PnL and red for negative PnL.
2
WebSocket Feed Status indicator
A color-coded indicator light indicating your connection state with the broker feed. A green light confirms that live market prices are successfully streaming into the backend server. A blinking red light signals that the connection is offline or authenticating.
3
Running Strategy Cards
Displays cards for all configured algorithmic strategies (e.g. Straddle, VWAP). Each card shows the strategy status (Running, Stopped, or Pending), current trade logs, active positions count, and includes buttons to Start or Force Stop the strategy immediately.

2. Scalp

The Scalp page is the manual trading terminal. It is optimized for high-speed option scalping with quick sizing forms and one-click panic exits.

Quick Sizing & Execution Pad

The order execution pad is built to place trades with minimal latency. It supports both buying and selling of ATM, ITM, and OTM option contracts.

SettingOperational Instructions
Product TypeSelect MIS for intraday margin trades (automatically squared off by the broker before market close) or NRML for carry-forward positions.
Order TypeSelect Market Protected (limit order placed with a 5% protection buffer to prevent slippage and exchange rejections) or Limit to specify an exact premium price.
Lot Size MultipliersSelect default multipliers (e.g. 1 Lot, 5 Lots,10 Lots, or Max) or enter a custom lot size manually to scale position entries.
Enable Delay SLToggle to arm Stop Loss spike protection for manual trades. If active, a momentarily breached SL will arm a timer instead of triggering an immediate exit, allowing the price to potentially recover.
Delay (seconds)Select the wait period (e.g., 3s to 10s) to wait during an SL breach before placing the exit order.
Force Execute (Extra Pts)Set a safety buffer beyond the SL price (e.g., 10 points). If option prices move beyond this limit, the system executes an immediate exit, bypassing the delay timer.

Panic Control Panel

In high-volatility environments, managing panic exits is critical. The right column of the scalp pad features global exit commands:

Exit All

Instantly sends exit orders for all open positions across all indices using market protection limit buffers, bypassing standard exit confirmation popups.

Squareoff CE / PE

Closes call option positions (CE) or put option positions (PE) separately to allow for quick trend adjustments.

Cancel Pending

Queries the broker API and cancels all open, unfilled limit orders in the system, preventing unexpected entries.

3. Strategies

The Strategies page acts as the central command center for deploying, duplicating, and managing automated trading engines. It provides a grid of cards showing each active or configured strategy runner instance.

Deploying and Managing Instances

You can deploy several different strategy instances running simultaneously on the server. For example, you can run a VWAP Trend Scalper on NIFTY and a Short Straddle Option Seller on BANKNIFTY concurrently.

Create Strategy

Click "Create Custom VWAP" or "Create Custom Straddle" to open the creation dialog. Assign a unique name (e.g. NIFTY 3m Breakout) to deploy the instance on the cloud server.

Configure & Clone

Use the CONFIGURE action on any strategy card to access its individual parameters. The CLONE action duplicates settings into a new instance to run on different expiries or lot sizes.

Running Status

Toggle instances online or offline. The server executes active strategies autonomously 24/7. Deleted instances are completely removed from memory and settings buffers.

4. Straddle

The Straddle page is the manual trading cockpit for executing and monitoring multi-leg options strategies. It allows you to place, trail, and exit Straddles or Strangles with a single click.

Straddle Parameter Panel

Configure execution settings for manual entries using the expandable controls panel at the top of the cockpit:

Control SettingDescription
Script & ExpirySelect the underlying index (e.g., NIFTY, BANKNIFTY, SENSEX) and target contract expiry date.
Strikes & OffsetSpecify how many strike options to display in the grid, and add an offset (e.g. ±100 pts) to build Strangles instead of ATM Straddles.
Lots & Entry TypeSet your trade lot quantity and choose Instant execution (sends market orders immediately) or Limit triggers.
SL & Target LimitsSpecify Stop Loss (SL) and Target triggers either in points (Pts) or percentage (%) terms. Supports Trailing SL settings.
Auto Exit TimerArm a countdown timer (in seconds) to automatically square off the straddle position once the timer expires.

One-Click Entry & Monitoring

The cockpit visualizes Call (CE) and Put (PE) premiums side-by-side. Click EXECUTE STRADDLE to place both legs simultaneously. Active positions display real-time combined LTP, highest/lowest premium tracked since entry, current P&L, and quick individual or combined exit controls.

12. Options

The Option Chain page displays option contracts centered dynamically around the active spot index price. It is the primary tool for strike analysis and quick scalp execution.

Real-time Data Matrix

The Option Chain grid is organized vertically, with Call option data on the left, Strike Prices in the center, and Put option data on the right:

  • Bid / Ask Spreads: Displays the live bid and ask premiums, enabling you to inspect contract liquidity.
  • Open Interest (OI) & Volume: Tracks active contract accumulation and daily volume change percentages to identify key support and resistance zones.
  • Live Greeks Dashboard: Computes and updates option Greeks dynamically:
    • Delta: Measures premium sensitivity to underlying price moves.
    • Theta: Displays expected time decay value per day.
    • Gamma & Vega: Tracks rate of delta change and volatility sensitivities.
  • One-Click Trade Load: Click on any premium value under the CE or PE columns to automatically load that strike contract into the Scalp Terminal for execution.

Options Strategy Builder

The Strategy Builder lets you assemble and submit a multi-leg options strategy directly from the live chain. It opens as a side panel as soon as the first leg is added.

1
Select the Market and Contracts
Choose the underlying index, expiry, strike range, and Chain or Straddle view. Use the green + button beside a CE or PE contract to add aBUY leg, or the red + button to add aSELL leg. Adding the same contract and action again increases its lot count.
2
Configure Each Leg
Review the symbol and live LTP, then set BUY/SELL, number of Lots, order Type (MKT or LMT), and limitPrice. Use the trash icon to remove a leg. All Mkt andAll Lmt update every leg at once.
3
Choose Product and Check Margin
Select MIS for intraday positions orNRML for carry-forward positions. Compare Avail Marginwith Req Margin; the required value turns red when it exceeds the available balance. Margin is an estimate and can change before execution.
4
Execute, Schedule, or Save
Execute Strategy Now submits the basket immediately. To execute later, enter the server-local target time and click Schedule. Enter a Basket Name and click Save to reuse the same template from either the Options page or Orders page. Clear Basket removes all current legs without placing orders.

Hedge-first Execution

BUY legs are submitted and confirmed before SELL legs. If any BUY leg fails, is rejected, or is not confirmed within the execution timeout, the SELL phase is aborted. Legs within the same phase are placed in parallel, so a basket is not an exchange-guaranteed atomic order.

7. Positions

The Positions page displays all active and closed option contracts for the current trading day. It is your main portfolio tracker.

Portfolio Matrix Fields

Column HeaderDescription and Functional Behavior
Symbol & QuantityShows the options ticker name and quantity. Long positions are shown as positive integers; short positions are shown as negative integers.
Average Entry / ExitCalculates the volume-weighted average price at which your entries were executed and exits were squared off.
Current Premium (LTP)The current premium price. Updates on every tick from the WebSocket feed.
Unrealized PnLCalculates the profit or loss of active open trades. Colors flash green during profit spikes and red during drawdowns.
Realized PnLThe finalized profit or loss of closed trades, updated instantly upon exit fill confirmations.
Row ActionsIncludes buttons to exit that specific contract immediately or add the contract to your watchlist.

8. SL/Target

The SL/Target Manager tab monitors active risk profiles on the server. It allows you to configure or update automated exits for manual trades.

Managing Active Stop Loss & Targets

When you place manual scalp trades, you can apply automated exit rules. The SL/Target Manager displays these settings in a real-time table:

  • Stop Loss Points: If the premium drops or rises against your entry by this amount, the server triggers an exit order.
  • Target Points: The target premium gain at which the position is closed for profit.
  • Trailing SL Steps: Configures step increments (e.g. for every 10 points profit, move stop loss 5 points higher).
  • Dynamic Updates: You can edit the values in the Stop Loss or Target fields directly in the table and click Apply Updates. The server updates the active monitoring loop instantly without needing to exit the trade.

9. Orders

The Orders Book tab tracks all orders submitted to the broker during the current trading session.

Filters & Rejection Details

Sort through your order book using these filters:

All / Pending

Displays all orders, including pending limits. You can cancel pending orders directly from this list.

Completed

Lists all successfully filled trades with execution timestamps and prices.

Rejected

Lists failed orders. The description field shows the specific broker error (e.g.Margin Shortfall, RMS Limit Breach), helping you troubleshoot placement issues.

Basket Orders

Open Orders and select Basket Ordersto create a basket from any supported instrument, including equities, futures, and options.

ControlHow to Use It
Add InstrumentSearch by symbol or contract name, then click + BUY or + SELL. Search results show the exchange, token, and current LTP. Re-adding the same symbol and action increases its lots.
Global ProductSelect MIS or NRML for the complete basket. Changing this control updates every existing leg.
Leg EditorToggle BUY/SELL, edit lots, choose MARKET or LIMIT, and enter a price for limit orders. Quantity is calculated automatically from lots and the instrument lot size.
Margin DisplayShows available broker margin and estimated required basket margin. A red required-margin value indicates that the estimate exceeds the available balance.
Saved BasketsSave a named template, load it into the builder later, or delete it with the trash icon. Templates are shared with the Options Strategy Builder.

Immediate and Scheduled Execution

  • Execute Basket Now: Places BUY legs first and waits for confirmation before placing SELL legs. Verify every fill in the Orders Book after submission.
  • Schedule Execution: Enter a target time including seconds where required, then click Schedule. The broker session must still be authenticated at execution time.
  • Scheduled Baskets: Review pending, completed, failed, and cancelled tasks. A pending schedule can be cancelled; completed, failed, or cancelled records can be deleted.
  • Limit Orders: A basket can remain partially filled if one or more limit prices do not trade. Unfilled or failed legs are not automatically converted into market orders.

Review Before Submission

Confirm symbols, expiries, BUY/SELL directions, lots, product type, prices, available margin, and broker login before executing. Multi-leg placement is not atomic; partial execution can leave directional or unhedged exposure that must be managed from Positions and Orders.

6. Charts

The Charts tab renders high-fidelity candlestick charts. It is built to display price action for options contracts and indices in real time.

Chart Settings & Overlays

The charting screen supports the following interactive features:

  • Indicator Overlays: Toggle indicators like VWAP andSupertrend directly on your options candlestick feeds.
  • Timeframes: Switch between 1m, 5m, 15m,1H, and 1D intervals.
  • Popout Charts: Click the expand button to open the chart in a standalone window, allowing for multi-monitor setups.

10. Triggers

The Spot Triggers tab allows you to configure index spot price alerts and crossover automation rules.

Creating Conditional Spot Triggers

Configure triggers based on underlying index prices:

1
Specify Target Index & Direction
Select the index (e.g. NIFTY or SENSEX) and the condition (e.g., crossing above or below a target value).
2
Define Trigger Price
Enter the target spot price at which the trigger should fire.
3
Select Action
Select the action: sound a voice alert, popup a notification, or trigger a square-off for a corresponding option position.

11. Logs

The System Logs page provides a real-time console of backend operations.

Console Feed Details

Use the console feed to audit system activity. The logs display:

  • Order Submissions & Fills: Details the timing, order type, and execution latency of trades.
  • Strategy State Changes: Logs VWAP crossover calculations, stop-loss trailing updates, and target checks.
  • API Diagnostics: Displays broker connection states, rate-limiting warnings, and token checks.

13. Holdings

The Holdings tab fetches and displays long-term stock portfolio holdings from your broker account.

Equity Portfolio Overview

Track your equity stock investments. The table displays:

  • Share Quantity: The count of shares held in your demat account.
  • Buy Average: The purchase price of the shares.
  • Current Valuation: Live valuation based on current stock market prices.
  • Holdings PnL: Consolidated profit or loss (with percentage change) for each stock asset.

14. Watchlist

The Watchlist tab allows you to configure a custom list of options contracts and indices to track.

Adding and Monitoring Watchlist Items

Add specific strike contracts to your watchlist to monitor premiums. The watchlist displays:

  • LTP & Spreads: Tracks live bid/ask spreads to help you evaluate contract liquidity.
  • Intraday Ranges: Displays daily highs, lows, and volume change metrics.
  • Trading Shortcuts: Click on any symbol row to load the contract parameters into the scalp order form.

15. Funds

The Funds page displays available cash balances, utilised margins, and credit adjustments in your broker account.

Margin Accounts Breakdowns

Open this tab to verify that you have sufficient funds before starting strategies. The page displays:

  • Ledger Balance: Your cash balance at the start of the trading day.
  • Available Margin: Free buying power available to open new options buyer or seller positions.
  • Collateral Credit: Margin credit received from pledging equity stock assets.
  • Utilized Margin: Cash blocked to cover margin requirements for open option positions.

16. Data Fetcher

The Data Fetcher tab manages backend historical stock market data scraper configurations.

Scheduling Data Scrapers

Configure and run scraper jobs to build your local historical database:

  • Index Selection: Schedule data scraping for specific indices (e.g.NIFTY, SENSEX).
  • Job Scheduling: Set up scraper tasks to automatically download 1-minute historical tick data.
  • Format: Data is downloaded and stored on the server as Brotli-compressed parquet files.

17. Feeds

The Feeds tab provides real-time WebSocket connection diagnostics.

WebSocket Diagnostic Tools

Use these metrics to audit your broker data connection:

  • Ping/Pong Latency: Measures connection delay (in milliseconds).
  • Packet Frequency: Displays incoming packet frequency (ticks per second).
  • Active Token Subscriptions: Lists all option contracts currently subscribed to the data feed.

19. Historical Data

The Historical Data page allows you to manage and explore your local historical database.

Cloud Data Synchronizer

Sync historical option data from the R2 cloud database:

  • Select Parameters: Select the Year and Symbol you want to download.
  • Diff Syncing: The synchronizer compares your local storage with the cloud cache, skips already-downloaded files, and downloads the rest in background batches with a live progress bar.
  • RAM Cache: Downloads are cached in client-side RAM to enable instant chart loading.

Multi-Leg Combo & Straddle Charts

The Historical Data page features a specialized Multi-Leg Combo Chart viewer to analyze synthetic straddle and strangle premiums over historical periods:

  • Interactive Strategy Builder: Click theCombo Chart button to design custom multi-leg configurations. Add, modify, or remove options legs (Calls or Puts, Buy or Sell) and view consolidated pricing curves.
  • Flexible Expiry Search: Search for specific option expiry dates by typing normal queries (e.g. 15-Feb, Feb,20240215) in the autocomplete field, populated directly from your local datasets.
  • True ATM Strike Resolution: When applying presets like ATM Straddle or Strangle ±50, the system fetches the historical index Spot contract candles on the selected expiry date to read the exact day close price. It then rounds this price to the closest available strike on the options chain, ensuring a mathematically accurate At-The-Money (ATM) contract selection.
  • Pending Preset Queue: If you select a preset before the contract strikes list is fully loaded from the server, the system automatically registers a pending action and applies the exact ATM strike computations the moment the data arrives.
  • Detailed Chart Legends: The chart legend dynamically displays exact constituent leg strikes and contract details (e.g. NIFTY ATM Straddle (21900 CE + 21900 PE)), making it easy to identify options under analysis.

18. Backtest Lab

The Backtest Lab allows you to test trading strategies against historical option data.

Running Historical Simulations

Run backtests to evaluate strategy performance before trading live. The Backtest page displays:

  • Simulation Inputs: Select strategy type, start/stop dates, timeframe, and target strike offsets.
  • Equity Curve: Interactive chart showing growth of capital over time.
  • Drawdown Log: Visual representation of maximum capital drawdowns.
  • Strategy Report Card: Displays Win Rate, Profit Factor, Net Profit, and detailed trade logs.

5. Strategy Builder

The Strategy Builder is a specialized dashboard tab designed to construct, analyze, and execute complex multi-leg option strategies (like Iron Condors, Straddles, Spreads, or custom hedges).

Interface Overview & Live Metrics

At the top of the Strategy Builder, the interface displays live statistics computed from the options market feed:

  • Spot & Futures: Tracks the active underlying spot index and synthetic future price.
  • DTE (Days to Expiry): The exact days remaining until the active contract options expire.
  • PCR (Put-Call Ratio): Computes the volume-based and Open Interest-based Put-Call ratio to evaluate market sentiment.
  • Max Pain: Evaluates the option strike price where option buyers would experience the maximum loss, indicating potential index magnets.
  • Avg IV: Displays the average At-The-Money (ATM) Implied Volatility.

Leg Construction Panel

Use the Left Panel to construct your multi-leg strategy:

  • Symbol & Expiry Selector: Pick the target index (e.g. NIFTY, BANKNIFTY) and the specific expiry date.
  • Leg Editor: Click Add Leg to insert a new position. For each leg, you can configure:
    • Buy/Sell (B/S) Toggle: Define if the contract is long (Buy) or short (Sell).
    • Option Type: Switch between Call Options (CE) and Put Options (PE).
    • Lots: Edit the number of option lots using the plus/minus counters.
    • Strike Price: Select the exact strike using increment steps or manual input.
    • Premium: Input a custom premium or let the feed pull live premiums.
  • Actions: Clear the entire constructor with Clear All or reload original pricing with Reset Prices.

Risk Profiles & Payoff Analysis

The Right Panel computes and renders real-time payoff analytics for your strategy configuration:

Payoff Chart

Generates an interactive risk profile graph plotting expiration P&L curves across a range of underlying spot values, helping you identify profit zones.

Greeks Analysis

Aggregates the portfolio Greeks (Delta, Theta, Gamma, Vega) across all active legs to show your consolidated net exposure to price drift, decay, and volatility spikes.

Strategy Report Card

Displays critical probability metrics: Max Profit, Max Loss, Risk/Reward Ratio, POP (Probability of Profit), Breakevens, and Net Premium Payable or Receivable.

Execution Controls

Once you are satisfied with the strategy configuration, use the execution pad to place your trades:

  • Product Type: Select MIS (Intraday) or NRML(Carry Forward).
  • Order Type: Choose LIMIT or Market Protected.
  • Strategy Parameters: Configure optional exits like Auto Exittime, profit target (TGT), stop loss (SL), or trailing stop (TSL).
  • Trade Strategy: Submits the complete basket to the broker. Like other baskets, BUY legs are placed first to secure margin benefits before executing short legs.

20. App Config

The App Config tab provides system-wide safety controls and platform integrations. It defines the risk boundaries and alert channels for all trading operations.

Global Risk Controls

Configure thresholds that protect your capital across all active manual and automated strategies:

Control settingDescription
Global Loss LimitMaximum allowed cumulative daily loss. If exceeded, the server instantly triggers a system-wide halt, cancels pending orders, and squares off open positions.
Global Profit LimitMaximum daily target limit. Once reached, the system halts further trading to lock in profits.
Active ProtectionMaster toggle to enable/disable automated risk exits. Must remain turned on for safety limits to execute.

Notification Webhooks

Connect Cloud Trader Pro to your communication channels for real-time order fills, SL hits, and risk alerts:

  • Telegram Integration: Paste your Telegram bot token and target chat ID to stream execution alerts directly.
  • Discord Webhooks: Enter your Discord channel webhook URL to broadcast formatted JSON embeds on strategy events.

21. Account

The Account page manages broker authentication credentials, active sessions, and multi-broker profiles. It is the primary connection gate to the live exchanges.

Broker Connection Manager

Configure API credentials for supported brokers (Flattrade / Shoonya / Upstox):

  • API Credentials: Store Client ID, Client Secret, API Key, and Redirect URLs securely on your local server.
  • Session Authentication: Renew sessions daily before market open. Click "Login" to execute the OAuth redirect flow and establish the session token.
  • Diagnostics: Monitor login success status logs, token expiry indicators, and auth exception states in real time.

Broker Credentials Specifications

Each broker requires specific credential sets from their developer console. Configure these correctly in the settings panel:

Flattrade

Requires the following inputs:

  • API Key (App Key): The API key generated in your Flattrade Developer Console.
  • API Secret: The corresponding client secret.
  • User ID: Your Flattrade client code (e.g. FT000000).
  • Redirect URI: Set to http://localhost:8002/api/auth/callback (or custom domain).
Shoonya (Finvasia)

Requires the following inputs:

  • Client ID: The Shoonya API key (Prism Client ID).
  • API Secret: The Shoonya API secret key.
  • User ID: Your Finvasia Shoonya client ID code.
  • Redirect URI: Set to https://cloudtraderpro.in/ for local setups.
Upstox

Requires the following inputs:

  • API Key: The Client ID / API Key from Upstox Developer console.
  • API Secret: The Upstox developer API secret.
  • Redirect URI: Set to http://localhost:8002/api/auth/callback (or custom domain).

22. About App

Displays system details, framework versions, development logs, and license terms. Cloud Trader Pro is designed by Bibhuti to deliver high-performance option scalping and algorithmic strategy automation.

23. Trading Safeguards

Cloud Trader Pro is a self-hosted algorithmic strategy framework. Options trading carries substantial risk, and automated execution can exacerbate losses under adverse network latency or volatile spikes.

Key Built-In Safeguards

  • Market Protection Buffers: Market orders are submitted as limit orders with a 5% price buffer to protect you from executing at extreme prices during thin liquidity.
  • API Rate Limit Protections: Request queues throttle REST API queries to prevent IP bans or connection locks.
  • Websocket Watchdog: Automatically detects disconnected tickers and triggers clean reconnections to protect active strategy logic.

Straddle & Strangle Strategy Template

Trading Strategy Template Disclaimer

This strategy is provided solely as a configurable technical template/structure. It does NOT represent financial advice, trading tips, or a recommendation to run live orders with default settings. Users must evaluate, backtest, and configure all parameters (such as targets, stop-losses, and entry signals) based on their own risk tolerance and logic. Default settings are placeholder values only; we do not provide fixed strategies or tips.

The Server-Native Straddle/Strangle Strategy Template allows you to configure rules to sell or buy a Call option (CE) and a Put option (PE) contract simultaneously. The server hosts the execution logic, tracking option prices directly to manage targets and stop-losses based on your template configurations. You can create, clone, configure, start, stop, and manage multiple independent Straddle Strategy instances concurrently. Spacing has been optimized into a compact two-column layout so that all risk and execution metrics are viewable side-by-side. Configurations are persisted instantly when clicking the manual SAVE SETTINGS button at the top of the settings panel.

Step 1: Entry Trigger Modes

Configure how your Straddle or Strangle enters the market. The server supports 5 distinct entry trigger types to handle various market conditions:

1. Instant Entry

Places orders immediately upon starting the strategy. The server resolves the strikes, fetches option prices, and submits the multi-leg orders instantly.

Usage: Best for traders looking to enter straddles manually at the current market price.

2. Time (Scheduled Entry)

Enables entry at an exact scheduled time (e.g., 09:20). The strategy stays in aPending (Time: 09:20) countdown state on start, resolves the ATM/custom strike exactly at the target time, and submits the orders instantly.

Example:Enter time 09:20. The server waits until 09:20:00, reads NIFTY spot index (e.g. 24015), resolves ATM strike (e.g. 24000), and places the orders.

3. Underlying (Spot Index Crossover)

Triggers trade execution based on the spot index price crossing a specific trigger price. The server automatically resolves the comparison operator at start based on current spot levels.

Example: If NIFTY spot index is 24000 and trigger is set to 24100, the server sets a >= operator. If spot is 24000 and trigger is23900, the operator is set to <=. The entry executes the instant NIFTY spot hits the target.

4. Limit (Premium Entry)

Triggers based on the combined option premium of the resolved legs. Best for buying cheap or selling high.

  • BUY Trades: Triggers when combined option premium falls below or equals the trigger price (e.g., combined LTP <= 150).
  • SELL Trades: Triggers when combined option premium rises above or equals the trigger price (e.g., combined LTP >= 200).
5. Momentum (Premium Breakout)

Triggers option entry when the combined premium breaks out, showing momentum in option prices.

  • BUY Trades: Triggers when combined option premium rises above or equals the breakout trigger price (e.g., combined LTP >= 250).
  • SELL Trades: Triggers when combined option premium falls below or equals the breakdown trigger price (e.g., combined LTP <= 180).

Advanced Strike Selection Criteria

Instead of placing trades strictly at the At-The-Money (ATM) strike, users can choose from 5 advanced strike selection modes. These criteria resolve option contracts dynamically at the moment of entry:

1. Strike Type (ATM / Moneyness Selection)

Performs standard index-relative strike selection. You can choose a moneyness category (ATM, OTM 1-5, ITM 1-5) which automatically shifts the resolved strikes by index step offsets from the nearest ATM strike price:

  • ATM: Call & Put both resolve to the At-The-Money strike (e.g., 24000). You can also apply a Custom Offset (e.g. +100) to shift both legs together to a single strike (e.g., NIFTY 24100 CE and 24100 PE shifted straddle).
  • OTM (Out-of-the-Money): Splits Call & Put into different strikes to form a Strangle. E.g. OTM 2 places Call at ATM + 2 stepsand Put at ATM - 2 steps. If it is a single-leg re-entry, it resolves only the active leg OTM (CE higher, PE lower).
  • ITM (In-the-Money): Splits Call & Put into in-the-money strikes. E.g.ITM 1 places Call at ATM - 1 step and Put atATM + 1 step.
2. Closest Premium

Resolves legs based on option price rather than strike distance. Ideal for selling options to capture a specific premium level. The server queries the option chain, fetches live Last Traded Prices (LTP), and selects the Call and Put strikes whose premiums are closest to the target premium value.

Example:Target Premium is 100.0. CE options are 24100 CE (LTP 104.5) and24150 CE (LTP 92.3); PE options are 23900 PE (LTP 101.2) and23850 PE (LTP 89.0). The server selects 24100 CE (diff 4.5) and23900 PE (diff 1.2).

3. Premium >= (Greater Than or Equal To)

Guarantees that the options traded have a live premium of at least your target value. It filters out all contracts cheaper than the target, then picks the nearest remaining contract above the threshold.

Example:Target Premium is 100.0. All contracts under 100.0 are ignored; it executes the closest strike whose LTP is >= 100.0 (e.g. LTP 104.5 instead of 92.3).

4. Premium <= (Less Than or Equal To)

Guarantees option premiums do not exceed your target value (capping risk/debit). It filters out all contracts more expensive than the target, then selects the closest contract below the threshold.

Example:Target Premium is 100.0. All contracts above 100.0 are ignored; it executes the closest strike whose LTP is <= 100.0 (e.g. LTP 92.3 instead of 104.5).

5. Straddle Width (Strangle)

Splits the Call and Put legs outward to set up a strangle. Entering a width in points (e.g. 200) offsets the legs symmetrically: CE Strike = ATM + (Width / 2) andPE Strike = ATM - (Width / 2).

Example: If ATM is 24000 and Width is 200 points, CE resolves to24100 and PE resolves to 23900.

⚡ Under-the-Hood Optimization:When starting premium-based selection strategies, the server queries quotes for all option contracts within a ±15 strike boundary concurrently using an asynchronous worker thread pool (Flattrade) or multi-symbol quotes endpoint (Upstox). This completes the entire chain scan and resolution process in under 0.3 seconds to prevent entry slippage.

Step 2: Option Order Protection Buffers

Exchanges block raw market orders for index options due to illiquidity. To protect your entries and ensure immediate execution during high volatility, the server converts "Market" orders into buffered limit orders:

BUY Option Orders

Placed with a +5% buffer above the current premium LTP (capped at +20 points max). This guarantees immediate fill at the best available price while protecting you from sudden premium spikes.

SELL Option Orders

Placed with a -5% buffer below the current premium LTP (capped at -20 points max) to ensure instant entry fills.

Step 3: Risk Management & Exits

The server monitors the combined price of the call and put options (LTP CE + PE) to apply these risk management options:

ParameterTypeDetailed Operational Behavior
Target PointsInputSets the profit goal. For example, if you input 50, the system will close both legs immediately when the combined premium gains 50 points.
Delay SL ExecutionBehaviorPrevents premature stop-loss exits caused by brief price spikes. When the SL price is breached, the server waits N seconds before executing. If the price recovers back below the SL within that window, the exit is cancelled. If price moves beyond SL + Extra Points at any moment, the exit fires instantly regardless of the timer. Works with both original and trailed SL prices. Does not apply to Target exits.
Stop Loss (SL) PointsInputSets the loss threshold. If the combined premium moves against you by this value, both options are squared off immediately.
Trailing Stop Loss (TSL)BehaviorEnables dynamic profit locking. Updates your SL trigger price upwards in steps (defined by Trailing Move and Trailing Stop steps) as the trade moves into profit.
TSL at Candle CloseBehaviorIf enabled, trailing SL updates are evaluated only when the candle closes (e.g. at the end of a 1-minute period), protecting you from exiting early during minor mid-candle volatility spikes.
Underlying Spot ExitInputExits option positions early if the underlying index spot price crosses specific upper or lower boundaries, regardless of current premium values.
Stop Entry AfterInputBlocks any entry trigger (Instant, Time, Limit, Momentum, or Spot crossover) if the current system clock has passed the specified EOD threshold (default 14:28).
Auto-Exit TimeInputAn end-of-day safety time (default 15:15 IST). The server automatically squares off all active straddles at this time.

Premium Spike Safeguard

Option feeds can occasionally experience brief latency drops where a contract LTP registers as 0.0. To prevent false exits, the server ignores 0.0 values in target or stop-loss calculations, ensuring you are not prematurely exited due to broker feed issues.

Advanced: Delay SL Execution

In live options markets, prices frequently spike momentarily to or past the SL level and then immediately reverse. The Delay SL feature prevents these fake-outs from triggering premature exits. It introduces a configurable wait period between the SL breach and the actual exit order.

How It Works

1
SL Breached — Timer Armed
When the option premium (combined or per-leg depending on SL Mode) crosses the Stop Loss price, the server records the breach timestamp and logs Delay SL armed. No exit order is placed yet.
2
Price Recovers — Timer Cancelled
On each subsequent tick, the server checks if the price has recovered back below (SELL trade) or above (BUY trade) the SL price. If it has, the breach timer is reset and the exit is cancelled. The strategy continues running normally.
3
Delay Expires — SL Executed
If the price remains beyond the SL for the full delay duration (e.g. 5 seconds), the server executes the exit immediately. The log will show SL Hit after X.Xs delay.
4
Price Blows Past Force Threshold — Instant Exit
If the price moves beyond SL + Extra Points (for SELL) or SL − Extra Points (for BUY) at any moment — even within the delay window — the server cancels the timer and executes immediately. This safety cap prevents unlimited losses during fast breakouts. The log will show Force-Execute.

Configuration Parameters

ParameterDescription
Enable Delay SLToggle to activate the feature. When off, SL executes on first breach as normal.
Delay (seconds)How many seconds the server waits after an SL breach before placing the exit order. During this window, if the price recovers, no exit is placed. Recommended range: 3–10 seconds.
Force Execute (extra pts)If the premium moves this many points beyond the SL price (e.g. SL = 50, extra = 10 → force at 60 for SELL trades), the server exits instantly without waiting for the delay to expire. Set to 0 to disable the force threshold (not recommended).

Worked Example

Setup: SELL straddle, Combined SL = 50, Delay = 5s, Force Execute Extra = 10 pts (force threshold = 60)

Scenario A — Price spike, recovers:
11:30:01 — Combined LTP hits 51 → Delay SL armed (timer starts)
11:30:04 — Combined LTP drops back to 49 → Timer cancelled, no exit
Strategy continues running.

Scenario B — Price stays above SL:
11:30:01 — Combined LTP hits 51 → Delay SL armed
11:30:06 — 5 seconds elapsed, LTP still at 53 → SL executed

Scenario C — Price blows through:
11:30:01 — Combined LTP hits 51 → Delay SL armed
11:30:02 — Combined LTP hits 61 (≥ 50 + 10 = 60) → Force-executed immediately, no waiting

Interaction with Trailing SL (TSL)

Delay SL is fully compatible with Trailing SL. The TSL continues to tighten the stop price as your trade moves into profit. When the trailed SL price is eventually breached, the Delay SL timer arms at that tighter level. This means you get the benefit of locked-in profits from TSL combined with spike protection from Delay SL.

Targets Are Not Delayed

Target exits fire immediately upon breach with no delay. Only Stop Loss exits (original and trailed) are subject to the delay timer. This is by design — profit capture should never be slowed down.

Use with Caution in High-Volatility Sessions

While Delay SL helps avoid spike-driven exits, it also means your position remains open during volatile market moves. Always set a meaningful Force Execute extra points value (e.g. 10–20 pts) to cap maximum slippage if price continues moving strongly against you after the SL is breached.

Leg-wise Execution & Strategy Re-Entry

Cloud Trader Pro supports advanced leg-wise execution boundaries and recursive strategy re-entry flows to let you execute complex trade lifecycle management:

1. SL/Target Modes (Leg-wise vs. Combined)

By default, the strategy operates in Combined mode, treating Call (CE) and Put (PE) legs as a single straddle position. If Leg-wise mode is chosen, the engine executes independent tracking:

  • Independent Leg Trailing: Call and Put options maintain their own Stop Loss and Target thresholds calculated from their fill averages. Hiding the global SL/Target inputs in this mode prevents any conflict.
  • Partial Exits: When the Call Stop Loss is triggered, only the Call leg is squared off, transitioning the strategy state toPartially Active while the Put leg continues to run.
  • Isolated Trailing Stop: Trailing Stop Loss rules (Move and Trail) are applied individually to each leg's Last Traded Price (LTP) relative to its highest/lowest point since fill.

2. Strategy Re-Entry Logic

After both legs of a straddle position are closed (via SL Hit, Target Hit, or Leg-wise exit), the engine can trigger automated re-entry if enabled. You can configure:

  • Re-entry Scope: Choose independent strike resolution criteria for the re-entered positions:
    • Same Strike: Re-opens positions in the exact same contracts that were traded initially.
    • Strike Type, Closest Premium, Premium >=, Premium <=, Straddle Width:Dynamically resolves fresh option contracts using specific criteria and moneyness selection. (Straddle Width is hidden if Single Reverse Leg is chosen).
  • Re-entry Leg Mode:
    • Both Legs (Straddle): Re-enters both Call (CE) and Put (PE) option contracts simultaneously.
    • Single Reverse Leg: Re-enters only the single reverse leg (the one that hit Stop Loss first). Succesive re-entries will alternate dynamically (CE -> PE -> CE...).
  • Execution Modes:
    • Instant: Re-enters immediately once the optional cool-off period expires.
    • Momentum Breakout: Captures the combined premium LTP of the resolved contracts on cool-off completion. It then sets up breakout/breakdown bounds and executes entry only when combined LTP crosses the selected momentum direction trigger:
      • Breakout (+Pts): Triggers entry when premium moves above Reference + Momentum Up points.
      • Breakdown (-Pts): Triggers entry when premium moves below Reference - Momentum Down points.
  • Max Re-entries Count: Prevents overtrading by limiting the maximum number of times the strategy is allowed to recursive-reenter in a single session.
  • Cool-off Timer: A configurable delay (in seconds) that must pass after an exit before the engine resolves new contracts or arms the next re-entry trigger.

3. Custom Re-Entry Risk Settings

You can toggle Use Custom Settings in the Re-Entry panel to enforce separate SL, Target, and Trailing SL (TSL) parameters specifically for re-entered positions, keeping them isolated from the first-entry configuration.

  • Independent Re-Entry Target & SL: Configure separate Combined or Leg-wise Stop Losses and Targets for re-entered trades.
  • Independent Re-Entry Trailing SL (TSL): Define independent Trailing Move and Trail steps for trailing SL in re-entries.
  • Dynamic SL at Momentum Extreme (Swing Extreme): When using Momentum Breakout execution and Combined SL mode:
    • Dynamic Stop Loss: Automatically sets the Stop Loss price to the highest combined premium (for SELL trades, i.e., Swing High) or lowest combined premium (for BUY trades, i.e., Swing Low) reached during the momentum tracking period.
    • Max SL Cap: Enforces a safety boundary. The Dynamic SL is capped at this value to limit maximum loss if the market experiences large swings before triggering your entry.

VWAP Trend Strategy Template

Trading Strategy Template Disclaimer

This strategy is provided solely as a configurable technical template/structure. It does NOT represent financial advice, trading tips, or a recommendation to run live orders with default settings. Users must evaluate, backtest, and configure all parameters (such as targets, stop-losses, and entry signals) based on their own risk tolerance and logic. Default settings are placeholder values only; we do not provide fixed strategies or tips.

The Server-Native VWAP Strategy Template lets you configure logic to automatically trade Nifty or Banknifty option contracts based on Volume Weighted Average Price (VWAP) indicators. It evaluates entry and exit signals on closed 1-minute candles based on your custom inputs.

Short Option Bias

Option buying suffers from theta time decay. The VWAP strategy is designed as an option-selling system. It sells Call (CE) or Put (PE) contracts when price signals suggest trend breakouts, capitalizing on both direction and premium decay.

Operational Lifecycle & Rules

1
ATM Strike Initialization
At strategy start, the system reads historical index spot prices at market open to resolve the At-The-Money (ATM) strike price. It then subscribes to live feeds for that specific strike's CE and PE options.
2
Warmup Safeguard (Skipping Old Signals)
When the strategy is started mid-session, it performs a warmup check. It fetches today's historical candles but exits without trading. This prevents the strategy from executing a trade based on historical signals that occurred before you booted the system.
3
Automated Entry Logic
At the close of each candle, the strategy checks two conditions to trigger a Short (Sell) trade:
  • Condition 1 (VWAP Break): The previous candle closed below its VWAP value.
  • Condition 2 (Low Break): The current candle closed below the lowest price of the previous candle.
If both match, the server places a Short position on that contract using a 5% limit protection buffer.
4
Stop Loss Placement & Trailing
Immediately upon order execution, the strategy submits a broker-side Stop Loss Limit (SL-LMT) buy order at Entry Price + Risk Points. As the trade moves in your favor, the server trails this stop-loss order at candle closes or ticks.

Manual Strategy Overrides

You can bypass the automated indicator checks at any time using manual overrides on the Strategies page:

Force CE Entry / PE Entry

Bypasses the VWAP crossover checks. The system instantly reads the current option premium, calculates the stop-loss risk points from the last candle's high, and places a market-protected Sell order immediately.

Force Exit All

Instantly cancels any pending orders, withdraws the broker-side SL-LMT orders, and submits a protected Buy exit order to close all running positions immediately.

Delay SL Spike Protection

The VWAP Strategy Template fully supports Delay SL protection. If enabled under the strategy configuration, a temporary price spike crossing the stop-loss level arms a wait timer (in seconds) instead of exiting instantly. If premium prices recover before the timer expires, the exit is aborted. See the dedicated Delay SL section for working scenarios and force-execution guidelines.

Risk Controls & Advanced Settings

The **App Config** tab allows you to configure global safety parameters. All changes synchronize across the platform in real time.

Revenge Safeguard (Cool Down)

Set a cap on your Max Daily Trades. Once your filled trades reach this limit, the server automatically rejects all new entry orders for the rest of the day. This prevents emotional trading and protects your capital.

Trading Scheduler

Automate your trading day. Configure Start Time (e.g. 09:05 AM) and Stop Time (e.g. 15:15 PM). The scheduler will automatically connect WebSocket data streams in the morning and trigger complete position square-offs in the afternoon.

Sound & Voice Alerts

Utilizes advanced voice synthesis to read out trading activities. Get audible confirmations for order fills, target hits, stop-loss triggers, and risk alerts, allowing you to monitor trading status without looking at the screen.

Setting Up Webhook Alerts

Configure real-time alerts in App Config to track executions from your phone:

1
Telegram Notifications
  • Search for @BotFather on Telegram, send the /newbotcommand, and save the HTTP API Token.
  • Search for your bot's username and click Start. (This is required to allow the bot to send you messages).
  • Search for @userinfobot and click Start to get your numericalChat ID.
  • Paste the Bot Token and Chat ID in the App Config settings, toggle Telegram on, and click Save.
2
Discord Webhook Alerts
  • Open your Discord server. Right-click the target channel and select Edit Channel.
  • Navigate to Integrations -> Webhooks and clickCreate Webhook.
  • Copy the Webhook URL.
  • Paste the URL into the Discord webhook field in App Config, toggle Discord on, and click Save.

Keyboard Shortcuts

Cloud Trader Pro supports fast keyboard navigation shortcuts to instantly switch between pages. Shortcuts are case-insensitive and are automatically ignored when typing inside input fields, textareas, or select dropdowns.

Navigation Keys

ShortcutPage / Action
MMonitor Page (Dashboard)
WWatchlist Page
SScalp Page
Shift + SStrategies Page
VVWAP Strategy Page
CCharts Page
PPositions Page
TSL / Target Page
Shift + TTriggers Page
OOrders Page
Shift + OOptions Page
LStraddle Page
HHoldings Page
Shift + HHistorical Data Viewer (Opens in New Tab)
DData Fetcher Page
AAccount Page
FFunds Page
BStrategy Builder
Shift + BBacktest Lab (Opens in New Tab)
UUser Manual (Opens in New Tab)

Emergency Actions

ShortcutPage / Action
Ctrl + Shift + KEMERGENCY KILL SWITCH (Stops strategy engines -> Cancels orders -> Exits positions)
Ctrl + Shift + USWITCH BROKER TO UPSTOX (Prompts confirmation dialog and restarts server to load Upstox session)
Ctrl + Shift + FSWITCH BROKER TO FLATTRADE (Prompts confirmation dialog and restarts server to load Flattrade session)
Ctrl + Shift + SSWITCH BROKER TO SHOONYA (Prompts confirmation dialog and restarts server to load Shoonya session)

Troubleshooting & FAQ

Q: Why are my option orders getting rejected by the exchange?

A: Indian exchanges block direct market orders for index options due to illiquidity risk. To prevent rejections, ensure you use the platform's default limit order configuration with a buffer (e.g. +5% buffer for BUY and -5% buffer for SELL). The server handles this automatically when using "Market" buttons.

Q: Why is my dashboard displaying "Locked Setup Mode"?

A: This indicates a missing or expired license key. Locate the license activation card at the top of the dashboard page, paste your valid license key, and click "Activate". The server will validate the license online and unlock all trading functions instantly.

Q: How do I load historical charts quickly on different timeframes?

A: The Historical Data Viewer utilizes a client-side RAM cache. When you load a symbol, it downloads the historical data once. Switching between 1-minute, 15-minute, or Daily charts uses local calculations, rendering the chart instantly without downloading it again. Change symbols to clear the cache.

Q: Why does the VWAP strategy log "Warmup Complete" and skip trading?

A: This is a built-in safety feature. When you start the VWAP strategy mid-session, it reads historical candles for the day to build its indicator lines but ignores any past signals. This prevents the strategy from executing trades immediately on boot based on hours-old data.

Q: How can I sync historical data without uploading files manually?

A: Open the Historical Data Viewer and click "Sync Data". The Cloud Data Synchronizer will calculate the difference between your local storage and the cloud cache, skipped already-downloaded files, and download the rest in the background with a progress bar.

System Updates

Cloud Trader Pro includes a built-in update mechanism that allows you to easily pull updates and keep your trading system up-to-date with the latest features, security patches, and broker API changes directly from the dashboard.

Market Hours Protection

Automated update checks are blocked during active market hours (09:00 - 15:30 IST) to prevent server hot-restarts while algorithmic strategies or positions are active. You can still forcefully trigger updates manually during market hours if needed, but doing so will temporarily interrupt your active streams for ~30 seconds.

Configuration & Controls

Update settings and manual update triggers are accessible on both theSystem Settings page and the About tab of the dashboard:

Manual Updates

Click "Check Updates" to force the server to check for new versions. If a new version is available, the "Update App" button becomes active. Clicking it will pull the update and automatically restart the frontend and backend services (takes ~30 seconds).

Auto-Update System

Enable this option to allow the backend server to automatically check for updates hourly and apply them during non-market hours (evenings and weekends).

Disable Updates Checking

If you prefer to disable background checks entirely, check the "Disable Update Checking" toggle. Toggling this will hide the sticky headers and update prompts immediately.