v2 · Updated Jul 2026

Documentation

Everything you need to master paper trading on NISHIRA.TRADE — from your first order to AI-powered stock analysis, exports, and account security.

1. Getting Started

  • Sign up with Google, email + password, or mobile + password.
  • You instantly receive ₹10,00,000 and $10,000 in virtual balance.
  • Practice with real market prices — zero real money at risk.
Tip
Google sign-in is the fastest way to get started — one click and you're in.

2. Virtual Balance

  • INR balance — used for Indian stocks (NSE / BSE).
  • USD balance — used for US stocks (NASDAQ / NYSE).
  • P&L is tracked in real time on the Dashboard and Portfolio pages.
  • Balance is always visible in the header — dual pill on desktop, compact "₹10.0L" on mobile.
Note
Balance resets aren't allowed by design — keeping the number honest is the point.

3. How to Trade

  1. Open Markets → search or browse stocks.
  2. Click any stock → opens the Trade page (chart + order panel).
  3. Or hit the floating Quick Trade drawer from anywhere.
  4. Choose BUY / SELL, then Market or Limit.
  5. Enter quantity, review total + brokerage, tap Place Order.
  6. Check Portfolio for holdings and live P&L.
Tip
Start small — 1 share of your favorite stock and watch the P&L tick in real time.

4. TradingView Charts

Every Trade page embeds the official TradingView Advanced Chart with real NSE / BSE / NYSE data.

Timeframes — 1m, 5m, 30m, 1h, D, W, M.
Chart types — Candlestick (default), Line, Bar, Area.
Zoom — mouse wheel on desktop, pinch on mobile. Pan — click-drag horizontally.
Crosshair — hover to reveal exact OHLCV at any candle.

5. Chart Tools Reference

Crosshair

Precise price / time cursor for reading any candle.

Trend Line

Click two points to draw support / resistance.

Horizontal Line

Mark key price levels on the chart.

Fibonacci Retracement

Drag swing high → low for retracement levels.

Rectangle

Highlight consolidation zones and ranges.

Text

Attach a note directly on the chart.

Measure

Measure price movement % and bars traversed.

Zoom

Zoom into a specific time range for detail.

6. Indicators

IndicatorWhat it showsHow to addSettings tip
RSIMomentum: overbought >70, oversold <30fx → Search 'RSI'Default 14 works well
MACDMomentum + crossovers signal buy / sellfx → Search 'MACD'12 / 26 / 9 is standard
SMA / EMATrend direction — 20 / 50 / 200 dayfx → 'Moving Average'200-EMA for long-term trend
Bollinger BandsVolatility bands around pricefx → 'Bollinger Bands'20-period, 2 SD default
VolumeConfirms strength of price movesEnabled by defaultLook for volume spikes
SupertrendTrend-following with buy / sell arrowsfx → 'Supertrend'10 period, 3 multiplier

7. Reading Candlesticks

Each candle shows four prices: Open, High, Low, Close. A green candle closed higher than it opened; a red candle closed lower. Wicks show intraday extremes.

Tip
For the deep-dive on patterns (hammer, engulfing, doji, morning star), check the video course inside Learn.
New

8. NISHIRA.AI Assistant

A Gemini-powered trading tutor floating on every page as a 🚀 button.

  • Drag it anywhere — snaps to the nearest corner and saves position across sessions.
  • Ask about candlestick patterns, indicators, strategies, position sizing, or specific concepts.
  • Education-only guardrails — it will never tell you what to buy or predict prices.
  • Markdown-rich answers with suggestion chips to keep the conversation moving.
Note
If Google's free tier is rate-limited, the assistant transparently falls back to a backup model — you rarely see errors.
New

9. Stock Analysis Lab

Open the Analysis tab (brain icon) in the header to generate structured technical reports.

  1. Search a ticker and add it to the Stock Queue.
  2. Click Generate Report — the AI returns a 7-section breakdown.
  3. Review: Overview · Trend · Momentum · Support / Resistance · Volume · Risks · Educational Insight.
  4. Export as Excel, PDF, or Word from the download menu.
Tip
Reports are cached for 5 minutes per ticker — regenerating instantly returns the last result with no API cost.
New

10. Data & Report Downloads

Portfolio & Trades

Export holdings and full trade history as CSV or XLSX from the Portfolio and Dashboard pages.

Stock OHLC History

On any Trade page, hit Download Data, pick a date range + format (CSV / XLSX).

Analysis Reports

Analysis Lab reports export to Excel, PDF, or Word — ready to share or archive.

Everything is offline-ready

Files are generated client-side — no server round-trips, private by default.

New

