# 🦅 INSTITUTIONAL SNIPER BOT — OFFICIAL MANUAL & COMPLETE FEATURE HANDBOOK
### *The Ultimate Algorithmic Trading Ecosystem for Indian Financial Markets (NSE • BSE • MCX)*

---

## 📑 TABLE OF CONTENTS
1. **Executive Summary & Platform Architecture**
2. **Core Trading Engines & Market Segments**
   - 2.1 Index Options Sniper Engine (Nifty, BankNifty, FinNifty, MidcpNifty, Sensex)
   - 2.2 Equity Intraday Sniper Engine (Stock Screener & Momentum Breakout)
   - 2.3 MCX Commodity Futures Engine (Gold, Silver, Crude Oil, Natural Gas)
   - 2.4 Swing Delivery Equity Engine (Positional Compounding)
3. **Advanced Institutional Algorithms & Signal Logic**
   - 3.1 Trend Filter Identifier (M15 EMA 55/200 Macro Directional Lock)
   - 3.2 DeepSeek & Neural AI Signal Verification Engine
   - 3.3 Smart Money Concepts (SMC): Order Blocks, FVG & Liquidity Sweeps
   - 3.4 Proprietary Strategies: M1 Pro Scalper Index Strategy, Institutional V3, Gold Sniper & PCR/OI
4. **Intelligent Capital Preservation & Risk Management**
   - 4.1 Automated Daily Max Loss Kill-Switch
   - 4.2 Daily Profit Target Auto-Lock
   - 4.3 Dynamic Trailing Stop Loss & Smart Bracket Orders
   - 4.4 End-of-Day Mandatory Auto Square-Off
5. **Supported Broker Integrations & Step-by-Step API Setup**
   - 5.1 Nuvama (Nuwealth / Wealth API)
   - 5.2 Zerodha (Kite Connect API)
   - 5.3 Angel One (SmartAPI + Automated TOTP 2FA)
   - 5.4 Upstox (Upstox v2 OAuth API)
   - 5.5 Dhan (DhanHQ v2 Options API)
   - 5.6 Integrated Paper Trading Engine (Zero-Risk Real-Time Simulation)
6. **Step-by-Step "How-To-Use" Operating Manual**
   - Step 1: Login & Customer Portal Navigation
   - Step 2: Encrypted API Credential Setup & Handshake Verification
   - Step 3: Choosing the Market Segment & Strategy Terminal
   - Step 4: Configuring Parameters, Trend Filter, and Risk Limits
   - Step 5: Bot Deployment & Real-Time Monitoring
   - Step 6: Manual Overrides & Emergency Square-Off
7. **Key Advantages & Value Proposition of Joining Sniper Bot**
   - Retail Manual Trading vs. Institutional Sniper Bot Comparison
   - Zero-Emotion Execution & Psychological Freedom
   - 100% Non-Custodial Architecture (Capital Stays in Your Personal Broker)
   - 24/7 Cloud Autonomy via Dedicated VPS
8. **Frequently Asked Questions (FAQ) & Best Practices**

---

## 1. 🏛️ EXECUTIVE SUMMARY & PLATFORM ARCHITECTURE

The **Institutional Sniper Bot** is an enterprise-grade automated algorithmic trading ecosystem meticulously engineered for the Indian Financial Markets. 

Unlike retail trading indicators that lag price action, the Sniper Bot utilizes **institutional order flow analytics, multi-timeframe mathematical confluences, Smart Money Concepts (SMC), and real-time artificial intelligence verification** to capture high-probability trading opportunities.

### Core Architectural Pillars:
- **Multi-Tenant User Isolation**: Every user runs in an independent, thread-isolated sandbox with dedicated broker sessions and risk settings.
- **Sub-Second Execution Speed**: Direct broker API integration facilitates order creation, strike selection, and bracket order placement in milliseconds.
- **Hybrid Paper/Live Execution**: Users can switch seamlessly between simulated paper trading (using live tick data) and real capital execution.
- **Multi-Asset Versatility**: Built-in specialized engines for Index Options, Intraday Equities, Positional Swing Equities, and MCX Commodity Futures.

---

## 2. ⚡ CORE TRADING ENGINES & MARKET SEGMENTS

### 2.1 Index Options Sniper Engine
- **Underlying Assets**: NIFTY 50, BANKNIFTY, FINNIFTY, MIDCPNIFTY, and BSE SENSEX.
- **Automated Strike Selection**: Evaluates the live option chain to select ATM (At-The-Money) or high-delta slightly ITM contracts.
- **Weekly & Monthly Expiry Management**: Seamlessly resolves active expiry series without manual contract lookups.

### 2.2 Equity Intraday Sniper Engine
- **Universe**: Nifty 50, Nifty 200, and liquid high-beta momentum stocks.
- **Real-Time Screener**: Scans volume surges, opening range breakouts, and VWAP confluences for swift intraday momentum bursts.

