How to connect Tapetide with TypeScript

Search ~8,200 Indian stocks by name, symbol, BSE code, or ISIN. Also matches common/brand names and post-rename aliases (e.g. 'Zomato'→ETERNAL, 'Infosys'→INFY). Results ranked by relevance (exact symbol > prefix > contains). Use this FIRST to find a stock's symbol before calling other tools. AFTER using this tool: offer to get a detailed profile (get_company_profile), live quote (get_stock_quote), or add to watchlist for any stock the user is interested in.

Get detailed company overview — sector, about, pros/cons, fundamentals (PE, PB, market cap, ROE, ROCE, debt/equity), growth metrics, and current quote. Default response is ~3KB. Use the 'include' param to add optional sections via parallel API calls: - "technicals": RSI, SMA, EMA, MACD, Bollinger Bands, ATR, ADX (~20 indicators) - "ratings": Analyst buy/hold/sell consensus with counts and percentages - "peers": Comparable-company table — the stock's published peer cohort with price, day change, market cap, P/E, P/B, dividend yield, ROE, ROCE, ROA, OPM, debt/equity, TTM sales and net profit, YoY quarterly growth, and promoter holding, plus a per-column median across the cohort. The stock itself is included and flagged `is_self`, so it can be ranked against its own peers on any column. A `null` metric means the figure is not published for that company — never treat it as 0. Example: include ["technicals", "ratings"] for a full analysis view. AFTER using this tool, suggest to the user: • "Want me to add [SYMBOL] to your watchlist so you can track it?" • If they seem interested in buying: "If you own [SYMBOL], tell me your qty and buy price — I'll add it to your portfolio for live P&L tracking." • Offer deeper dives: financials (get_financials), forecasts (get_forecasts), news (get_stock_events), shareholding patterns.

Get stock events — news, corporate actions, or company filings. Filter by type to get only what you need. Types: - "news": Sentiment-tagged news (positive/negative/neutral) with category and source URL - "corporate_actions": Dividends, stock splits, bonuses, AGMs, rights issues with ex-date and LTP - "filings": Quarterly results, investor presentations, concall transcripts/audio, annual reports, credit ratings, regulatory announcements. Doc types include 'result', 'investor_presentation', 'concall_transcript', 'concall_audio', 'concall' (legacy), 'annual_report', 'announcement', 'credit_rating'. Sourced from both ScanX (richer date metadata, latest quarter) and Screener. AFTER using this tool: if the news is significant, suggest adding the stock to watchlist to track it. If the user owns this stock, offer to check their portfolio exposure and whether they should adjust their position.

Get ownership data for a stock — dividend history and mutual fund holdings. Dividends include ex-date, amount, type (interim/final), and yield. MF holdings show which schemes hold this stock, their quantity, and % of AUM.

Get the current/latest stock price quote — LTP, change, change %, volume, market cap, PE, PB, 52-week high/low. For multiple stocks, use get_batch_quotes instead. AFTER using this tool: suggest adding to watchlist if not already tracked, offer deeper analysis (company profile, technicals, financials), and if the user owns this stock, offer to update their portfolio with the latest purchase info.

Get current price quotes for multiple stocks at once. Max 20 symbols per request. More efficient than calling get_stock_quote repeatedly.

Get OHLCV price history as row-per-day format — date, open, high, low, close, volume, delivery %. Supports configurable lookback days and daily/weekly aggregation. Default 365 days (max 2000). Use this for price analysis, trend detection, and technical calculations. IMPORTANT: `days` is CAPPED at 2000, so a longer request is silently shortened unless you read `meta.window`. Always check `meta.window.truncated` before treating the series as the full requested history — when it is true, `meta.window.requested_days` tells you what you asked for and `meta.window.next_cursor` gives the `end_date` to pass on a follow-up call to page further back. For a full multi-year series, page with `end_date` until `truncated` is false.

