The Vyuh user guide, tab by tab.

Part 1: Getting started

1. What Vyuh is, and the safety defaults

Vyuh is a Windows desktop app that runs on your PC. It receives trading signals, mostly TradingView alerts, and turns them into orders at your broker. Each strategy decides what to buy or sell, how much, and when to exit. Vyuh keeps watching the positions it opened: stop-loss, target, trailing stops and time exits.

Two modes: paper and live

• PAPER uses real alerts and real prices with simulated money. Nothing goes to your broker. Every new strategy starts in paper.
• LIVE sends real orders to your broker account. A strategy only trades live when all of these are true:
  • the strategy's Mode is Live and saved;
  • the master switch Settings → Trading → Live trading is on;
  • a broker account is connected and signed in today;
  • you are signed in to your Vyuh account and your access allows live entries.
• Paper and live results are always shown apart and never added together.

Safety defaults you can rely on

• New strategies start switched off and in paper. A switched-off strategy ignores alerts: they are recorded in Alerts, but no order is placed.
• Automated entries use LIMIT orders, at the price plus or minus a few ticks. Live market orders go out as protected limits that Vyuh re-prices until filled.
• Live orders are paced at 8 a second, under the exchange's 10-a-second line for retail algos.
• The kill switch, bottom left, stops everything for the day, live and paper, even with Live trading off or no broker signed in. Daily loss limits trip it automatically.
• Exits are never blocked: a stop-loss or exit always goes out, even when entries are stopped or the Live trading switch is off.
• Every action is written to an append-only, tamper-evident Audit log.
• Keys and passwords live only in Windows Credential Manager, never in files.

2. Installing and first start