### 2.3 MCX Commodity Futures Engine
- **Assets**: Gold, Silver, Crude Oil, Natural Gas, Copper, Zinc, Lead, and Aluminium.
- **Extended Session Trading**: Operates autonomously throughout morning and evening sessions up to 11:30 PM / 11:55 PM IST.

### 2.4 Swing Delivery Equity Engine
- **Investment Horizon**: Multi-day to multi-week positional delivery trades.
- **Compounding Focus**: Filters fundamentally strong momentum equities on daily charts with trailing profit protection.

---

## 3. 🧠 ADVANCED INSTITUTIONAL ALGORITHMS & SIGNAL LOGIC

### 3.1 Trend Filter Identifier (M15 EMA 55/200 Macro Directional Lock)
- **Timeframe**: 15-Minute (M15) Macro Trend Bar Analysis.
- **Mathematical Formula**: Exponential Moving Average 55 (Fast) and EMA 200 (Slow).
- **Directional Enforcement**:
  - **Market Price > EMA 55/200 Crossover**: Market is diagnosed as **Bullish**. The filter guides the selected strategy to execute **BUY / CALL TRADES ONLY**. Any counter-trend sell signal is blocked.
  - **Market Price < EMA 55/200 Crossover**: Market is diagnosed as **Bearish**. The filter guides the selected strategy to execute **SELL / PUT TRADES ONLY**. Any counter-trend buy signal is blocked.
- **Toggle Control**: Can be activated or deactivated with a single click in any strategy deploy terminal.

### 3.2 DeepSeek & Neural AI Signal Verification Engine
- **AI Signal Scoring**: Evaluates incoming technical breakouts against real-time India VIX regime, market breadth, and economic calendar announcements.
- **Customizable AI Threshold (5% to 80%)**:
  - 50% Balanced (Default recommended for all-around markets).
  - 70%–80% High Precision (Fewer trades, highest quality).
- Drastically reduces false breakouts and chop-zone losses.

### 3.3 Smart Money Concepts (SMC) & Institutional Levels
- Tracks where central banks, institutional hedge funds, and DIIs/FIIs position liquidity.
- Identifies **Order Blocks (OB)**, **Fair Value Gaps (FVG)**, and **Liquidity Sweeps** (stop-hunting levels).

### 3.4 Proprietary Strategy Suite
- **M1 Pro Scalper Index Strategy**: Hyper-fast scalping algorithm for swift option premium expansions.
- **Institutional V3**: Multi-factor trend continuation algorithm with dynamic volatility bands.
- **PCR & Open Interest Flow Scalper**: Tracks live Put-Call Ratio and cumulative open interest buildups.
- **Gold Sniper**: Specialized breakout model calibrated for precious metals volatility.

---

## 4. 🛡️ INTELLIGENT CAPITAL PRESERVATION & RISK MANAGEMENT

The bot adheres to a strict "Capital First" doctrine:
- **Max Daily Loss Limit**: Hard automated kill-switch that stops all further trading for the day if a pre-set drawdown threshold is touched.
- **Max Daily Profit Target**: Locks in realized profits to prevent giving gains back to the market during late-day reversals.
- **Max Trades Per Day**: Prevents overtrading and excessive brokerage accumulation.
- **Dynamic Trailing Stop Loss**: Locks in green pips automatically as price moves favorably towards targets.
- **Automated Square-off**: Closes all intraday MIS/Option positions before market closing (e.g. 3:15 PM IST).

---

## 5. 🔌 SUPPORTED BROKER INTEGRATIONS & STEP-BY-STEP SETUP

The Sniper Bot integrates natively with India's leading SEBI-registered brokers through official trading APIs:

| Broker | Authentication Method | Key Capabilities | Supported Segments |
| :--- | :--- | :--- | :--- |
| **Nuvama (Nuwealth)** | API Key, Secret + Request ID / TOTP | Real-time Quotes, Real Balance Fetch, Bracket Orders | Equity, F&O, Commodities |
| **Zerodha (Kite)** | Kite API Key, Secret + Daily Request Token | Sub-second WebSocket, Depth Quotes, GTT Orders | Equity, F&O, Currency |
| **Angel One** | Client Code, MPIN, API Key + TOTP | SmartAPI v2, Full Auto TOTP Daily Handshake | Equity, F&O, MCX Commodities |
| **Upstox** | API Key, Secret + OAuth 2.0 Token | Upstox v2 API, Ultra-low Latency | Equity, F&O, Commodities |
| **Dhan** | Client ID + Access Token (DhanHQ v2) | Dedicated Options API, Webhook Callbacks | Equity, F&O, Commodities |
| **Paper Trading** | Native In-Memory Engine | 100% Zero Risk, Real-time Market Ticks, Simulated Slippage | All Segments |