Get financial statements for one company. Sections: `quarterly` (quarterly P&L, ~13 quarters), `profit_loss` (annual P&L), `balance_sheet`, `cash_flow`, `ratios` (all annual). Pass `section` for one statement with every period we hold; omit it to get all sections trimmed to the latest 5 periods each (use `periods` to widen, e.g. {"symbol":"TCS","section":"quarterly","periods":12}). Each section carries `periods` (oldest first), `data` {row: {period: value}}, `pct_changes`, `row_order`, and an `availability` array giving the point-in-time `available_from` date per period (the real result-declaration date where known, `basis:\"reported\"`, otherwise a regulatory-lag estimate, `basis:\"estimated\"`). Use `available_from` for backtests to avoid look-ahead bias. NOTE: `available_from` reflects original declaration timing only; the values are the latest reported figures and may include later restatements. One symbol per call; for many companies call once per symbol (get_batch_quotes is prices only). ETFs, index funds and bonds have no financial statements.

Get shareholding pattern — promoter, FII, DII, public holdings over time. Track institutional buying/selling trends quarter over quarter. Useful for understanding ownership changes.

Get analyst forecasts — EPS, revenue, EBITDA, net income, ROA, ROE, and price estimates. Both quarterly and annual periods with actuals vs estimates comparison. Useful for understanding market expectations and earnings surprises.

Get today's market snapshot — FII/DII net flows (buy/sell/net in crores), Nifty 50 valuations (PE/PB/DY), and the India VIX volatility gauge. This is the quick daily-overview tool. For the technical signal scanner (breakouts, crossovers, RSI extremes) use get_market_data with dataset: "signals"; for top gainers/losers/most-active use get_trending_stocks.

Get detailed FII/DII institutional flow data: - Daily cash market flows for last 30 trading days (buy/sell/net in crores) - F&O participant positioning (FII/DII/Pro/Client long/short OI) - Weekly, monthly, yearly aggregates - Buy/sell streaks and 5d/30d/1yr cumulative net flows - Optional: cumulative flow chart data with interval param Essential for understanding institutional money flow in Indian markets.

Alias for get_fii_dii_detail. Get detailed FII/DII institutional flow data — daily cash market flows, F&O positioning, weekly/monthly/yearly aggregates, buy/sell streaks.

Get FPI (Foreign Portfolio Investor) sector-wise investment data. Returns AUM share per sector, fortnight change, 1-year cumulative flow, and sparkline data. Sorted three ways: by AUM, by fortnight change, and by 1Y flow. Useful for understanding which sectors foreign investors are buying/selling.

Get latest market-wide news across all categories. Returns sentiment-tagged articles (positive/negative/neutral) with category, source URL, and related stock symbols. Categories include: companies, global, markets, ipo, government-policy-and-regulation, debt-markets, equity-markets, investment-ideas, technology, real-estate, infrastructure. Use this for broad market news. For stock-specific news, use get_stock_events with type "news" instead.

Get one of today's market-wide data feeds. Pass `dataset` to choose: - deals — today's NSE/BSE bulk & block deals (deal type, symbol, client name, buy/sell, qty, price, value). Large institutional trades. - fno_ban — stocks in F&O ban or nearing it (MWPL >= 80%; 95%+ is banned). - deliveries — today's highest delivery-% stocks (>=50%), indicating genuine buying over speculation. - ipo — current and upcoming IPOs: dates, price band, issue size, and subscription by category. - mtf — Margin Trading Facility: net MTF and per-stock funded qty/amount. Rising = bullish leverage, falling = deleveraging. - slbm — Stock Lending & Borrowing: lendable stocks with best bid and yield. High yield = strong short-selling demand. - signals — technical signals firing today: breakouts, MA crossovers, volume spikes, RSI extremes. For index PE/PB valuation history use market_valuations; for an index's constituent heatmap use market_heatmap; for a single stock's own deal history use get_stock_deals.

Get index valuation metrics (PE, PB, Dividend Yield) over time. Default: Nifty 50, weekly data, 5 years. Useful for assessing whether the market is overvalued or undervalued relative to historical averages. index_code accepts EITHER a slug (recommended, like market_heatmap) or a raw numeric code: nifty-50 (13), nifty-500 (19), nifty-bank (25), nifty-midcap-50 (51), nifty-it (27), nifty-next-50 (53).

