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,000and$10,000in virtual balance. - Practice with real market prices — zero real money at risk.
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.
3. How to Trade
- Open Markets → search or browse stocks.
- Click any stock → opens the Trade page (chart + order panel).
- Or hit the floating Quick Trade drawer from anywhere.
- Choose BUY / SELL, then Market or Limit.
- Enter quantity, review total + brokerage, tap Place Order.
- Check Portfolio for holdings and live P&L.
4. TradingView Charts
Every Trade page embeds the official TradingView Advanced Chart with real NSE / BSE / NYSE data.
1m, 5m, 30m, 1h, D, W, M.5. Chart Tools Reference
Precise price / time cursor for reading any candle.
Click two points to draw support / resistance.
Mark key price levels on the chart.
Drag swing high → low for retracement levels.
Highlight consolidation zones and ranges.
Attach a note directly on the chart.
Measure price movement % and bars traversed.
Zoom into a specific time range for detail.
6. Indicators
| Indicator | What it shows | How to add | Settings tip |
|---|---|---|---|
| RSI | Momentum: overbought >70, oversold <30 | fx → Search 'RSI' | Default 14 works well |
| MACD | Momentum + crossovers signal buy / sell | fx → Search 'MACD' | 12 / 26 / 9 is standard |
| SMA / EMA | Trend direction — 20 / 50 / 200 day | fx → 'Moving Average' | 200-EMA for long-term trend |
| Bollinger Bands | Volatility bands around price | fx → 'Bollinger Bands' | 20-period, 2 SD default |
| Volume | Confirms strength of price moves | Enabled by default | Look for volume spikes |
| Supertrend | Trend-following with buy / sell arrows | fx → '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.
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.
9. Stock Analysis Lab
Open the Analysis tab (brain icon) in the header to generate structured technical reports.
- Search a ticker and add it to the Stock Queue.
- Click Generate Report — the AI returns a 7-section breakdown.
- Review: Overview · Trend · Momentum · Support / Resistance · Volume · Risks · Educational Insight.
- Export as Excel, PDF, or Word from the download menu.
10. Data & Report Downloads
Export holdings and full trade history as CSV or XLSX from the Portfolio and Dashboard pages.
On any Trade page, hit Download Data, pick a date range + format (CSV / XLSX).
Analysis Lab reports export to Excel, PDF, or Word — ready to share or archive.
Files are generated client-side — no server round-trips, private by default.
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.
14. Troubleshooting
Fixes for the most common issues around AI reliability, rate limits, and malformed JSON responses.
"Rate limit reached. Try again in a moment."429
gemini-2.0-flash → gemini-1.5-flash → Lovable gateway → gemini-2.5-flash-lite with exponential backoff.- 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_KEYfunded — it's a completely separate quota used as backup.
"Expected ',' or '}' after property value in JSON…"parse
maxOutputTokens is 4096, and a repair pass handles trailing commas, curly quotes, missing separators, and raw newlines.- 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
Prices frozen or "N/A"feed
Balance shows ₹0 / $0 in headerinit
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.