11. Watchlist

  • On the Markets page, tap the in the top-right of any stock card to add / remove.
  • Your watchlist lives on the Dashboard with live prices and quick trade access.
  • Stored securely per user — visible only to you.

12. Leaderboard

Ranked by portfolio value. Toggle between 🌐 Global, 🇮🇳 India, and 🇺🇸 USAto see market-specific traders and returns in the right currency.

13. Security & 2FA

  • Open Security from your profile menu to enable TOTP 2FA (Google Authenticator / Authy).
  • Change password, review login activity, or delete your account permanently.
  • Forgot your password? Use the /forgot-password flow.
  • Sessions auto-warn after 30 minutes of inactivity for safety.
New

14. Troubleshooting

Fixes for the most common issues around AI reliability, rate limits, and malformed JSON responses.

429
Rate limit
402
Credits exhausted
5xx
Upstream hiccup
"Rate limit reached. Try again in a moment."429
Why: Google AI free tier caps at 15 requests / min. The Analysis Lab or NISHIRA.AI hit it during rapid retries.
Auto-recovery: Both endpoints already chain through gemini-2.0-flash → gemini-1.5-flash → Lovable gateway → gemini-2.5-flash-lite with exponential backoff.
What to do:
  • Wait 30–60 seconds, then retry — analysis results are cached for 5 min so a re-run is free.
  • Reduce burst usage: don't queue > 3 tickers in Analysis Lab within a minute.
  • Long-term: enable billing on your Google AI Studio key (2,000+ RPM) — the app will pick it up automatically.
  • Keep LOVABLE_API_KEY funded — it's a completely separate quota used as backup.
"Expected ',' or '}' after property value in JSON…"parse
Why: The AI's JSON response was truncated (token cap) or contained trailing commas / smart quotes.
Already fixed: maxOutputTokens is 4096, and a repair pass handles trailing commas, curly quotes, missing separators, and raw newlines.
If it still happens:
  • Retry once — different sampling usually clears it.
  • Shorten your prompt / pick fewer sections in the report to stay under the token budget.
  • Check the browser console for the raw payload; if it's obviously cut mid-word, that's a token-limit issue — file it.
"Credits exhausted" / 402402
Why: The Lovable AI backup gateway is out of credits AND Google is rate-limited.
Fix: Top up credits in Settings → Plans & credits, or wait for the Google quota to reset (1 min window).
Prices frozen or "N/A"feed
US stocks: Finnhub WebSocket drops outside NYSE hours — that's expected. Falls back to the last known price.
Indian stocks: Broker feed may throttle; the app auto-switches to a realistic simulated tick.
Fix: Refresh the page. If prices stay flat during market hours for 60+ seconds, the feed is temporarily down — try again shortly.
Balance shows ₹0 / $0 in headerinit
Why: Rare — profile row not fully initialized on first sign-in.
Fix: Sign out and sign back in. The useEnsureProfile hook re-seeds ₹10,00,000 + $10,000 automatically.
Excel / PDF / Word download doesn't startexport
  • Allow pop-ups / downloads for this site in your browser.
  • On iOS Safari, files save to Files → Downloads.
  • Generate the report first — an empty Analysis card has nothing to export.
Tip
Best practice for zero downtime: keep both a funded Google AI key and a funded Lovable AI Gateway — the app fails over between them silently, so you never see a hard error.
Note
Still stuck? Open NISHIRA.AI from the floating 🚀 button and paste the error — it can often explain what happened and what to try.

15. FAQs

Q: Is this real money?+
A: No — 100% virtual. Nothing on NISHIRA.TRADE touches real cash.
Q: Are the prices real?+
A: US stocks stream live via Finnhub. Indian stocks use live data from a broker feed with a realistic simulation fallback.
Q: Can I lose real money?+
A: Absolutely not. No funding, no withdrawals, no real brokerage.
Q: How is brokerage calculated?+
A: A flat 0.1% of order value is simulated on every trade to mirror real-world costs.
Q: Can I reset my balance?+
A: Not currently — keeping the number honest is part of the practice.
Q: How is my data protected?+
A: Row-level security on the database, TOTP 2FA, and encrypted sessions. Only you can see your holdings.
Q: Does NISHIRA.AI give buy / sell tips?+
A: Never. It's an educational tutor — it explains concepts, patterns, and strategy, not predictions.
Q: Which browsers are supported?+
A: Latest Chrome, Edge, Safari, Firefox. Mobile web works fully; use Add to Home Screen for an app-like feel.
Ready to place your first order?
Jump into the app — your ₹10L + $10k virtual balance is waiting.
Open Dashboard →