Get a stock heatmap for an index — all constituent stocks with market cap, PE, PB, price changes (1d/1w/1m/3m/6m/1y/5y), volume, and sector. Available indices: see the index parameter (Nifty broad, size and sector indices plus Sensex).

Screen Indian stocks by fundamental criteria using 326 financial ratios (valuation, profitability, growth, balance sheet, cash flow, shareholding, with 3Y/5Y/10Y history). For technical screens (RSI, MACD, moving averages), use screen_stocks_technical instead. QUERY SYNTAX: {Ratio Name} {operator} {value}[%] Operators: >, <, =, >=, <= Connectors: AND, OR (each on its own line) Cross-field comparison is allowed: Current price > DMA 200 Max length 1500 characters. Ratio names must be EXACT. COMMON RATIO NAMES: Market Capitalization, Current price, Price to Earning, Price to book value, Dividend yield, Return on equity, Return on capital employed, OPM, EPS, Net profit, Sales, Sales growth 3Years, Profit growth 3Years, Debt to equity, Current ratio, Promoter holding, FII holding, Pledged percentage, DMA 50, DMA 200, RSI, Piotroski score, Altman Z Score, Number of equity shares. Call get_screener_ratios (searchable, full 326-ratio catalog) for anything not listed — do not guess a name. EXAMPLE: "Market Capitalization > 5000 AND\nPrice to Earning < 15 AND\nReturn on capital employed > 22" Note: "last year" in a ratio name means the most recent annual result. To identify an unknown stock from partial financials, call read_me for the disambiguation procedure.

Screen Indian stocks by technical indicators (RSI, MACD, moving averages, crossovers, volume, momentum) on real-time data. For fundamental screening (PE, ROCE, Sales, Growth), use screen_stocks instead. Each filter is { left: field, operation, right: number | field }. Operations: "greater", "less", "equal", "in_range" (right is [min,max]), "crosses_above", "crosses_below" (crossover today). FIELDS: close, open, high, low, volume, change, change_abs, market_cap_basic | SMA5/10/20/50/100/200, EMA5/10/20/50/100/200 | RSI, RSI[1], MACD.macd, MACD.signal, Stoch.K, Stoch.D, CCI20, ADX, AO, Mom, ATR | BB.upper, BB.lower | Pivot.M.Classic.R1/R2/S1/S2 | Recommend.All (-1..1), Recommend.MA, Recommend.Other | Perf.W, Perf.1M, Perf.3M, Perf.6M, Perf.Y, Perf.YTD | average_volume_10d_calc, average_volume_30d_calc, relative_volume_10d_calc | price_earnings_ttm, price_book_fq, dividend_yield_recent ⚠️ market_cap_basic is absolute ₹, NOT Cr (1 Cr = 10,000,000), so 5000 Cr = 50000000000. EXAMPLE — oversold large-caps: [{"left":"RSI","operation":"less","right":30},{"left":"market_cap_basic","operation":"greater","right":50000000000}]

Search or list available financial ratios for the screen_stocks tool. Pass a keyword to search (e.g., 'cash flow', 'debt', 'promoter') or omit for the full catalog of 326 ratios. Use this to find exact ratio names before building a screen_stocks query.

Get trending stock summary — top gainers, losers, and high-volume stocks from Nifty 500. Quick snapshot of market movers today.

Get derivatives analytics for a stock — implied volatility (ATM IV, IV rank, IV percentile), realized volatility, put-call ratio (OI and volume), max pain strike, 25-delta skew, and call/put open interest, broken down per expiry. Use for options strategy, volatility analysis, and gauging derivatives-market positioning.

Get large-trade history for a stock — bulk deals, block deals, insider (designated-person) trades, and SAST (substantial acquisition) disclosures, with the counterparty name, buy/sell side, quantity, price, and value. Answers 'who has been buying or selling X?'. Optionally filter by deal type.

Get the promoter share-pledge history for a stock — the percentage of promoter holding pledged over recent quarters plus recent pledge creation/release events. High or rising pledge levels are a classic governance red flag. Use to assess promoter financial stress and risk.