### Step-by-Step Broker Setup:
1. **Nuvama**:
   - Enter your `API Key` and `API Secret` in the Settings tab.
   - Generate your login Session via the blue button or exchange your `request_id` directly in Dashboard to fetch your real funds balance.
2. **Angel One**:
   - Enter `Client Code`, `MPIN`, `API Key`, and your 32-character `TOTP Secret Key` (from Google Authenticator setup).
   - The bot handles automated daily OTP handshake seamlessly.
3. **Zerodha**:
   - Enter `API Key` and `API Secret`.
   - Login daily via the Kite Connect authorization link to generate your daily `Request Token`.
4. **Upstox & Dhan**:
   - Provide your `Access Token` or `API Key` from your developer portal.
   - Click **Test Connection** & verify green status checkmark.

---

## 6. 📖 STEP-BY-STEP "HOW-TO-USE" OPERATING MANUAL

### Step 1: Login & Customer Portal Navigation
1. Open your designated Sniper Bot web address in any browser (e.g. `http://<server-ip>:5000`).
2. Log in using your registered username and password.

### Step 2: Encrypted API Credential Setup
1. Click **Settings** in the top navigation bar.
2. Select your broker from the dropdown.
3. Enter your broker credentials.
4. Click **Save Settings**, then click **Test Connection**. Ensure the status reports "Connection Successful".

### Step 3: Choose Your Trading Segment
- **Index Options**: Click `Deploy Bot` in top menu.
- **Stock Intraday**: Click `Stock Sniper`.
- **MCX Commodities**: Click `MCX Sniper`.
- **Swing Delivery**: Click `Swing Sniper`.

### Step 4: Configure Strategy & Risk Filters
1. **Trading Mode**: Choose `PAPER` (for risk-free testing) or `LIVE` (for real broker orders).
2. **Strategy**: Select your desired strategy (e.g. `M1 Pro Scalper Index Strategy`, `Institutional V3`, `SMC`).
3. **Trend Filter Identifier**: Toggle **ON** to enforce the 15-minute EMA 55/200 directional lock.
4. **AI Signal Filter**: Toggle ON and set your confidence threshold (50% standard).
5. **Risk Limits**: Enter your Lot Size, Max Daily Loss (₹), Max Daily Profit (₹), and Max Trades limit.

### Step 5: Start & Deploy the Bot
1. Click the large green **Start Bot** button.
2. The terminal badge turns to **RUNNING**. The bot now continuously evaluates tick data and candle patterns.
3. When high-confluence conditions are met, orders execute automatically with pre-set SL and Target brackets.

### Step 6: Live Monitoring & Emergency Controls
- View real-time interactive charts, active open trades, LTP, stop loss, and target bars.
- To halt trading: Click **Stop Bot**.
- In case of emergency or high-impact news: Click **Square Off All** to instantly exit all open positions.

---

## 7. 💎 KEY ADVANTAGES OF JOINING THE SNIPER BOT

| Feature / Benefit | Manual Retail Trading | Institutional Sniper Bot |
| :--- | :--- | :--- |
| **Execution Speed** | 3 – 10 seconds (prone to slippage) | **Sub-second (instant bracket fills)** |
| **Psychological Discipline** | Subject to FOMO, panic, & revenge trading | **100% systematic, emotion-free rules** |
| **Market Coverage** | Can monitor only 1 or 2 charts at a time | **Scans multi-index & hundreds of stocks simultaneously** |
| **Trend Confluence** | Frequent whipsaws & false breakouts | **Filtered by M15 EMA 55/200 & DeepSeek AI Engine** |
| **Risk Management** | Manual mental stops frequently ignored | **Hard automated kill-switches and profit locking** |
| **Custody & Security** | Giving money to unauthorized portfolio managers | **100% Non-custodial — funds stay in your personal broker** |
| **Time Freedom** | Staring at screens for 6+ hours daily | **Full automation — set parameters and let the bot execute** |

---

## 8. 🛠️ FREQUENTLY ASKED QUESTIONS (FAQ)

- **Q: Are my funds safe?**  
  *A: Absolutely. The bot operates strictly through official broker APIs using read/trade rights. It does NOT have withdrawal or deposit permissions. Your capital stays 100% safe in your own broker account.*
- **Q: Can I test strategies without risking real money?**  
  *A: Yes! The bot features a built-in Paper Trading engine that streams live market quotes and simulates order execution with realistic slippage.*
- **Q: Does my computer need to stay on all day?**  
  *A: No. When hosted on a dedicated cloud VPS server, the bot runs 24/7 autonomously in the cloud even when your personal laptop and smartphone are shut down.*
- **Q: How does the Trend Filter Identifier improve results?**  
  *A: By locking execution to the macro 15-minute trend (EMA 55/200), it filters out counter-trend noise and eliminates over 70% of false breakout stopouts.*

---
*© 2026 Institutional Sniper Bot Team. All rights reserved. For customer support and license queries, visit your Client Dashboard.*