1. Run the installer, Vyuh_0.2.4_x64-setup.exe, and follow its steps. Your data is kept across updates.
2. On first start, read the licence terms and the risk statement, tick both boxes and press Accept and continue.
3. Vyuh then asks you to sign in with your Vyuh account: your email and password, plus an authenticator code if you use one. You can reset a forgotten password from the sign-in screen. To get access, open Get access. It shows the membership plans and, when open, the free trial of 3 market days (Saturdays, Sundays and market holidays don't count). To buy, press Buy and pay on Easebuzz's page. If you're already on the HFT Indicator Plan or Arko's Strategy Plan, Vyuh is included: don't buy it separately, just ask for your login. For the trial, fill in your name, email and password, press Email me a code and type the code from the email. Your browser then opens a page to check your mobile number by SMS; once that's done, Vyuh starts your trial by itself. One free trial per PC, mobile number, email and broker account.
4. The setup wizard opens: broker, TradingView, Telegram, the default instrument, the recovery key and paper mode (next page). You can skip it.
5. The Dashboard then opens with a Get started checklist for what's left:
   • Create a paper strategy: Strategies → Create strategy.
   • Get your webhook URL: Integrations → Tunnel, using ngrok (free) or Cloudflare.
   • Send a test alert: Test webhook. This proves the whole path without placing an order.
   • Connect Zerodha (or another broker): needed for live prices and live orders. Paper works without it.
6. Closing the window keeps Vyuh running in the system tray, so it keeps watching your exits. Quit from the tray icon. It asks first, and counts each, if positions are open, live strategies are on, or live orders, executors, waiting entries or approvals are still working; if it couldn't check its working orders, it says so.

Where things are kept

Database encryption (automatic)

Vyuh encrypts its database, the database's write-ahead log and its backups with SQLCipher (AES-256), on Windows Home and Pro alike. The key is made on the first start and kept only in Windows Credential Manager, never in a file. A database from an earlier version is converted at the first start: Vyuh copies it to backups first, checks the encrypted copy table by table, and only then replaces it. If anything goes wrong, the database stays as it was and Settings → Storage & security says why; Vyuh tries again at the next start.

App lock (optional)

Settings → Security sets an app password (8+ characters), asked at start and after Lock now. You can add an authenticator code. Strategies keep running while Vyuh is locked. If you forget the password, close Vyuh, create an empty file named reset-password in the data folder, and start Vyuh again.

The setup wizard

Step 4 of 6. The steps are on the left; a tick means the step is done.

The wizard opens once, after the terms. Each step is a screen you also find elsewhere in Vyuh, so nothing is lost if you skip it. Next and Back move between steps; Skip the wizard (bottom left) closes it. Open it again from Settings → General → Setup wizard → Open the wizard.

3. The screen: sidebar, top bar, kill switch

The Dashboard, with the sidebar on the left and the top bar above.

Sidebar

• Search (Ctrl+K) at the top jumps to any screen.
• Bottom left: your broker account chip (opens Connect): the default account when it's signed in, else the account that is (such as the one your prices come from) with a note that the default isn't. The top bar shows a green pill for each signed-in account and an amber one when the default account isn't signed in, since manual, scalping and AI orders go to the default. Then Sign out of your Vyuh account (it asks first; new live entries pause until you sign in again, open positions and their exits keep running) and the red Kill switch.
• Kill switch: stops live and paper trading for the day, even with Live trading off or no broker signed in: no new entries, Vyuh's working orders cancelled, its positions squared off. Each mode gets its own message ("exits sent"), and anything it couldn't cancel or close is listed, so you can do it at your broker. Reset it per mode on the Dashboard's Safety card, which asks first. It and other buttons, such as One-Click orders, work even while Windows reports no network; they never wait to get online.

Top bar

• Tabs (left): each screen you open, like a browser's. A sidebar click shows the screen in the tab you're on; Ctrl+click or middle-click opens it in a new tab, as does +. Each tab keeps its state (zoom, scroll, the chain's place) while you're in another. Ctrl+Tab and Ctrl+Shift+Tab switch, Ctrl+W or the × closes. A screen is open in one place at a time: asking for one that's open elsewhere switches to it.
• New window: the window icon on a tab moves it to a window of its own, for a second monitor. Every window shows the same live prices, orders and positions, and each window's charts stay live; closing one closes just it (the main window still hides to the tray). Quit prompts and approvals show in the main window only; engine notices show in every window. Each window remembers its tabs.
• Market phase with a countdown (pre-open, open, closes in…).
• Broker pills: a green pill for each signed-in account (broker and client id), and an amber one when your default account isn't signed in; click to open Connect.
• Webhook pill: whether the tunnel is online; click it to open Integrations.
• LIVE TRADING ON appears while the live master switch is on.
• A light/dark toggle.

A red licence banner shows only when new live entries are paused by the licence check, for example when Vyuh hasn't reached the licence server for more than 48 hours. Paper trading and exits keep working. See Settings: licence checks.

A red PRICES FROM BACKUP banner shows while prices come from your backup feed (see Brokers), with Switch back. Orders still go to your trading accounts.

4. Your daily routine

Before the market opens (by 09:10 IST)

1. Start Vyuh, or check it's in the tray.
2. Sign in to your broker. Zerodha sessions end at 06:00 IST every day, so press Sign in with Zerodha on Connect. Some brokers need a daily token or approval instead (see Connect).
3. Check the top bar: broker connected and Webhook online, and no red PRICES FROM BACKUP banner. If you use a separate market-data account or a backup feed, sign in to those too.
4. On the Dashboard, check each mode's Safety card says Entries allowed.
5. Switch on the strategies you want to run today (Strategies, the switch on each card). Option-leg strategies should be on a few minutes before 09:15, so Vyuh can load the prices of the strikes around ATM.

During the day

• Watch Alerts (every signal and what Vyuh did), Positions and Orders & trades.
• In semi-automatic mode, approve or reject waiting entries on the Dashboard or in Approvals.
• If the red backup banner appears, the main feed went quiet for 30 s or its session ended. Fix or re-sign in the main account, then press Switch back.
• Keep Vyuh running: Vyuh itself watches stops and targets, so they only work while it runs and gets prices. For extra protection on Zerodha, see "Keep the stop-loss at the broker" under Strategies.

After the close

• Check Reports for the day's results by strategy. Ask the assistant to "export today's journal" to keep a written record.
• MIS positions square off at the MIS time (default 15:15; MCX positions at 23:00); index contracts expiring today exit at the expiry-day time (default 15:30).
• Leave Vyuh running if you carry NRML positions overnight. Stops, targets and trails carry on after a restart.

Part 2: Placing trades

5. The five ways to place a trade

Whatever the way, every order passes the same checks: the kill switch, the live master switch, the risk limits, and the approval if semi-automatic mode is on. Every order is also recorded in Orders & trades and in the Audit log.

How an alert becomes an order

1. The alert arrives at your public webhook URL (the tunnel) and reaches Vyuh on your PC.
2. Vyuh checks the strategy's key, the alert's age (older than 60 s is refused), repeats (the same alert again is a duplicate) and the rate.
3. It checks the strategy: switched on, inside its entry window, trades per day, daily loss, kill switch, market open.
4. It works out the instrument: the alert's symbol through Symbol mapping, the strategy's Underlying (when the alert names none), or its option legs (ATM / ITM / OTM, premium ≥ X …).
5. It sends only the difference between what you hold and what the signal wants (long, short or flat), as a LIMIT order, paper or live. An entry order still working counts as held, so a repeated alert doesn't enter twice.
   • Each strategy's signals are handled one at a time, in order, in the strategy's own queue, so a busy strategy never holds up another. Up to 32 can wait; more are refused as "engine busy".
   • An alert that waited more than 60 s opens nothing new (its exit part still goes) and sets up no Wait & Trade entry.
   • A reversal (long to short, or back) always sends its closing half, even when the new side is refused (licence, Live trading off, kill switch, entry window, trade limits, the largest order value). The alert shows a note and a warning.
6. Fills update the position. Stop-loss, target, trailing and time exits take over, and you get a notice (Telegram, WhatsApp or desktop, if set up).

6. From TradingView alerts, step by step

1. Create a strategy (Strategies, left column):
   • type a name;
   • pick the kind: Signal-driven acts on alerts, Multi-leg batch enters on start;
   • pick the instrument group and underlying;
   • pick Positional or Intraday;
   • press Create strategy. It starts switched off and in paper.
   Or press Templates and pick a template, for example from Nifty Selling or Nifty Buying (grouped by strike).
2. Check its settings in the form:
   • Underlying (e.g. NIFTY), Lots, Product (NRML, MIS or CNC);
   • the legs, their expiry and strike rules;
   • stop-loss, target, trailing;
   • then press Save.
   Until you press Save, a line at the top of the form says "Unsaved changes: press Save to apply them."
3. Start the tunnel (Integrations → Tunnel) and wait for Online.
4. Copy the URL: in the strategy's Signals card, press Copy beside the webhook URL. It copies https://…/h/<id>?key=…, the strategy's one address, with its key, so the alert message never needs one. Treat it like a password.
5. In TradingView, create an alert on your script or strategy:
   • tick Webhook URL and paste the URL;
   • keep the message your script sends (BUY, SELL, CLOSE LONG …), or use the JSON message from Integrations → Signal sources.
   Webhooks need a paid TradingView plan and two-step sign-in.
6. Test the path: press Test next to the URL (no order is placed).
7. Run in paper: switch the strategy on while it's in paper, and wait for a real signal.
8. Check every screen: Alerts (accepted, with what Vyuh did), Orders & trades (a LIMIT order), Positions (with its stop), Audit log (order.placed), and Telegram (the fill message, if set up).
9. Exit: send or wait for CLOSE LONG: Normal Exit; the position closes.

Messages your script can send

7. Testing alerts when the market is closed

On weekends and holidays Vyuh normally refuses all orders, paper included. To test the whole path on a closed day:

1. Settings → Trading: set Paper orders when the market is closed to On, and save. This never applies to live.
2. Strategies: create a strategy named TV test, group Stocks, symbol INFY, Positional. It starts off, in paper, as CNC. Set Lots to 1, switch it on, and save.
3. Copy the URL: press Copy beside the webhook URL. Without the tunnel it copies the local address http://127.0.0.1:47321/h/…?key=…, which works from this PC.
4. Send the alert TradingView would send, from PowerShell:

$url  = '<URL with key>'
$body = @{ action='buy'; symbol='INFY'; exchange='NSE'; price='1500'; id='T1';
           ts=(Get-Date).ToUniversalTime().ToString('o') } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri $url -Body $body -ContentType 'application/json'

5. Run the last line again within 10 s: Alerts shows a Duplicate, with no second order.
6. Check Alerts, Orders & trades (filled at the alert's price), Positions and the Audit log.
7. To exit, send action='sell' with id='T2', rebuilding $body so it gets a new time.
8. Afterwards, set the closed-day switch back to Off.

The JSON message (TradingView strategies)

{
  "action": "{{strategy.order.action}}", "symbol": "{{ticker}}",
  "exchange": "{{exchange}}", "price": "{{close}}", "qty": "{{strategy.order.contracts}}",
  "position": "{{strategy.market_position}}", "id": "{{strategy.order.id}}", "ts": "{{timenow}}"
}

• position wins over action when present.
• qty is used only if the strategy's "Quantity from the alert" is set, and never above its lots.
• Simple text also works: key=…;action=buy;symbol=INFY.

8. By hand: Charts, Scalping, Options, Positions

Charts

Each chart has BUY and SELL buttons; the BUY/SELL switch in the trade strip below hides or shows them on every chart. The strip also sets the mode, Product and Lots, and has a One-click switch (live asks first). Orders and positions show as lines on the chart. Indices are quote only, and stop orders can't be placed from the chart.

Scalping

1. Pick Options, the underlying, expiry and the CE and PE strikes (they start at the money, then stay put as the market moves), or Futures, or search Any instrument.
2. On the order ticket set Lots, MIS or NRML, Market or Limit at LTP, and the SL, Target and Trail every scalp gets.
3. Press Buy Call, Buy Put, Sell Call or Sell Put. With One-Click on, orders go at once and the keys work: ↑ ↓ → ←, F6 close all, F7 cancel all orders.

One-Click off means every order asks first. Turning it on in live asks to confirm, and switching mode turns it off. Scalping uses the default broker account.

Options builder

1. Options → Chain: add legs with each strike's buy/sell buttons, or from the Strategy Library (Bull Call Spread, Iron Condor, Short Straddle and 39 more).
2. Check Payoff, Greeks, the P&L table and Margin (with the hedge benefit). Try the what-if sliders: spot, IV, days.
3. Pick Product and Mode, then press Execute (paper) or Execute LIVE (asks to confirm).

Exits from Positions

• Each row has Exit (asks first), a chart, and a levels sheet to change its stop-loss or target.
• Close positions closes one strategy; Close all open positions closes everything in the mode shown.

9. Through the Assistant and Telegram

Assistant (Analyse → Assistant)

Ask in plain words, typed or spoken: "What are my open paper positions?", "Buy 1 lot NIFTY ATM call, paper", "Close 10% of my NIFTY position".

With no AI model connected, the built-in assistant answers short commands from Vyuh's own data, with no key or account: "summary", "greeks", "chain nifty", "buy 1 lot nifty atm ce mis", "alert me if banknifty above 52000 on telegram". Type help for the list, or press a quick button under the chat. For questions in your own words, connect a model: your own Claude API key, a local model, or Claude Desktop. See Assistant: connecting an AI model.

• Every order is a card: PAPER or LIVE, contract, lots × lot size, LIMIT price, value, margin, charges and the order tag. You press Approve or Reject; Vyuh's risk guard checks it again after you approve.
• Paper is the default. Orders are LIMIT at the last price unless you say "market".
• It also answers facts:
  • performance by strategy, day or underlying;
  • portfolio Greeks with a what-if table;
  • option-chain summary (PCR, max pain, OI);
  • futures basis; the market calendar;
  • a tax summary (a guide, not tax advice); slippage; comparing two symbols; sector rotation;
  • "will my alert trade?" for a strategy, and a retail-algo check of your accounts (static IP, algo ID, and today's live orders with and without Vyuh's order tag);
  • the audit log; latency per broker; order pacing and the brokers' "too many requests" refusals;
  • option positions near expiry, in facts (distance from spot, in or out of the money);
  • "what if I'd exited at 2 pm?"; progress against a monthly target; your return beside NIFTY's.
• It can pause or resume a strategy, change its stop or target, or press the kill switch, always through a card. It can never switch a live strategy on, change settings or keys, or approve its own requests.
• It also asks on a card before creating or deleting a watch, saving or forgetting a preference, and sending a message beyond this PC (Telegram or WhatsApp); desktop notifications don't ask. The card shows the full message or watch note, and whether it repeats or adds the day's summary.
• "Remember my usual is 2 lots BANKNIFTY straddle" saves a preference. See them, and forget them, in Settings → AI assistants.
• "Export today's journal" saves the conversation, today's trades and P&L, and your notes as a Markdown file in the journals folder. A second export the same day makes a new file instead of overwriting.
• It can answer in English, Hindi, Bengali, Tamil, Telugu, Marathi, Gujarati, Kannada, Malayalam or Punjabi (Answer in, in its settings).
• It never recommends what to buy or sell, which strike, or when to enter.

Telegram (your own bot)

Set it up in Integrations → Telegram, with "Answer bot commands" on. Commands, buttons and questions work only from you, in a private chat with your bot; a group chat gets notifications only.

10. From your own programs

Settings → Local API opens an API on this PC only (127.0.0.1, port 47322), never on the internet.

• Switch it on and press Copy key, then store the key in the QUAY_API_KEY environment variable.
• Turn on Allow orders only if your program should trade. Signals to /v1/signal need it too.
• Reads: strategies, positions, orders, tradebook, alerts, funds, holdings, quotes, depth, option chain, history.
• Orders: order, smart order, basket, modify, cancel, close position, plus GTT at brokers that offer it (see Orders & trades).
• Streaming: a WebSocket at /v1/stream.
• Every order still passes the kill switch, the live switch and the limits, and is audited.
• A modify is refused while the kill switch is on. One that adds risk passes the same checks as a new order; in semi-automatic mode a program can't add risk by modifying.
• GTT legs must be whole lots, within the freeze quantity and under Live: largest order value.

Python

Vyuh's Python client is the module quay_client, with the class Quay. Both keep that name so existing scripts go on working.

setx QUAY_API_KEY "<key>"
from quay_client import Quay
quay = Quay()
quay.buy("My strategy", "INFY", price=1500.5)     # a signal to a strategy

Scripts → Python strategies runs your Python strategies inside Vyuh:

• a schedule, restart after a crash, a memory limit and secrets;
• an optional sandbox: Low integrity (writes only in its work folder; one runs at a time) or Isolated (its own container and folder only, no internet, and Vyuh's API through a private pipe). Both need Python from python.org, not the Microsoft Store.

Others

• AmiBroker: post key=…;action=buy;symbol=SBIN to http://127.0.0.1:47321/h/<id> (formula in Settings → Local API).
• Excel: a VBA snippet posts to /v1/signal.
• n8n, Make, Zapier, Google Sheets: POST JSON to the public URL.
• MetaTrader 5: WebRequest to /v1/signal.
• Chartink: its own URL per action, with its own key.

11. Going live with one lot

1. Connect your broker and sign in today. Register your static public IP with the broker: SEBI's retail-algo rules (in force for all brokers from 1 April 2026) refuse API orders from other addresses. Enter it on the account (Static IP registered with the broker), then press Check this computer's public IP under Connect → Static IP, or in the wizard's broker step.
2. Settings → Trading:
   • set the Live daily loss limit, which trips the kill switch;
   • check the MIS square-off time;
   • consider Live: largest order value and Live: orders per day;
   • save.
3. Switch Live trading on. It asks to confirm, and the change is audited.
4. The strategy:
   • set Lots to 1;
   • pick your account in Broker account;
   • set Mode → Live (confirm);
   • press Save. The badge turns LIVE only after Save.
5. Watch the first order in Orders & trades and at your broker. Keep the kill switch in reach.

Turning it off

• Switch the strategy off (the switch on its card): new alerts are ignored, and open positions keep their exits.
• Stop and close: switches the strategy off and closes its positions.
• Close positions: closes them but keeps the strategy on.
• Live trading off (Settings → Trading): no new live entries. Open live positions keep their stops, targets and exits, which still go to the broker.
• Kill switch: stops everything for the day.

Part 3: Tab by tab

Dashboard

Trade → Dashboard

What it shows

• Get started checklist, the first time (Hide once done).
• Waiting for your approval: entries held in semi-automatic mode. Approve re-checks prices and limits; Reject drops it. Requests expire after 5 minutes. Approve all approves exactly the rows on screen (see Approvals).
• Live P&L today, Paper P&L today (simulated), Alerts today (with rejected count), Live trading (on or off, broker connected or not).
• P&L this session chart (paper amber, live teal), sampled while Vyuh is open.
• Safety card per mode: "Entries allowed", or "Kill switch on: reason" with Reset. Reset asks first ("Allow live entries again today?").
• Recent alerts and Quick access tiles to the main screens.

Charts

Trade → Charts

• A grid of 1 to 16 live charts; intervals 5s, 15s, 30s, 1m, 3m, 5m, 15m, 30m, 1h and 1d. History comes from your broker (seconds candles from Vyuh's own recording); live candles are built from ticks, starting at each exchange's open (NSE and BSE 09:15, MCX and currency 09:00). Scroll or drag the chart left and older candles load as you go, as far back as your broker keeps them. History that fails to load shows "Could not load…" with Retry.
• Symbol search: tabs for indices, stocks, futures, options, commodities, currency and crypto; type words like NIFTY 24500 CE.
• Indicators: every indicator by family, with favourites, recently added, your own scripts and a live preview of each. Each added indicator's name shows at the top left of its pane with larger buttons beside it to hide it, open its settings or remove it.
• Profiles (top bar): visible range and session volume profiles (up/down volume, point of control, value area) and the options OI profile: the nearest expiry's call (red) and put (green) open interest at each strike beside the price axis. Each bar is a glass tube filled with liquid: the tube's length is the strike's highest OI today and the fill is its OI now, so a strike that fell from 1 Cr to 50 L shows half full. For NIFTY, BANKNIFTY and SENSEX the day's highs come from the minutes Vyuh keeps all day. For other chains the bars show the OI now at once, and Vyuh downloads the day's minute history in the background ("Loading today's OI highs…" at the top) and fills in the highs when it's done; this needs a broker with historical data. Point at a bar to see the strike's call and put OI, today's highs and the put/call ratio.
• Watermark: each chart shows its symbol and interval faintly behind the candles at size 50 on a full-height chart, and in proportion on others (smaller with four charts in the grid, bigger full screen). A text size typed in Chart settings becomes the size for every chart, in the same proportion. Turn it off or change its text, colour or opacity in More → Chart settings → Appearance. Chart dialogs such as Chart settings can be dragged by their title bar anywhere over the charts.
• Straddle charts (top bar, Straddle): a call and a put of one expiry added together, in the active chart. The popup starts on the chart's own option chain (an index, its future or option, or an F&O stock), or type another underlying. Choose the expiry and either a rolling straddle (at each bar, the strike nearest the underlying then, so it follows the money) or fixed strikes: a strike's call and put (the at-the-money strike is offered first), or the put at another strike (a strangle, such as 23100 CE + 22900 PE); changing the underlying resets the put strike too. An instrument without options gets no chart. A label at the top middle of the chart names the strikes in use: for a rolling straddle the at-the-money strike now (such as "Rolling ATM straddle · NIFTY 03 Nov · now 24,000 CE + 24,000 PE"), which changes as the market moves; for fixed strikes the call and put strikes. A narrow chart shows just the strikes. Straddles start at 1-minute charts and update live from both legs. A bar's open and close are the legs' added; its high and low are their highs and lows added, the usual approximation. A rolling straddle loads a shorter history (a day on 1-minute charts) as it downloads every strike it touched. The chart's BUY and SELL buy or sell both legs together at market, Lots × each leg's lot size, to your default account (a rolling straddle trades the strike at the money at that moment); live orders ask first unless One-click is on.
• Forecast (top bar, an experiment): an open model, Kronos (MIT licence), guesses the active chart's next 10, 20, 30 or 60 bars from its own past bars (up to about 500) and draws them after the last bar: a shaded band covering the middle 80% of 8, 16 or 32 sampled paths, and a dashed line through their average. The first time, Download the model fetches 115 MB from Hugging Face once, checked against the published files; after that it runs on this computer, in about 1 to 3 seconds. The chart needs at least 64 bars. The band goes when you change the chart's symbol or interval, or with Remove forecast. It is a statistical guess, often wrong, that knows nothing of news, options or your positions: never advice, and not something to trade on.
• Bar replay (top bar, Replay): practise on past price action. Click a bar on the active chart (or choose Select date, First available date or Random bar) and the chart goes back to it; then play, pause or step forward and back. Speed runs from 0.1x (1 update every 10 seconds) to 10x (10 a second). Update interval lets a bar build in finer steps, for example a 15m bar over 1m updates; where your broker has no finer history the bar forms along a simulated path, shown in italics. Indicators and volume profiles redraw as they stood at each bar. While a chart replays, its live updates pause and its BUY/SELL buttons are off. Jump to real time or ✕ goes back to the present. Keys: Shift+↓ play or pause, Shift+→ step forward, Shift+← step back.
• Index volume: for NIFTY 50, NIFTY BANK, FINNIFTY, MIDCPNIFTY, SENSEX and BANKEX, volume is the sum of the constituents' volume. The first time, it fills in after a few seconds in the background; after that it's instant.
• Chart type (per chart, grouped as on TradingView): Bars, Candles, Hollow candles, Volume candles; Line, Line with markers, Step line; Area, HLC area, Baseline; Columns, High-low; Volume footprint, Time price opportunity (TPO, a letter per 30 minutes at each price, with point of control and value area), Session volume profile; Heikin Ashi, Renko, Line break, Kagi, Point & figure, Range. The footprint and order flow have their own page: Order flow, footprint and seconds charts.
• Top bar: symbol search, the interval menu (grouped into seconds, minutes, hours and days), chart type, Indicators (including your own scripts under "My scripts"), look-back range, go to date, layout (number of charts), sync between charts, full screen (Esc leaves; every tab stays as it was; pressed in a second window, it fills that window), save a picture (each chart labelled with its exchange, symbol and interval, saved to your Downloads folder under Vyuh with the symbols in the file name; the folder opens), and More (chart settings, price alerts, reset).
• Left: drawing tools.
• Charts show Vyuh's working orders and positions as lines, and have BUY / SELL buttons (the BUY/SELL switch in the trade strip turns them off and on). If the contract's lot size can't be looked up, no order goes and a message says so; Vyuh never guesses 1 lot.
• Trade strip (bottom): order and position lists, a Live orders switch (paper by default), a BUY/SELL switch for the chart buttons, Product, Lots, One-click orders (live asks first), feed health and the IST clock. The mode, Product, Lots and One-click stay set when you go to another screen and back, until Vyuh restarts.

Keys

Alt+1…9 select a chart. Esc leaves a drawing tool or restores a maximised chart. Typing a letter or digit opens symbol search.

Order flow, footprint and seconds charts

Trade → Charts → Chart type and Indicators

What it shows

• Volume footprint (Chart type): at each price inside a candle, the volume sold into the bid (left) next to the volume bought at the ask (right), each bar's delta (buying minus selling), its point of control and value area, diagonal imbalances and stacked-imbalance zones, and signals for big orders and absorption. Zoom in until the numbers show.
• Order-flow indicators (Indicators → Order flow): Cumulative Volume Delta (buying minus selling added up through each day, or across days), Volume Delta (each bar's delta, green above zero and red below) and Order Book Imbalance (total resting bid quantity against total ask quantity at each bar's end, from −100 to +100).
• Seconds charts: 5 seconds, 15 seconds and 30 seconds in the top bar's interval menu, and 5s, 15s and 30s update steps in bar replay.

Where the buy and sell split comes from

A footprint needs every trade marked as buying or selling. Indian brokers don't send that: their feeds send a snapshot about once a second with the day's total volume, the last price and the best bid and ask. Vyuh splits each snapshot's new volume itself: at or above the ask counts as buying, at or below the bid as selling, and in between by whether the price ticked up or down (an unchanged price keeps the last side). This is the standard method, but it works on one-second batches rather than single trades, so read it as a good estimate, not exchange-exact.

Limits

• Recorded while Vyuh runs, for the instruments on your charts. Vyuh keeps the split (30 days) and its 5-second candles (7 days), so a restart loses nothing. No broker provides past bid/ask volume or candles under a minute, so days before Vyuh was recording show the footprint estimated from 1-minute candles (as much buying as each 1-minute candle closed up its range), and a seconds chart starts from when the instrument was first charted. The footprint says at the top which bars are recorded and which estimated; the indicators use the same estimate where nothing was recorded.
• Spot indices have no trades. NIFTY 50 spot itself has nothing to split. Use the NIFTY future or options for order flow.
• Brokers without market depth in the feed get the price-tick rule only, which is less accurate. Order Book Imbalance needs the depth.
• The footprint fills bars of a minute or more from the recording (it is kept by the minute); a seconds footprint is estimated from its candles.

Scalping

Trade → Scalping

• Top strip: Options, Futures or Any instrument; NFO or BFO; underlying, expiry, and the CE and PE strikes (marked ATM, ITM n, OTM n). At its end, Scalp margin ₹… is the margin this terminal's open positions use, from your broker's margin calculator, else the imported SPAN file. It refreshes every 15 s and shows ₹0 with none open.
• Strikes: the call and put strikes settle at the money when a fresh chain first shows, then stay where they are, or where you move them, as the market moves. An order always uses the strike on screen. A strike that leaves the chain shows —, and its buttons and keys are off.
• Price tiles: call, index and put with the day's low–high bar (ring = open, triangle = last price), change on yesterday's close, and the open. Charts shows all three at 1m, 5m or 15m.
• Order ticket (right):
  • One-Click off: every order asks first, keys are off. On: clicks and keys send at once; in live it asks first.
  • Lots, MIS or NRML, Market or Limit at LTP; Net qty and MTM.
  • SL, Target, Trail in points or %, for every scalp in this mode.
  • Buy Call ↑ and Sell Put ← are green (bullish); Buy Put → and Sell Call ↓ are red (bearish).
  • Set Call SL / Set Put SL (Set SL and Reverse for futures and other instruments; Reverse asks first when One-Click is off), Close All Positions (F6), Cancel All Orders (F7). Close All Positions tries every position and says what it sent and what it couldn't.
• Positions, Order Book, Trade Book: today's scalps with SL, target, trail, risk to the stop, P&L; cancel or close from the row.
• Keys and voice: rebind keys (ignored while typing, on auto-repeat, within 0.3 s, and while another dialog or menu is open); spoken confirmations.

Scalping orders use the default broker account. Lots, product, order type, One-Click, the expiry and the strikes (kept per underlying) stay set when you go to another screen and back; a restart opens on 1 lot with One-Click off. One-Click switches off when another window changed the underlying. Any Lots box (here, the chart strip, Strategies and the leg builder) can be cleared while you type a new number.

Options

Trade → Options

Pick an underlying and expiry. The page needs prices from a signed-in broker; with the market closed it works on the last session's prices.

Header figures

Spot, forward, ATM IV, India VIX, PCR, max pain, 1σ move to expiry, trading days to expiry, and flow. Pricing is Black-76 on the forward, with trading time that skips holidays.

Tabs

Σ ΔOI tube and minute history

• Calls left, puts right, against yesterday's close, with 15 and 30 minute changes. Play or drag to replay; Now returns to the latest minute. When closed, it shows the last session.
• NIFTY, BANKNIFTY, SENSEX: Vyuh records each minute while signed in and fetches missed ones (late sign-in, disconnect, holiday) from your broker's history. Without history: "No historical data", and minutes are saved live only. Other chains: press Download historical data for today (or the last session).
• Change in OI needs yesterday's OI from your broker's history; without it the desk shows ΔOI n/a. See Broker APIs.

Strategy builder (below the chain)

• Add legs from the chain, the Strategy Library (42 templates by view), or "Add a position". A leg's entry price takes decimals.
• Tabs: Payoff, Greeks, P&L table, Margin (with and without the hedge), multi-strike OI. What-if sliders: spot, IV shift, days forward.
• Summary: net premium, max profit and loss, reward:risk, POP, breakevens, margin, P&L now, and the Greeks.
• Save a basket by name, then Execute (paper) or Execute LIVE. Buying legs go first. If a leg fails, the confirm says which legs may already be placed: check Positions and Orders before trying again. Vyuh doesn't retry.

Positions

Trade → Positions

• Every position marked to market. The switch at the top shows paper or live, never added together.
• Totals: total, realised and unrealised P&L, open positions, margin used.
• Paper margin: bought options block their premium, closing orders hold no margin, and a restart keeps positions that strategies share. Paper fill prices with slippage are rounded to the tick. With the SPAN margin file (Settings → Trading), a futures calendar spread pays exposure margin on a third of the far leg, and contracts expiring that day get no spread benefit.
• Heatmap: tile size is the exposure; colour is the P&L as a percentage of the entry.
• Views: Strategy positions (including "Manual & scalping") and Net positions.
• Per row:
  • qty, entry, entry time, LTP, stop-loss / target, P&L;
  • a chart showing fills, average, stop and target;
  • Exit;
  • click the SL/target to change it (blank removes it).
• Close positions per strategy, Close all open positions, and Export CSV.
• At the broker: your default account's net positions, including trades made outside Vyuh. If Vyuh's book differs, use "Mark flat in Vyuh"; Vyuh never trades to fix a difference.

Orders & trades

Trade → Orders & trades

• Every order Vyuh sent, paper and live: time (IST), instrument, side, qty, type, average price, status and the broker's message.
• Totals: buy, sell, completed, open, rejected.
• Working orders: Modify (qty, price, trigger) and Cancel. Modify opens with the order's current values and sends only what you change. It's refused while the kill switch is on. With Live trading off, a change that adds risk is refused: more quantity, or a price that would trade at once on an order that doesn't only reduce a position.
• Decisions: what Vyuh decided to send, and why each order went through or was stopped (limits, duplicates, kill switch …).

GTT orders

Good-till-triggered orders waiting at your default account's broker, each with its trigger and order, and an ✕ to cancel (asks first). The card shows only for brokers whose official API offers GTT:

Place new GTTs through the assistant or the Local API. GTT at Fyers, Groww, Upstox, Angel One and Dhan hasn't been tried on a real account yet: check your first one on the broker's own website.

Strategies

Automate → Strategies

Left column

• Your strategies, each with its mode badge and on/off switch. A switched-off strategy ignores alerts.
• New strategy:
  • name;
  • kind: Signal-driven (acts on alerts) or Multi-leg batch (enters on start);
  • instrument group: weekly & monthly expiries (NIFTY, SENSEX), monthly-only indices, stocks, MCX;
  • underlying;
  • Positional (NRML; CNC for stocks) or Intraday (MIS, entries 09:20–15:00, exit 15:15);
  • then Create strategy. New strategies start switched off and in paper.
• Top: Templates (options templates and automation presets, including your backtested presets), Export and Import (JSON, never with keys or URLs).

Buttons: Close positions (the strategy stays on), Stop and close (switches it off and closes its positions), Delete, Save. On the Canvas tab, Apply to strategy keeps the strategy's other settings.

The form (Form tab; Canvas is a no-code block view)

Each setting below comes with an example. Rupee figures assume 1 lot of NIFTY = 65 units; Vyuh always uses the contract's current lot size. NIFTY options move in ₹0.05 ticks. Stops and targets are checked against the last traded price of the contract held, and the exit is a market order (live: a protected limit), so the fill can be a little worse than the level.

Strategies: advanced exits, by example

The Advanced exits card. Stops only ever move in your favour, and every level is measured from the average entry price. In the examples you bought 1 lot of NIFTY 24,000 CE at ₹150. For a sold option everything is mirrored: the best price is the lowest one, and the stop sits above it.

Trailing stop

Trailing stop: start after is the profit, from the entry, that the best price must reach before the trail starts. Trailing stop: trail by is read according to the Trailing style. Save refuses a trailing stop with only one box filled, and names the box.

The stop never sits at the best price itself. In the first row, at ₹180 your 30 points are not all locked: the stop is ₹160, so 10 points are locked. To keep more, trail by less.

The other exits and entries

A re-entry still waiting is dropped once a newer signal for the strategy has been handled. Entries and approvals waiting from paper never go out after you switch the strategy to live.

Strategies: combined P&L, CAS exit, option legs

Combined open P&L

Its own card: the unrealised P&L of the strategy's open positions added up. Each limit closes all of them. The example is a short straddle, 1 lot each: 24,000 CE sold at ₹150 and 24,000 PE sold at ₹140.

Only open positions count: once a leg has closed, its booked P&L is no longer part of the total. Vyuh checks the total about once a second while prices come in. The lock remembers the best total while Vyuh runs; after a restart it starts again from the current total.

Closing Auction Session (CAS) Exit

Its own card; from 3 Aug 2026; off by default. On each trading day, from From (default 15:15) to the F&O close, Vyuh watches the main leg's premium on candles of the chosen Timeframe: 1 minute (default), 3, 5, 15 or 30. When the premium turns against the position on a closed candle, Vyuh closes every leg of the strategy. If it is already against the position at the first candle close after From, Vyuh exits then rather than waiting for a fresh turn. Exit style: Tighter exit — reacts sooner (like your script's Shorter Closing) or Looser exit — gives the trade more room (like Lengthy Closing). Main leg: Sold leg, else bought (default), Sold leg or Bought leg.

Example: a positional strategy holds a sold NIFTY 24,000 PE. At 15:15 its premium has been falling, which suits the seller. On the 15:22 candle it turns up, against the seller, and at that candle's close Vyuh closes all the legs. If instead the premium had jumped from ₹42 to ₹55 within a single candle, more than an average candle's size past the exit level, Vyuh would exit at once instead of waiting for the close. It exits once a day; the notice says which way it fired. It acts on a turn: if the premium is already moving against the position at 15:15, Vyuh waits for it to turn in your favour and then against again. MIS positions are squared off at 15:15 anyway, so this matters for positional strategies.

Option legs

• Empty: the strategy trades the alert's instrument itself. With legs, each signal opens these contracts on the underlying. Up to 10 legs.
• Per leg: On signal (Long (BUY) or Short (SELL)); Contract (CE (call), PE (put), Future or Stock (cash)); Side (Buy, or Sell to write); Lots (shares for a stock leg); Strike; Expiry: Current week, Next week, Current month or Next month, shown with the actual dates.
• Strike, ATM / ITM / OTM: steps are listed strikes, 50 points apart for NIFTY near the money. ITM and OTM are worked out for a call or a put, and stay as picked if you switch a leg between CE and PE. With NIFTY at 24,012, ATM is 24,000:

• The underlying price used is the alert's own price if it carries one (e.g. {{close}}); otherwise that expiry's forward from the option chain, or the index spot, never the monthly future.
• Other strike rules: Premium ≈ ₹ 100 takes the strike priced nearest ₹100; Premium ₹ min–max 80-120 takes, of the strikes priced ₹80 to ₹120, the one nearest the money; Delta ≈ 0.25 takes the strike with delta nearest 0.25; % from ATM 1 takes the strike nearest 1 % above the underlying (24,012 → 24,250). A positive % is a higher strike for puts too, so use −1 for an out-of-the-money put (23,750). × straddle width 1: with the ATM straddle at ₹150 + ₹140 = ₹290, calls go to 24,300 and puts to 23,700. Premium ≥ ₹ 100: within 10 strikes of ATM, the cheapest at ₹100 or more; Premium ≤ ₹ 100: the dearest at ₹100 or less. Strike: that strike exactly.
• This leg's exits, on the line below each leg, in pts or % of the leg's own entry. Sold 24,050 PE at ₹160, in pts: Stop-loss 40 exits at ₹200; Target 80 at ₹80; Trail: every 20 → move stop by 20 moves the stop down 20 for every 20 the premium falls: ₹180 at ₹140, ₹160 at ₹120, ₹140 at ₹100. An empty box uses the strategy's Stop-loss, Target or trailing stop. Each leg keeps its own exits, even when two legs are the same type and side (e.g. two sold calls at different strikes).
• Buying legs go first, then selling (writing) legs, so margin benefits apply and a selling leg never goes out alone when a buying leg fails.
• If a leg is refused after others went, those stay open under their stop-loss and target, and an alert goes out (on screen and Telegram). Vyuh retries the missing leg up to 6 times, 2 s apart, at the same strike, then one strike either side. A second alert says when the basket is complete, and at which strike, or that it couldn't be completed, naming the open legs.

Signals card

• Copy: copies the webhook URL with the key (shown masked), or the local URL while the tunnel is offline. It is the only address an alert needs; messages carry no key.
• Test: sends a test alert; no order.
• New key: click twice. Old URLs stop working at once; paste the new one into your alerts.

Symbol mapping

Translates alert symbols (e.g. NIFTY1!) to broker instruments, as a fixed symbol or the nearest-expiry future, per strategy or for all. "Unknown symbol" in Alerts means a mapping is missing.

Strategies: worked examples

Settings working together. 1 lot of NIFTY = 65 units throughout.

1. NIFTY option selling, intraday

Product MIS; Short selling on; Stop-loss 30 %; Profit lock 3,000 → 1,500; Time exit 15:10. Legs: Long (BUY) → PE, Sell, 1 lot, ITM1, Current week; Short (SELL) → CE, Sell, 1 lot, ITM1, Current week.

Other days: had NIFTY fallen at once, the stop at ₹208 would have closed the PE for about −₹3,120 (48 points). Had nothing fired, the 15:10 time exit would have closed it. A SELL alert with NIFTY at 24,060 (ATM 24,050) closes the PE and sells 1 lot of 24,000 CE (ITM1 for a call), with its own 30 % stop.

2. A trailing stop with breakeven

Bought 1 lot of NIFTY 24,000 CE at ₹150. Stop-loss 30 points; Move stop to breakeven after 20 points; Trailing stop: start after 40 points, trail by 25 points; Trailing style Behind the best price.

Had the price turned at ₹185, the exit would have been at ₹150, about cost.

3. A short straddle with leg exits and a basket stop

Timed entry 09:20, BUY, NIFTY; legs on Long (BUY): CE Sell 1 ATM and PE Sell 1 ATM, each with This leg's exits in pts: Stop-loss 40, Trail every 20 → move stop by 20. Basket stop ₹2,000; Trail SL to entry price on. At 09:20, with NIFTY at 24,010, Vyuh sells 24,000 CE at ₹150 (stop ₹190) and 24,000 PE at ₹140 (stop ₹180).

After the CE closed on the trending day, the basket stop saw only the PE: the CE's booked ₹2,600 was not counted. The basket stop on the volatile day counts as two stop-losses toward Re-entries after stop-loss.

4. A NIFTY future with a capped re-entry

Alerts trade the NIFTY future (Symbol mapping NIFTY1! → nearest future). Lots per entry 1; Stop-loss 50 points; Re-entry after a stop-out Back at entry price; Re-entries after stop-loss 1.

Scripts

Automate → Scripts

Indicators (OpenScript)

• Write indicators in OpenScript. Saved scripts appear under "My scripts" in every chart's Indicators list. They draw only and never trade.
• New script, Save, delete; Import TradingView script translates on your PC (review the notes it gives).
• Backtest strategy scripts in History → Backtest.

Python strategies

1. Install Python 3 from python.org (tick "Add to PATH").
2. Turn on Settings → Local API, plus Allow orders if the script should trade.
3. Press Find Python → Use, then New Python strategy, Save and Start.

Per script:

• a main.py editor;
• a schedule (start and stop, IST), restart after a crash up to N times, and a memory limit;
• Secrets: environment variables kept in the keychain and masked in the output;
• live Output, with logs saved daily; a line over 2,000 bytes is cut (secrets are still masked);
• Sandbox, off by default:
  • Low integrity: keeps the script from changing your files and the scripts' code; it can still read files and use the network. It doesn't protect against another Low-integrity program running at the same time, so Vyuh runs one Low script at a time: use Isolated to keep scripts apart;
  • Isolated: each script in its own sandbox container, with its own folder only and no internet (no outside data feeds, no pip installs while it runs). It reaches Vyuh through a private pipe, which quay_client handles. The first time, Vyuh gives the sandbox read access to your Python's folder.
  Both need Python from python.org: Windows won't sandbox the Microsoft Store's Python, and a Python in your Downloads, Desktop, Documents or profile folder is refused.

The script's folder. Scripts run in their own work folder. Files saved by earlier runs are moved there once, and Python code stays beside main.py; the first run notes what moved and names any Python files kept, so you can spot one you didn't add. After every run Vyuh closes the folder and checks it. A folder it can't close is refused next time: copy the script, delete it and add it again. A script whose folder (outside work) contains a link is refused.

Limits: 32 processes, 50% CPU, no clipboard. Each run gets a fresh local API key: Vyuh passes a script only its own key and the secrets you set for it, never your broker tokens.

Alerts

Automate → Alerts

• Every alert that reached Vyuh: received time (IST), strategy, action, outcome with the reason, and latency. Keys are always masked.
• Totals: alerts, accepted, tests, rejected, duplicates.
• Common outcomes:
  • accepted, with what was sent;
  • test;
  • rejected: wrong key, strategy off, outside the entry window, kill switch, trade limit, holiday, live trading off, unknown symbol, stale (more than 60 s old), awaiting approval, engine busy (32 of the strategy's alerts already waiting);
  • duplicate.

Approvals

Automate → Approvals

• Semi-automatic mode (Settings → Trading → Order approval, per mode): signals that would open a position, and Local API orders, wait here and on the Dashboard.
• Approve re-checks prices and limits before sending; Reject drops the request. Requests expire after 5 minutes. A request made while the strategy was in paper never goes out live, even if you switch the strategy to live meanwhile.
• Approve all approves exactly the rows on screen, one by one. While it runs, the row buttons can't be pressed, and the other way round. A request already decided says "already decided or expired".
• Exits (signal exits, stop-loss, target, trailing, square-off) never wait.
• History: every approval decision, newest first, also kept in the audit log.

Orders from the Assistant and AI apps are approved on their own cards (Assistant tab, or the pop-up for AI apps), and from Telegram for paper.

• A waiting card is checked again when you approve it. It's refused, with the reason, if since it was made the assistant went read-only, the assistant-stop file appeared, the tool or account-wide actions were switched off, or the AI client was removed.
• With Ask for the app password before approving a live order from the assistant on (Settings → AI assistants), the pop-up and Settings → AI assistants → AI clients ask for the password too.

Reports

Analyse → Reports

History: data and backtests

Analyse → History

Data

• Keep an instrument's history: instrument, interval, from date → Keep. It downloads from your broker; without one, Vyuh records candles from live prices.
• Kept up to date: gaps, Sync, Stop, delete; "After every close" auto-sync; Sync all.
• Expired contracts (Groww, from 2020): exchange, underlying, year, then expiry, contract, interval → Download.
• Import a CSV or Export (Parquet or CSV) to a Vyuh folder in your Downloads.

Backtest

• Backtest a script: an OpenScript strategy on stored candles, filling at the next bar's open, with a trades CSV and a tearsheet; then Walk-forward (its boxes take decimals) and Robustness (Monte Carlo).
• Backtest an options template:
  • any Strategy Library template, run once a day on a stored index series;
  • enters at a time, with strikes from that moment's ATM;
  • exits at a time or on a stop-loss or target in rupees;
  • premiums are modelled (Black-Scholes at a flat IV), not real past option prices.

Portfolio and SIP

Portfolio: weighted holdings on daily closes, with rebalancing and costs. SIP: a monthly amount with a yearly step-up, and XIRR.

Arbitrage

Analyse → Arbitrage

• Tabs: Calendar spreads, Cash-futures, Rollover. Priced from live bid and ask, ranked by what you'd keep after charges, annualised.
• Filters: exchange, pair, minimum spread %, minimum annualised %, minimum bid/ask qty, minimum OI, underlying (end with * for a prefix), "Order book on both legs". The two minimum % filters, and the values in Rate & charges, take decimals.
• Trade opens a two-leg basket (paper by default). If a leg fails, the confirm closes and says some legs may already be placed: check Positions and Orders before trying again.
• Rate & charges holds the interest and charge rates; check them against your broker.
• STT follows Budget 2026 from 1 April 2026: futures 0.05%, option premium 0.15% (sell side), exercised options 0.15%. Earlier trades keep the old rates. Vyuh's charges here, in Reports → Analytics, on order cards and in the Options builder all use these. Rates you saved yourself in Rate & charges keep their value until you edit them.
• Rollover: futures expiring within N days; Roll sends both orders under the position's strategy and mode.
• Needs Zerodha full-mode quotes in market hours. Reverse cash-futures is flagged "needs SLB".

Assistant

Analyse → Assistant

• Built-in (no AI key): short commands and quick buttons (Today's summary, Positions, Greeks, Payoff, Expiry risk, NIFTY chain, Orders today, Funds, Watches, Calendar). Orders still come as cards you approve; it asks when lots, CE or PE, or MIS or NRML is missing, and never picks a strike for you.
• Model: Claude with your own Anthropic API key, or an OpenAI-compatible endpoint (e.g. Ollama at http://localhost:11434/v1). Keys are kept in Windows Credential Manager. Setting it up: the next page. An endpoint, and the Voice card's transcription endpoint, may use plain http:// only to localhost, 127.0.0.1 or [::1], checked when saved and when used.
• Voice: speak instead of typing (Silent or Voice). New chat starts over. Enter sends.
• Each tool it uses is shown, and each order is a card with PAPER/LIVE, details and the "Why" (your request). Approve or Reject, or say "confirm" to approve the newest waiting order card; for any other card, or one needing the app password, it points you to the card. A basket sends its buying legs first; if a leg fails, it says which legs went (it doesn't retry).
• Watches: "tell me on Telegram when NIFTY crosses 25,000", "send my P&L at 15:30 daily", or "send me a ready check at 09:00 every trading day". Creating or deleting one asks on a card first.
• Facts it can give: performance, Greeks and what-if, chain summary, futures basis, calendar, tax summary, slippage, symbol comparison, sector rotation, audit search, latency per broker, order pacing and rate limits, positions near expiry, "what if I'd exited at…", monthly target progress, your return against an index, and a self-test of its tools.
  • Greeks price each expiry on its own forward and list any leg they skip, with the reason. Performance, the monthly target and the index comparison include manual trades.
  • The tax summary takes the segment from the exchange (a share whose name ends in CE or PE, like RELIANCE, isn't an option), adds CTT for MCX, pairs same-day share trades first, and counts a sale as long-term after the first anniversary (IST).
• Checks it can run: "will my TV test alert trade?" (every check an alert must pass, with the fix for each) and the retail-algo rules against your accounts (static IP, algo ID, order tags on today's live orders).
• Export as a trade journal: the conversation, today's trades and your notes, saved to the journals folder.
• Answer in: pick one of 10 languages; symbols, numbers and button names stay as they are.
• Settings → AI assistants controls what it may do: read-only, per-tool switches, account-wide actions (with the app password), the password for live approvals, and order limits. It also lists your saved preferences.

Assistant: connecting an AI model

Analyse → Assistant → Model card

Vyuh doesn't include an AI model: you connect your own for questions in your own words. Until you do, the built-in assistant answers short commands (type help), and everything else in Vyuh works as usual. Open the Model card with the button at the top of the Assistant page.

Three ways to connect one

Get and save an Anthropic API key

1. Go to console.anthropic.com and sign in, or create an account.
2. Under Billing, add credit. The API is prepaid.
3. Open API Keys → Create key and copy the key. It starts with sk-ant- and is shown only once.
4. In Vyuh, open Analyse → Assistant. In the Model card, pick Claude (Anthropic API), paste the key into Anthropic API key and press Save. The card closes and Send works.
5. Back in the Anthropic console, set a monthly spend limit, so a busy day can't run up an unexpected bill.

The Model card

Change these later with the button showing the model's name, at the top of the Assistant page.

Sector rotation

Analyse → Sector rotation

• NSE sector indices against a benchmark (e.g. NIFTY 50), on weekly closes:
  • right means stronger than the benchmark, up means gaining strength;
  • sectors tend to rotate clockwise: Improving → Leading → Weakening → Lagging.
• Benchmark and tail length (weeks) are selectable. The table lists each sector's quadrant, ratio and momentum.
• Needs about 40 weeks of closes: Update history (broker) or Import history from CSV (Date, Close; e.g. from niftyindices.com).

Audit log

Analyse → Audit log

• An append-only record of everything Vyuh and you did: orders, fills, stop moves, strategy changes, live-switch changes, key copies, Local API and AI requests, approvals.
• Each entry is hash-chained to the one before it. Verify integrity checks the chain.
• Export CSV for a date range. Kept for good (the retail-algo rules ask for 5 years).

Connect: broker accounts

System → Connect

1. Add account → broker, an optional name, and Sandbox if the broker offers one → Add.
2. Open the row and fill in its fields (API key and secret, client ID …). Register the Redirect URL shown on it in your broker's developer app, and register your static IP with the broker.
3. Sign in or press Connect: Vyuh saves what you typed first. Each broker's steps are in Broker APIs, the pages after this one.

• Make default: the default account is used for funds and for manual, scalping and AI orders, and for prices unless you pick another account under Market data. Each strategy can trade on its own account.
• Row buttons: Refresh instruments, Sign out, Remove (deletes its keys only).
• Every account has Algo ID and Static IP registered with the broker fields.
• Static IP (for every broker): Check this computer's public IP compares this computer's public IP with each account's Static IP registered with the broker, and names any account that doesn't match or has none. The setup wizard uses the same check.
• Zerodha (Kite Connect) card: Zerodha's own steps only (the Kite developer app, the API key and secret, and the daily sign-in, since sessions end at 06:00), with a link to Zerodha's static IP guide. Each sign-in carries a one-time code; a reply that belongs to another sign-in is ignored.
• Session end: when a session reaches its end time (Zerodha's at 06:00 IST every day, others when their token lapses), Vyuh signs the account out within 30 s and sends a notification to sign in again. The row shows Session ended … · sign in again instead of Connected, and prices move to the backup feed if one is set and signed in.

Market data

• Prices from: the account whose feed gives prices, option chains, charts and history. Orders, funds and positions always use the trading accounts.
• Backup feed: an account that takes over when the main feed sends nothing for 30 s in market hours. See Brokers.

Broker APIs: before you start

Vyuh trades and gets prices through your broker's own API, a developer key you create once at the broker (about 10 minutes); after that you only sign in each day.

The same four things at every broker

1. Open the broker's API page (the link on its card) and sign in with your trading account.
2. Create an app or key. Where it asks for a Redirect URL, paste the one Vyuh shows on the account row in System → Connect (also on each card here).
3. Register your static IP (SEBI refuses API orders from any other address since 1 April 2026). Get one from your internet provider or use a VPS; most brokers take a primary and a backup IP.
4. Copy the keys into Vyuh: System → Connect → Add account → the broker → paste the values named on its card → Save → sign in.

Free or paid

Historical data

History feeds Charts, backtests and the Options page's full-day minute history. With a No history broker Vyuh keeps only the minutes it sees live. Option flow and exposure history also need open interest in the candles, which not every broker sends.

Change in OI by broker. Should work: Zerodha, Dhan (with Data APIs), Sahi, Upstox, Fyers, Shoonya, Flattrade, Zebu, TradeSmart, Compositedge, RMoney, Definedge and Firstock. May work: Angel One and Groww. ΔOI n/a: 5paisa, m.Stock, Samco, Alice Blue, Kotak Neo, Tradejini, Rupeezy, IIFL Capital and every No history broker.

Prices as each broker published them in October 2026; they may change, so check before you subscribe. Brokerage and taxes are separate. Vyuh never types your password or 2-step code: where a code is needed you type it, and it isn't stored.

Free broker APIs

No subscription for orders or live prices. Brokerage still applies.

With historical data

Without historical data (live prices only)

Paid broker APIs

A monthly plan is needed for live prices, or for the API itself.

Broker APIs with no clear cost information

These brokers don't clearly publish what their API or live data costs, or their pages disagree. The steps work; ask the broker about fees before you rely on one for prices.

Integrations

System → Integrations

Tunnel (your public webhook address)

• ngrok (free): paste your authtoken, leave Domain empty to use your free fixed domain → Save & start → wait for Online.
• Cloudflare (your domain): create a tunnel in Cloudflare and route a hostname (e.g. hooks.yourdomain.com) to 127.0.0.1:47321. In Vyuh: Download cloudflared, paste the token and hostname → Save & start.
• The tunnel starts with Vyuh and reconnects by itself.
• Protection:
  • optionally accept alerts only from TradingView's IP addresses;
  • limits of 10 alerts a second and 60 a minute per strategy;
  • a request limit for each sender (none for TradingView's own addresses), so junk sent to a wrong URL can't hold up your real alerts;
  • an address is blocked for 24 h after 10 wrong keys. This PC, TradingView's addresses and addresses passed on by the tunnel are never blocked automatically.

Signal sources

• Pick a strategy, then TradingView, GoCharting or Chartink.
• Copy the message with the key (Chartink: a URL per action, with Chartink's own key).
• Test webhook sends a test through the public URL with a one-time token. New key invalidates the old one at once.

Telegram

1. Create a bot with @BotFather and paste its token.
2. Message your bot, then press Find my chat.
3. Pick the categories: Trades, Errors, Risk, Connection.
4. Optionally turn on "Answer bot commands", for a private chat with your bot only (see section 9).

WhatsApp

A Meta Business app with WhatsApp, an approved Utility template with one variable, and a permanent token. Enter the access token, phone number ID, the number to send to, the template and its language. Meta charges per message.

Settings

System → Settings

Settings: licence checks

System → Settings → Licence

The licence decides only whether new live entries can start. Paper trading and orders that only reduce a position never need it; Scalping's Reverse does.

• At start: Vyuh checks the licence from its own records before any entry can fire; new live entries start once that passes.
• Server checks: a check that passed within the last 2 hours stands through later failures. When the licence server doesn't answer, Vyuh asks again after 1, 5 and 15 minutes, then every 30. Settings → Licence shows "Offline · locks in N h".
• Ended or can't be checked: only new live entries stop. A safety view keeps your open positions with Exit and Close all, working orders with Cancel, the kill switch and broker sign-in.
• Offline keys: one the server revokes stops working at the next check, after signing out too.
• The clock: turning it back doesn't revive an expired key, as Vyuh checks against Zerodha's and Dhan's own times. A clock more than 5 minutes off is corrected for. If it can't be, Vyuh says "This computer's clock is N minutes off. Set it right (Windows: Settings → Time → Sync now)."

Help

System → Help

• Tiles: video tutorials, website, Logs folder (secrets removed, kept on this PC), Audit log.
• Guides: how an alert becomes an order, paper and live, stopping everything, other signal sources and AI assistants, the keyboard.
• Troubleshooting: alerts don't arrive, alerts arrive but no order, Zerodha rejects live orders, no prices.
• Support: open the logs folder and crash reports (both stay on this PC; attach them yourself if you ask for help).

Part 4: Reference

Brokers: one for data, another for trading

Vyuh keeps three things apart: the default account (manual orders and funds), each strategy's account (its live orders), and the market data account (prices).

Exits always go to the account that holds the position, even if you have changed the default account or the strategy's account since. Dialogs and notes name the account an order will use, such as "your Dhan account" with its client ID.

There is no limit on accounts, and a broker can have several (your own and a family member's, say). More than one Zerodha account: the first is set up in the Zerodha (Kite Connect) card; for each further one, choose Add account → Zerodha, create its own Kite developer app with the same redirect URL (http://127.0.0.1:5170/kite/callback), save that app's API key and secret in the new row and sign in from there. Each app needs Zerodha's paid Connect plan for live prices.

"Broker 1 for data, broker 2 for trading"

1. Add both accounts in Connect and sign in to both.
2. Make broker 2 the default, so manual and assistant orders go there too.
3. Under Market data, set Prices from = broker 1 and press Save.

Vyuh uses one common symbol format for every broker, so prices match across them. Option chains and contracts are kept per broker, so switching Prices from doesn't cause "invalid token". Broker 2 must still have its instrument list loaded (Refresh instruments) and your static IP registered.

A backup feed

• Under Market data, set Backup feed to a third account (or the trading account) and save. None is set until you choose one.
• When the main feed sends nothing for 30 s in market hours (counted from 09:15, not from a pre-market sign-in), or its session ends, prices move to the backup. You get an alert, and a red PRICES FROM BACKUP banner shows the account and the time.
• Press Switch back once the main account is fine again; Vyuh then releases the backup account's feed, so prices don't come in twice. Orders are never moved: they always go to your trading accounts.

Alert messages Vyuh understands

Bare text works too: BUY, SELL, CLOSE LONG: Normal Exit, CLOSE SHORT: Trailing Profit, EXIT ALL. These use the strategy's Underlying (when the alert names none), with the key in the webhook URL, as always.

Message mapping (Signal sources, step 3) lets any indicator's own words drive a strategy. Each row is a text, how it matches (Exactly, Starts with, Contains) and the signal it means: Buy, Sell, Close long, Close short, Exit all, or Ignore (recorded, never traded). Vyuh matches the message's first line, ignoring case, emoji and symbols; for a JSON message with no action it reads its text or message field, so a Telegram-style alert like {"chat_id": …, "text": "🟢 BUY NIFTY … CMP: 24512"} works as it is. The symbol is the word after the signal (else the strategy's Underlying) and the price the number after CMP: or PRICE:. A message that matches no row, or rows with different signals, is refused and shown in Alerts. Reset to defaults gives BUY, SELL, CLOSE LONG, CLOSE SHORT and EXIT ALL.

Replies: 202 accepted, 200 test_ok, 200 duplicate, 401 wrong key, or rejected with a reason.

Other sources

Safety rules and limits

Exits, as they work

• Live trading off blocks only new entries. Orders that reduce or protect an open live position still go to the broker: exits, stop-loss, target, trailing, time exits, MIS square-off, the kill switch's square-off, cancels, and changes that only reduce. A change that would add risk (more quantity, or a price that trades at once on an order that doesn't only reduce) is refused.
• For a position above the freeze limit, no stop-loss order is placed at the broker: Vyuh watches that stop itself, and a warning says so.
• Vyuh never sends an exit twice. It counts its own working exit orders, after a restart too, also at brokers that don't echo Vyuh's order tag (Paytm Money, Samco, Sahi, Kotak Neo, HDFC Securities). When a stop is hit, a resting exit of Vyuh's is re-priced to a limit that trades at once, or cancelled and replaced once the broker confirms the cancel.
• An exit that is skipped or stuck raises a warning; it never fails silently.
• At every broker, an order whose sending times out, or whose reply can't be read, is looked up up to three times over about four seconds. It is never sent again unless the broker clearly doesn't have it; otherwise you're told: "Check the broker's order book before placing it again." TWAP and iceberg executors stop on a slice whose outcome is unknown.
• A broker stop-loss Vyuh can't tell about. When Vyuh can't tell whether its broker stop-loss for a position was placed, it looks it up first. Your own actions (the kill switch, Close All, a close button) go at once, with a warning that the broker's stop-loss may also fire, so check the order book. Vyuh's automatic exits (stop, target, trailing, time exit, MIS square-off, expiry-day exit, daily loss) wait up to 60 s for an answer, then go anyway with a loud alert, Telegram included. Selling a bought option is the exception: Vyuh keeps waiting and alerts once a minute, because a double exit there would leave a naked short.

Nothing is dropped

• An exit held up by a stop-loss change, or by another exit of the same position under way, is owed. It is retried every 5 s until the position is flat, and messages say "it is closed once that one finishes".
• A kill switch that is on keeps squaring off whatever in its scope is still open, every 5 s while that market is open, until flat or reset, after a restart too. A kill you trip stays yours after a restart, so its square-offs still go at once.
• When Vyuh follows up an exit, your own working close orders that would fill now (market orders, or limits at or through the price) count as cover, so it closes only the rest.
• A rejected exit is retried after 5 s, then 30 s. After three rejections Vyuh stops and alerts: "<account> rejected Vyuh's exit of X three times: <reason>. Close it at your broker."

Stop-loss and re-entry limits, as they work

• "Re-entries after stop-loss" counts a strategy's stop-loss exits per day, trailing-stop and breakeven exits included, and each leg a basket stop closes. New entries are refused once the count is above the setting: 0 means no entry after the first stop. It resets daily.
• Winning trades don't reset it, and exits on a signal, a time or the basket target don't count. There is no rule that stops after N losing trades in a row.

Troubleshooting

Alerts don't arrive

• Integrations → Tunnel must be Online; press Test webhook.
• The alert's URL must be the strategy's, with its current key. Copy it again after New key.
• "TradingView IPs only" refuses other senders; check the blocked addresses for a 24 h ban.
• TradingView needs a paid plan and 2-step sign-in. Alerts older than 60 s are stale, so check the PC's clock.

The alert arrived but no order was placed

• Ask the Assistant "will my <strategy> alert trade?": it checks everything below and says what to change.
• Alerts shows why: strategy off, outside the entry window, kill switch, trade limit, holiday, live trading off, unknown symbol, already in position (an entry order still working counts), awaiting approval, engine busy.
• Orders & trades → Decisions shows Vyuh's refusals: risk limits, duplicate within 3 s, self-trade, sandbox capital (paper), no licence for live entries.
• For option legs: "no underlying price" or "no live price" means the feed isn't signed in, or the strategy was switched on too late. Switch it on a few minutes before 09:15.

The broker rejects live orders

• The session ended (Connect shows Session ended … · sign in again), or the IP isn't your registered static IP (Connect → Static IP → Check this computer's public IP).
• Margin or RMS: the broker's message is on the order. Protected limits can stay unfilled in fast markets.
• Zerodha's refusals are named plainly, such as "your Kite Connect app's plan doesn't allow this"; an IP refusal is recognised exactly.

No prices, empty option chain or charts

• Zerodha needs the Connect plan and today's sign-in; Dhan needs its Data API. Prices flow only while Vyuh runs.
• "No live feed, using the alert's price" on a position means there's no live price for it.
• Zerodha sign-in stuck on "Waiting…": set the Kite app's redirect URL exactly as Connect shows it, press Cancel, and sign in again.
• With a separate Prices from account, that account must be signed in and have its own data plan. Connect → Market data shows which account prices come from.
• A Zerodha or Dhan feed that goes quiet on a dead connection is reconnected within about 40 s. Retries wait 1 s, rising to 30 s. Once the session has ended, the feed stops retrying and you get one notice to sign in again.
• A full feed: a Zerodha account's feed carries up to 3,000 contracts, a Dhan account's 5,000. When it's full, contracts that only screens use make room: positions, strategies, working orders and waiting entries come first, and one notice names what couldn't be added. If Dhan reports too many instruments, Vyuh drops the newest ones nothing needs and names them once.
• Contracts a closed screen used (option chain, OI profile, strike picker, builder, chart) leave the feed after about 10 minutes. Positions, strategies, working orders, waiting entries, alerts, open charts and Scalping keep theirs. Reopening a screen brings its prices back within seconds.

Red "PRICES FROM BACKUP" banner

The main feed was silent for 30 s in market hours, or its session ended. Sign in to it again, then press Switch back.

"Vyuh's database is locked"

This computer has no key for the encrypted database (new Windows profile, reinstall, copied data folder). Nothing runs until it opens: manage positions at your broker, and enter your saved recovery key. If Settings says the database isn't encrypted, the conversion didn't finish; it works as before and Vyuh retries at each start.

Vyuh stops at the sign-in screen

Vyuh couldn't check your access for 48 hours (no internet), your session ended (30 days without a refresh, or a device reset), or your access expired. Connect to the internet and sign in again; if your access has ended, choose a plan under Get access. Paper trading and exits keep working meanwhile.

Below the sign-in, a safety view keeps open positions (Exit, Close all), working orders (Cancel), the kill switch and broker sign-in. If Vyuh says the computer's clock is off, set it right. See Settings: licence checks.

"Live" still says PAPER

Changing Mode only edits the form. Press Save, and the badge turns LIVE. Live trading must also be on in Settings → Trading.

The window stops responding to clicks

Vyuh puts this right by itself. If it doesn't, press F5 or Ctrl+R, or use the tray icon → Reload screen. Only the screen reloads: the engine, feeds and orders keep running. The right-click menu with Copy and Paste shows only in text boxes and on selected text.

Keyboard shortcuts and files

Addresses and ports (this PC only)

Files

Vyuh is a tool that carries out your own rules. Trading in equities, futures and options carries substantial risk of loss. Paper or past results don't guarantee future results. Nothing in Vyuh or in this guide is investment advice.