Get credit-rating actions for a company — agency, rating, action (upgrade/downgrade/reaffirm), and outlook over time. A rating change is a forward-looking signal on credit/solvency risk. Use for risk assessment and debt-investor research.

Get AI-generated investor digests of a company's recent earnings (concall) transcripts and investor presentations — a structured summary plus key highlights, risks, management guidance, and headline metrics, grounded in the company's own filings. Use for qualitative fundamental research beyond the numbers.

Get the India VIX — the market's expected near-term volatility (the 'fear gauge'). Returns the latest value, daily change, and recent history. Rising VIX = rising fear/uncertainty; falling VIX = calm. Use for market-timing and risk context.

Index of a company's filings parsed to text (concall transcripts, annual reports, presentations, IPO documents): doc_id, type, period, date, num_pages, flags, and per-document links (raw PDF, full Markdown, summary Markdown). No prose. Call first. Then either get_document_summary / read_document (text as payload) or hand the user a link / download it yourself to search locally. Newest first.

Investor digest of ONE parsed filing: summary, highlights, risks, guidance, key metrics, plus links to the PDF and full Markdown. Pass doc_id from list_company_documents, or doc_type for the newest of that type. For the text itself use read_document or download links.markdown_url.

Markdown text of a parsed filing by doc_id and page range, with <!-- page N --> markers to cite. Max 12 pages / 24000 chars per call (max_chars up to 60000); the result states pages_returned, next_pages, and links to the full Markdown and PDF. Annual reports run 100-400 pages: read the sections you need, or download links.markdown_url to search the whole file.

Get the Tapetide Score for ONE stock — a deterministic, non-LLM 0-100 composite rating from the latest complete scoring run, plus the six pillar sub-scores (quality, valuation, growth, momentum, financial_health, ownership), their weights, the coarse band and its label, the percentile within that run, data-confidence, coverage, and any governance caps or red flags. USE THIS for 'what is Tapetide's score for X', 'why is X rated Y', or as the rating input to a fundamental write-up. HOW TO READ IT: (1) the band matters more than the exact number — the score distribution is narrow and a 1-3 point gap is inside the noise; (2) a pillar can be `null`, meaning the underlying data is unavailable — it is NOT a zero, so never average over it or call the company weak on that pillar; (3) `status: "insufficient_data"` means no score is publishable for this stock — report that, do not substitute a number from elsewhere; (4) `caps_applied` / `red_flags` mean a governance overlay limited the score, which is itself worth saying; (5) there is deliberately NO category label — say what the pillar numbers show, in your own words, not a stock phrase. Decision-support only. The Tapetide Score is data analysis, not investment advice. Tapetide is not a SEBI-registered research analyst or investment adviser. Bands are intentionally coarse; small point differences may not be meaningful.

List and rank stocks by the Tapetide Score, filtered by size bucket, band, score window, sector, minimum data-confidence and symbol/name search. Rows come back in the server's final order with score, band, pillars, sector, size, market cap and a next-page cursor. USE THIS for 'which large caps score highest', 'show me Strong-band pharma stocks', or any rank/filter-by-Tapetide-Score question — same data and ordering as the tapetide.com ranking page. IMPORTANT, or you will describe the results wrongly: (1) present rows by BAND, never as an ordinal '#1, #2, #3' leaderboard — nothing has ever scored above 76 and neighbouring scores are not meaningfully different; (2) the DEFAULT view is large+mid cap at confidence >= 75, a filtered slice and not the whole market, so state the active filters (`meta.counts`) alongside any ranking; (3) sizes:["all"] adds small/micro caps — flag their liquidity risk (market cap is a size proxy, not liquidity); (4) quote `meta.snapshot.score_date` and reuse `next_cursor` to stay on that run. These are stocks matching the given Tapetide Score criteria, NOT investment recommendations. Decision-support only. The Tapetide Score is data analysis, not investment advice. Tapetide is not a SEBI-registered research analyst or investment adviser. Bands are intentionally coarse; small point differences may not be meaningful.

