Kite MCP Server

# Tradebook Quick Reference Card ## 🚀 What's New? The tradebook page now has **intelligent sorting** and **improved visual layout** to help you make better investment decisions faster! --- ## 🎯 Quick Start ### Default View When you open the tradebook page, you'll see: - **Stocks sorted by Current Value** (biggest holdings first) - **Larger fonts** for important metrics - **Color-coded** profit/loss indicators ### Change the Sort Use the **"Sort By"** dropdown in the filters section: ``` ┌─────────────────────────────────┐ │ Sort By: ▼ │ │ ✓ Current Value ← Default │ │ Total P&L │ │ XIRR % │ │ Opportunity Cost │ │ Symbol (A-Z) │ └─────────────────────────────────┘ ``` --- ## 📊 Sort Options Explained ### 1. Current Value (Default) 💰 **What it shows**: Your biggest holdings first **For Active Holdings**: - Sorts by market value (Quantity × Current Price) - See which stocks dominate your portfolio **For Sold Holdings**: - Shows what position would be worth if you still held it - Reveals biggest missed opportunities **When to use**: - Daily portfolio review - Portfolio rebalancing - Understanding concentration risk **Example**: ``` 1. RELIANCE ₹2,45,000 (largest holding) 2. TCS ₹1,80,000 3. HDFC ₹1,20,000 4. INFY ₹95,000 (smallest holding) ``` --- ### 2. Total P&L 📈 **What it shows**: Your best and worst performers **Calculation**: Realized P&L + Unrealized P&L **When to use**: - Year-end review - Finding winners for tax planning - Identifying losers for tax loss harvesting - Performance analysis **Example** (Highest to Lowest): ``` 1. RELIANCE +₹45,000 (best performer) 2. TCS +₹12,000 3. INFY -₹5,000 4. HDFC -₹18,000 (worst performer) ``` **Tip**: Flip to "Lowest to Highest" to find tax loss harvesting candidates! --- ### 3. XIRR % 🎯 **What it shows**: Time-adjusted returns (annualized %) **Why it matters**: - Compares holdings fairly regardless of when you bought them - 20% return in 1 year ≠ 20% return in 5 years - Industry standard for performance comparison **When to use**: - Comparing different holdings objectively - Evaluating investment decisions - Reporting to stakeholders **Example** (Highest to Lowest): ``` 1. RELIANCE 45.5% (best annualized return) 2. TCS 22.3% 3. INFY 15.8% 4. HDFC 8.2% (weakest performer) ``` **Tip**: A high XIRR on a small holding may matter less than a moderate XIRR on a large holding! --- ### 4. Opportunity Cost ⚠️ **What it shows**: Impact of selling decisions (Sold positions only) **Calculation**: What you got - What it would be worth now **Understanding the Numbers**: - **Negative** (Red/Orange): Sold too early, missed gains - **Positive** (Green): Good timing, avoided losses **When to use**: - Learning from past decisions - Improving exit strategy - Avoiding emotional selling **Example** (Most Negative First): ``` 1. TCS -₹50,000 (-35%) "Sold too early! Missed ₹50K" 2. RELIANCE -₹20,000 (-15%) "Could have held longer" 3. INFY +₹10,000 (+12%) "Good timing! Avoided losses" 4. HDFC +₹25,000 (+18%) "Excellent exit!" ``` **Tip**: Negative opportunity cost isn't necessarily bad—you may have needed the money or reduced risk! --- ### 5. Symbol (A-Z) 🔤 **What it shows**: Alphabetical order **When to use**: - Finding a specific stock quickly - Traditional view - Exporting to spreadsheet **Example**: ``` 1. BHARTIARTL 2. HDFC 3. INFY 4. RELIANCE 5. TCS ``` --- ## 🎨 What the Colors Mean ### Purple (Most Important) ``` ₹2,45,000 ← Current Value ``` **Your portfolio's worth**—the biggest, most prominent number --- ### Green (Good News) ``` +₹45,000 ⬆ ← Profit 18.5% ⬆ ← Positive return ``` **You're making money!** --- ### Red (Attention Needed) ``` -₹5,000 ⬇ ← Loss -12.3% ⬇ ← Negative return ``` **Position is underwater** --- ### Orange (Learning Opportunity) ``` -₹20,000 ⚠ ← Opportunity Cost ``` **Sold too early**, but don't beat yourself up! --- ### Blue (Neutral Info) ``` 150 ← Net Quantity (Active) ``` **How many shares you hold** --- ### Gray (Historical) ``` [SOLD] ← Closed position ``` **No longer in portfolio** --- ## 📏 Size = Importance ### Biggest (You'll See First) - **Current Value**: What your position is worth - **Total P&L**: Your profit or loss ### Medium (Secondary Info) - **Live Price**: Current market price - **Quantity**: How many shares - **XIRR**: Annualized return % ### Smallest (Details) - Labels - Breakdowns (R: ₹X | U: ₹Y) - Dates and trade counts --- ## 💡 Pro Tips ### Tip 1: Daily Routine ``` Sort By: Current Value (desc) Status: Active Holdings ``` **See your biggest holdings and their current value instantly** --- ### Tip 2: Year-End Tax Planning ``` Sort By: Total P&L (asc) ← Lowest first Status: Active Holdings ``` **Find losers for tax loss harvesting** Then: ``` Sort By: Total P&L (desc) ← Highest first Status: Active Holdings ``` **Find winners to book gains** --- ### Tip 3: Learning from Mistakes ``` Sort By: Opportunity Cost (asc) ← Most negative first Status: Sold Holdings ``` **See which stocks you sold too early** Ask yourself: "Why did I sell? What can I learn?" --- ### Tip 4: Performance Review ``` Sort By: XIRR % (desc) Status: Active Holdings Date Range: Last Year ``` **Find your star performers from last year's buys** --- ### Tip 5: Portfolio Rebalancing ``` Sort By: Current Value (desc) Status: Active Holdings ``` **Identify overweight positions** Then compare to your target allocation. --- ## 🔍 Reading the Cards ### Active Holding Example ``` ┌──────────────────────────────────────────────────┐ │ [▼] RELIANCE [ACTIVE] Primary Account │ │ │ │ Live Price Net Qty Current Value │ │ ₹2,450 100 ₹2,45,000 │ │ 🔴 Live Invested: ₹2,00,000 │ │ │ │ Total P&L XIRR │ │ +₹45,000 ⬆ 18.5% │ │ R: ₹0 | U: ₹45,000 │ │ │ │ 📅 01-Jan-2024 → 15-Dec-2024 │ │ 📊 15 trades │ └──────────────────────────────────────────────────┘ ``` **Quick Read**: - Stock: RELIANCE (actively holding) - Current worth: ₹2,45,000 (invested ₹2L) - Profit: ₹45,000 (all unrealized) - Return: 18.5% annualized - Status: Up ⬆ (green arrows) --- ### Sold Position Example ``` ┌──────────────────────────────────────────────────┐ │ [▼] TCS [SOLD] Secondary Account │ │ │ │ Live Price Sold Qty Value If Held │ │ ₹3,800 50 ₹1,90,000 │ │ 🔴 Live Sold At: ₹1,50,000 │ │ │ │ Total P&L XIRR Opportunity │ │ +₹50,000 ⬆ 22.5% -₹40,000 ⚠ │ │ R: ₹50K | U: ₹0 (-21.1%) │ │ │ │ 📅 10-Mar-2023 → 20-Aug-2024 │ │ 📊 8 trades │ └──────────────────────────────────────────────────┘ ``` **Quick Read**: - Stock: TCS (fully sold) - Sold for: ₹1,50,000 (made ₹50K profit ✓) - But now worth: ₹1,90,000 (missed ₹40K more ⚠) - Return: 22.5% annualized (still good!) - Status: Mixed (profit realized, but could've been more) **Lesson**: You made money, but could've made more. Was it the right call? Depends on why you sold! --- ## ❓ FAQ ### Q: Why is a stock with lower P&L ranked higher? **A**: You're sorting by "Current Value", not "Total P&L". A ₹2L holding with 5% gain (₹10K) is shown before a ₹50K holding with 20% gain (₹10K) because the first is larger. **Solution**: Change Sort By to "Total P&L" or "XIRR %" for performance-based ranking. --- ### Q: What does "Value If Held" mean? **A**: For sold positions, it shows what those shares would be worth if you still owned them at today's price. **Example**: Sold 100 TCS @ ₹3,000 = ₹3,00,000. Now TCS is ₹4,000. Value If Held = ₹4,00,000. You "missed" ₹1,00,000 of additional gain. --- ### Q: Why is XIRR different from absolute return %? **A**: XIRR accounts for **time**. A 50% return in 1 year is much better than 50% return in 5 years. XIRR annualizes returns so you can compare apples to apples. --- ### Q: What's the difference between Realized and Unrealized P&L? **A**: - **Realized (R)**: Profit/loss from shares you've sold (closed positions) - **Unrealized (U)**: Paper profit/loss from shares you still hold (open positions) - **Total**: R + U = Complete picture --- ### Q: Why does sorting change the order but not the data? **A**: Sorting is just a **view**—like sorting files by name vs date. The underlying data (trades, quantities, prices) never changes. --- ### Q: Can I save my preferred sort? **A**: Not yet! It resets when you reload. This feature is planned for a future update. Meanwhile, it only takes 2 clicks to set your sort. --- ## 🎯 Common Workflows ### Morning Portfolio Check (2 minutes) 1. Open Tradebook 2. Default view shows biggest holdings 3. Check Total P&L colors (green = up, red = down) 4. Expand any concerning positions 5. Done! --- ### Monthly Review (10 minutes) 1. Sort by "XIRR %" (desc) → See best performers 2. Note top 3 stocks 3. Sort by "XIRR %" (asc) → See worst performers 4. Analyze: Why are they underperforming? 5. Sort by "Current Value" → Check concentration 6. Decide: Rebalance if needed --- ### Tax Planning (30 minutes) 1. Set date range to current financial year 2. Sort by "Total P&L" (asc) → Find losers 3. List candidates for loss harvesting 4. Sort by "Total P&L" (desc) → Find winners 5. Calculate tax impact 6. Make sell decisions strategically --- ### Post-Sale Analysis (5 minutes) 1. Status: Sold Holdings 2. Sort by "Opportunity Cost" (asc) 3. Find stocks you sold 4. Review: Did you sell too early? 5. Learn: What signals led to sale? 6. Improve: Refine exit strategy --- ## 📱 Mobile Tips - **Horizontal scroll** available for all columns - **Pinch to zoom** if text too small - **Tap to expand** individual stock details - Responsive mobile layout coming soon! --- ## 🆘 Need Help? ### Common Issues - **Values not updating**: Refresh page (prices cache for 2 min) - **Sorting not working**: Clear browser cache - **Layout broken**: Try different browser or report issue ### Report Bug Include: - What you were trying to do - What happened vs expected - Screenshot (if visual issue) - Browser and device info --- ## 🎉 Happy Trading! **Remember**: - Bigger numbers aren't always better—context matters! - XIRR is your friend for fair comparison - Learn from opportunity costs, but don't dwell on them - Sorting is a tool—use what helps YOUR decision-making --- **Last Updated**: January 1, 2026 **Version**: 2.0 **Questions?** Check the full documentation in TRADEBOOK_UI_IMPROVEMENTS.md