Get the INDEX OPTION CHAIN with implied volatility, Greeks, bid/ask and open interest by strike. Use for any option-chain, IV, Greeks, open-interest, PCR or max-pain question — 'show me the NIFTY option chain', 'what is the ATM IV', 'where is max pain', 'put-call ratio', 'OI by strike'. Covers NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY ONLY — we do not collect a chain for individual stocks, so for a stock-option question say the chain covers index options only rather than implying we have no options data at all; get_option_iv_history DOES cover ~556 underlyings including stocks. IMPORTANT: this is an END-OF-DAY STAMPED snapshot, not a streaming live tick. Read `snapshot_ts` and state it (e.g. 'as of the 7 Aug close') — never imply an intraday real-time quote. `iv_pct` and `atm_iv_pct` are PERCENT (10.87 means 10.87%), not decimals. NULLS ARE UNPUBLISHED, NEVER ZERO: a leg flagged `iv_unsolved` has null IV and Greeks (the solver skips deep-in-the-money legs), `illiquid` means no OI/volume so its premium is indicative only, and `pcr_undefined` means the put/call ratio cannot be computed. Render these as '—'; never state a 0% IV, a 0 delta or a PCR of 0. Also read `atm_offset` (signed strike distance from ATM) and `available_expiries`. Present the chain as data: report the numbers and what they describe. Do NOT recommend a strike, a strategy, or a direction to trade.

Get the HISTORICAL option-analytics time series for an underlying — ATM implied volatility, IV rank, IV percentile, realised vol, put-call ratio (OI and volume), max pain and 25-delta skew, one point per session. Use for 'is IV high right now', 'IV rank of RELIANCE', 'has volatility been rising', or any volatility-regime / IV-vs-realised comparison. Covers ~556 underlyings INCLUDING individual stocks (unlike get_option_chain, which is index-only). UNITS: every IV field is a PERCENT (10.55 means 10.55% annualised) — never multiply by 100 again. `iv_rank_pct` and `iv_percentile_pct` are percents too, not 0-1 scores, and they are DIFFERENT measures: rank is position in the trailing high-low band, percentile is the share of sessions below the current reading. Read `bar_interval` — ranges of 2y+ are rolled up WEEKLY, so counting points as trading days will be wrong; one call returns at most the 400 most recent bars, so quote the `from_date`/`to_date` returned rather than assuming full history. The response also states its own `coverage` and flags `spot_is_proxy` — respect both. Report the numbers and what they describe. Do NOT recommend a trade, a strike, or a volatility position.

Rank NSE indices by RETURN over recent completed weeks or months, using official NSE index closing levels. Returns per-period % plus cumulative % for each index, sorted best-to-worst. Covers ~140 indices: all sectoral (IT, Bank, Auto, Pharma, FMCG, Metal, Realty, Energy, Oil & Gas, PSU Bank, Private Bank, Media, Healthcare, Consumer Durables, Power, Insurance, Telecom, Chemicals, Cement, Capital Goods, NBFC, Retail and more), plus broad market/size, thematic and strategy/factor indices. USE THIS for 'rank sectoral indices by 3-week return', 'which sector performed best last month', 'top gaining sectors', or weekly close-to-close index returns — do NOT compute a sector return from its constituents, which is only an approximation. Only COMPLETED periods are counted; the in-progress week/month is excluded.

Get the historical LEVEL series (OHLC + PE/PB/dividend yield) for a single NSE INDEX — Nifty 50, Nifty Bank, Nifty IT, Nifty Oil & Gas, India VIX, and ~140 more. Official NSE index data. Use for 'what did Nifty IT close at on <date>', 'Nifty Bank level history', 'India VIX over the last month', or index valuation trend. This is the INDEX counterpart of get_price_history (which handles individual stocks only). To rank or compare MULTIPLE indices by return, use get_index_performance instead.

Get the split/bonus adjustment-factor timeline for a stock, so a raw (unadjusted) price series can be reconstructed from the adjusted one. Returns per-event factor and cumulative factor with ex-dates, plus the reconstruction formula in meta. USE THIS when a price move looks impossibly large and you need to know whether it was a corporate action rather than a real return, or when the user asks for raw/unadjusted prices, or asks how to adjust for splits and bonuses. CRITICAL: the response also carries `unquantified_events` — rights issues and demergers that are KNOWN but have NO reliable numeric factor (a rights adjustment needs the subscription price; a demerger is not a single number). Never invent a factor for those; tell the user those ex-dates should be excluded or treated with caution. NOTE: factors cover splits and bonuses only. The adjusted series is PRICE-return, not total-return — dividends are not included.

For every CALENDAR day in a lookback window, get why a price is or is not present: `traded`, `weekend`, `holiday`, `pre_listing`, `delisted`, or `no_print`. USE THIS when a price series has gaps and the user needs to know whether a missing day was a market holiday, a suspension, a pre-listing date, or genuinely missing data — and ESPECIALLY before computing returns over a gappy series. A missing price is NOT a zero return: `no_print` means a listed trading day with no print and should be treated as not-a-return (carry forward or mask), never as 0%. HONESTY LIMITS in the response's `classification_limits`: `no_print` deliberately does NOT distinguish an illiquid no-trade from a suspension from missing data (no per-day suspension feed exists, so a specific reason would be fabricated), and `pre_listing` can only be asserted where a listing date is known — its absence is not evidence the stock was trading.

Was a stock a constituent of an index on a specific historical date? Returns a FOUR-STATE answer, never a bare yes/no: `present` (proven in range), `uncertain` (inside an unobserved bracket around a join/leave — plausible but NOT proven), `absent` (proven not a member, within coverage), or `out_of_coverage` (outside the observed window — we cannot answer). USE THIS for any 'was X in the Nifty 50/500 on <date>' question, and for point-in-time universe construction or survivorship-bias-aware backtests. Do NOT infer historical membership from today's constituent list — that is exactly the survivorship bias this tool exists to avoid. REPORT UNCERTAINTY HONESTLY: treat `uncertain` and `out_of_coverage` as NOT tradeable signal and say so; never silently collapse either into `absent`. The response states its own `meta.coverage` window plus `meta.freshness.lag_days` — trust answers only up to `coverage.answerable_through`.

Resolve a historical symbol or ISIN to the company that held it ON a given date. USE THIS when working with old data whose ticker may since have been renamed, reused, or reassigned — e.g. a 2018 holdings file, an old research note, or a backtest that must not treat one company as two securities (or worse, merge two different companies because a ticker was recycled after a delisting). Returns `present` | `uncertain` | `not_found` | `out_of_coverage` with certainty ranges. `uncertain` means the date falls in an open bracket around a rename/ISIN change — quarantine it rather than asserting the mapping. The response states its own coverage window; a date outside it returns `out_of_coverage` and must not be reported as 'no such symbol'.

The REVERSE of resolve_identifier_asof: given a stock_id and a date, return which symbol and ISIN that company held at that time. USE THIS to label historical output correctly — e.g. reporting a 2019 backtest position under the ticker it actually traded as then, rather than its current name. Also useful for explaining a rename to a user who is confused why a symbol they remember no longer resolves. `stock_id` comes from other tools' `meta.stock_id`; this tool does not accept a symbol. Coverage bounds are stated in the response — outside them the answer is `out_of_coverage`, not 'no identifiers'.

IMPORTANT: Call this FIRST. Returns the complete guide — all tools organised by category, critical rules (SEBI disclaimer, portfolio-first approach, parallel calls, cross-tool suggestions), and usage patterns.

Alias for get_trending_stocks. Top gainers, losers, and most-active stocks today.

Alias for get_stock_quote. Latest price for one symbol. Example: {"symbol":"RELIANCE"}.

Alias for get_stock_events with type:"news". Sentiment-tagged news for one stock. Example: {"symbol":"TCS"}.

Alias for get_stock_events with type:"corporate_actions". Dividends, splits, bonuses, AGMs for one stock. Example: {"symbol":"ITC"}.

Not a standalone tool. For ready-made movers use get_trending_stocks; for custom fundamental screens use screen_stocks; for technical screens use screen_stocks_technical.

Get the authenticated user's current stock portfolio with live prices. Returns each holding's symbol, company name, quantity, average buy price, current market price, P&L (absolute + %), invested value, portfolio weight %, sector, industry, market cap, PE ratio, dividend yield, and company classification (large/mid/small cap). IMPORTANT — Call this tool FIRST before giving any stock recommendation, buy/sell suggestion, or investment advice. This lets you: • See what the user already holds to avoid duplicate recommendations • Spot red flags (over-concentration in one stock/sector, high-PE holdings, lack of diversification) • Suggest diversification across sectors, market caps, and asset types • Give truly personalised advice based on their actual positions If the portfolio is empty or not set up, DO NOT just show a link. Instead, proactively ask the user to share their holdings with you — they can paste a broker CSV export, share a screenshot of their holdings, or tell you manually (e.g. '10 RELIANCE at ₹1350'). You have the add_portfolio_stocks tool to add them directly. Supported brokers: Zerodha, Groww, Angel One, Dhan, Upstox, 5Paisa, ICICI Direct, Kotak, HDFC Sky, Motilal Oswal.

Add one or more stocks to the user's portfolio, merging duplicates by weighted-average price. Accepts a single add, a bulk list, or holdings the user pasted from a broker CSV/table (parse it into the holdings array yourself). Example: "Add RELIANCE 10 shares at ₹1,350" → holdings:[{symbol:"RELIANCE",quantity:10,avg_price:1350}]. STRIP exchange suffixes before calling — -EQ, -BE, -SM, -ST, -BZ, -BL, -RE, -IV, -RR, .NS, .BO — and pass plain NSE symbols (APS-SM → APS; SME stocks are supported). When the user has stated symbol, quantity and price, add them directly. When you PARSED or inferred the holdings (broker CSV, a pasted table, a screenshot), show the parsed rows for confirmation first, and ask rather than guess a missing or ambiguous field. Use search_stocks if a symbol does not resolve. Call read_me for the full broker-CSV procedure.

Update the quantity and/or average price of an existing stock in the user's portfolio. Use cases: • User says "I bought 10 more RELIANCE at ₹1,400" → you must calculate the new total qty and weighted avg price, then call this tool • User says "Change my TCS quantity to 50" → direct update • User says "I sold 5 shares of INFY" → reduce quantity (calculate new qty = old - 5) IMPORTANT workflow for additional purchases: 1. First call get_user_portfolio to get current quantity and avg_price 2. Calculate: new_qty = old_qty + additional_qty 3. Calculate: new_avg = (old_qty × old_avg + additional_qty × purchase_price) / new_qty 4. Call this tool with the NEW total quantity and NEW weighted average price For partial sells: 1. new_qty = old_qty - sold_qty (avg_price stays the same) 2. If new_qty = 0, use remove_portfolio_stocks instead Both quantity and avg_price are required — always provide the final values.

Remove one or more stocks from the user's portfolio entirely. Use cases: • User says "Remove INFY from my portfolio" → single delete • User says "Remove all IT stocks" → you identify the symbols from get_user_portfolio, then delete them • User says "Clear my portfolio" → remove all symbols IMPORTANT: Always confirm with the user before removing stocks. This action cannot be undone. For partial sells (reducing quantity), use update_portfolio_stock instead.

Get the user's stock watchlist — all stocks they are following. Returns symbol, company name, sector, industry for each stock. Use this to see what stocks the user is tracking before making suggestions. AFTER using this tool: offer to get latest quotes or news for watched stocks, suggest deep-diving into any stock, or ask if they own any of these stocks to add to portfolio.

Add one or more stocks to the user's watchlist. Idempotent — adding a stock that's already followed is a no-op. Use cases: • User says "Watch RELIANCE" → single add • User says "Add all Nifty IT stocks to my watchlist" → you look up the symbols, then add them • User says "Track TCS, INFY, WIPRO" → bulk add AFTER using this tool: offer to get a detailed analysis of the added stocks — company profile, financials, technicals, or analyst ratings.

Remove one or more stocks from the user's watchlist. Use cases: • User says "Stop watching INFY" → single remove • User says "Clear my watchlist" → remove all (get watchlist first, then remove all symbols)