Get real-time NSE (National Stock Exchange) quote for an Indian stock.

Returns current price, change, volume, market cap, P/E ratio, 52-week range, sector, and more.

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK, SBIN, ITC)

Examples: nse_quote("RELIANCE") → Reliance Industries live price & stats nse_quote("TCS") → TCS live price & stats nse_quote("HDFCBANK") → HDFC Bank live price & stats

Get real-time BSE (Bombay Stock Exchange) quote for an Indian stock.

Returns current price, change, volume, market cap, and key ratios.

Args: symbol: BSE stock symbol (e.g., RELIANCE, TCS, INFY)

Examples: bse_quote("RELIANCE") → Reliance Industries BSE price bse_quote("TCS") → TCS BSE price

Check if the Indian stock market (NSE/BSE) is currently open or closed.

Returns market status (OPEN, CLOSED, PRE_OPEN, POST_CLOSE), trading hours, and current IST time.

No arguments needed.

Examples: nse_market_status() → Shows if market is open right now

Get current value of Indian market indices.

Returns the current value, change, change %, day's high/low, and 52-week range for the specified index.

Args: index_name: Index name. Options: - NIFTY50 (or NIFTY) - Nifty 50 index - SENSEX - BSE Sensex - BANKNIFTY - Nifty Bank index - NIFTYIT - Nifty IT index - NIFTYPHARMA - Nifty Pharma index - ALL - Get all major indices at once

Examples: nifty_index("NIFTY50") → Current Nifty 50 value nifty_index("SENSEX") → Current Sensex value nifty_index("ALL") → All major indices

Get historical price data (OHLCV) for an NSE stock.

Returns open, high, low, close, volume data for the specified period. Also includes summary stats: period return %, high, low, avg volume.

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY) period: Time period. Options: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max interval: Data interval. Options: 1m, 5m, 15m, 30m, 1h, 1d, 5d, 1wk, 1mo Note: 1m data only available for last 7 days

Examples: nse_historical("RELIANCE", "1mo", "1d") → 1 month daily data nse_historical("TCS", "1y", "1wk") → 1 year weekly data nse_historical("INFY", "5y", "1mo") → 5 year monthly data nse_historical("SBIN", "5d", "15m") → 5 day intraday (15min candles)

Get today's top performing stocks on NSE.

Returns the top 10 stocks by the specified criteria from Nifty 50 components.

Args: mover_type: Type of movers to fetch. Options: - gainers: Top 10 stocks with highest % gain today - losers: Top 10 stocks with highest % loss today - active: Top 10 stocks by trading volume

Examples: nse_top_movers("gainers") → Today's top gainers nse_top_movers("losers") → Today's top losers nse_top_movers("active") → Most actively traded stocks

Get the latest NAV and details for any Indian mutual fund.

Searches the AMFI database — no API key required.

Args: query: Fund name (e.g. "SBI Bluechip", "HDFC Flexi Cap") or numeric scheme code (e.g. "119598")

Examples: mutual_fund_nav("SBI Bluechip") → NAV, change, 7-day history mutual_fund_nav("Axis Long Term") → ELSS fund NAV mutual_fund_nav("119598") → Fetch by scheme code directly

Scan NSE stocks currently hitting upper or lower circuit limits.

Checks Nifty 500 stocks where the current price is frozen at the intraday high (upper circuit) or intraday low (lower circuit).

Args: circuit_type: "upper" (locked at high), "lower" (locked at low), or "both" (default)

Examples: nse_circuit_breakers("upper") → Stocks hitting upper circuit today nse_circuit_breakers("lower") → Stocks hitting lower circuit today nse_circuit_breakers("both") → All circuit-locked stocks

Get the list of stocks in Nifty 50 or Sensex with live prices.

Returns all constituent stocks with current price, % change today, market cap, plus top 5 gainers and losers within the index.

Args: index_name: "nifty50" (default) or "sensex"

Examples: sensex_components("nifty50") → All 50 Nifty stocks with live prices sensex_components("sensex") → All 30 Sensex stocks with live prices

Scan Nifty 50 stocks near their 52-week high or low.

This is the most popular scan on Screener.in — stocks breaking out near 52-week highs are momentum candidates; those near 52-week lows may be value opportunities or falling knives.

Args: scan_type: "near_high" — stocks within threshold% of 52w high (default) "near_low" — stocks within threshold% of 52w low "both" — return both lists threshold_pct: Closeness threshold in % (default 5.0 = within 5% of extreme)

Examples: nse_52week_scanner("near_high", 5) → Stocks near all-time high area nse_52week_scanner("near_low", 10) → Stocks near 52-week low nse_52week_scanner("both", 3) → Very tight near both extremes

Get real-time stock quote for any global stock.

Works for US, UK, European, Asian, and Indian stocks. Returns price, change, volume, market cap, P/E, sector, country, and more.

Args: symbol: Stock ticker symbol. Formats: - US stocks: AAPL, MSFT, GOOGL, TSLA, AMZN - UK stocks: HSBA.L, BP.L, VOD.L - Japan: 7203.T (Toyota), 6758.T (Sony) - Hong Kong: 0700.HK (Tencent) - India: RELIANCE.NS, TCS.NS (use nse_quote for Indian stocks)

Examples: stock_quote("AAPL") → Apple live price stock_quote("MSFT") → Microsoft live price stock_quote("TSLA") → Tesla live price

Get historical price data for any global stock.

Returns OHLCV data with summary stats.

Args: symbol: Stock ticker (e.g., AAPL, MSFT, TSLA) period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max interval: 1m, 5m, 15m, 30m, 1h, 1d, 5d, 1wk, 1mo

Examples: stock_historical("AAPL", "1y", "1d") → Apple 1 year daily stock_historical("TSLA", "3mo", "1wk") → Tesla 3 month weekly

Get live cryptocurrency price in USD.

Returns current price, 24h change, market cap, volume, and all-time high.

Args: symbol: Crypto ticker (e.g., BTC, ETH, SOL, XRP, DOGE, ADA, MATIC, DOT)

Examples: crypto_price("BTC") → Bitcoin live price crypto_price("ETH") → Ethereum live price crypto_price("SOL") → Solana live price

Get historical cryptocurrency price data.

Args: symbol: Crypto ticker (e.g., BTC, ETH, SOL) period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, max interval: 1m, 5m, 15m, 30m, 1h, 1d, 1wk, 1mo

Examples: crypto_historical("BTC", "1y", "1d") → Bitcoin 1 year daily crypto_historical("ETH", "3mo", "1wk") → Ethereum 3 month weekly

Get live forex exchange rate between two currencies.

Returns current rate, day's change, high/low, and 52-week range.

Args: from_currency: Source currency code (e.g., USD, EUR, GBP, AED, JPY) to_currency: Target currency code (default: INR)

Examples: forex_rate("USD", "INR") → US Dollar to Indian Rupee forex_rate("EUR", "INR") → Euro to Indian Rupee forex_rate("AED", "INR") → UAE Dirham to Indian Rupee forex_rate("USD", "EUR") → US Dollar to Euro forex_rate("GBP", "USD") → British Pound to US Dollar

Get latest market news for a stock or general market.

Returns up to 10 recent news articles with title, publisher, and link.

Args: symbol: Stock ticker for company-specific news (optional). Leave empty for general market news.

Examples: market_news("AAPL") → Apple-related news market_news("RELIANCE.NS") → Reliance Industries news market_news() → General market news

Get SEC filings for a US-listed company.

Returns links to actual filing documents on SEC EDGAR.

Args: symbol: US stock ticker (e.g., AAPL, MSFT, GOOGL) filing_type: Type of filing. Options: - 10-K: Annual report - 10-Q: Quarterly report - 8-K: Current events report - ALL: All filing types count: Number of filings to return (default: 5, max: 20)

Examples: sec_filing("AAPL", "10-K") → Apple annual reports sec_filing("TSLA", "10-Q", 3) → Tesla last 3 quarterly reports sec_filing("MSFT", "ALL", 10) → Microsoft all recent filings

Search SEC EDGAR for a company and get their filing page.

Returns company info (CIK number) and link to their SEC filings page. Use sec_filing() to get specific filing documents.

Args: symbol: US stock ticker (e.g., AAPL, MSFT, GOOGL)

Examples: sec_filing_search("AAPL") → Find Apple on SEC EDGAR sec_filing_search("NVDA") → Find NVIDIA on SEC EDGAR

Get income statement (Profit & Loss) for a company.

Returns revenue, COGS, gross profit, operating income, net income, EPS, EBITDA, and other P&L line items.

Works for both Indian (NSE/BSE) and US stocks.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT) quarterly: If True, returns quarterly data. If False (default), annual data.

Examples: income_statement("RELIANCE") → Reliance annual P&L (last 4 years) income_statement("TCS", quarterly=True) → TCS quarterly P&L income_statement("AAPL") → Apple annual P&L

Get balance sheet for a company.

Returns total assets, total liabilities, shareholder equity, cash, debt, inventory, receivables, and more.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT) quarterly: If True, quarterly data. If False (default), annual.

Examples: balance_sheet("HDFCBANK") → HDFC Bank annual balance sheet balance_sheet("AAPL", quarterly=True) → Apple quarterly balance sheet

Get cash flow statement for a company.

Returns operating cash flow, investing cash flow, financing cash flow, free cash flow, capital expenditure, and more.

Args: symbol: Stock ticker (e.g., INFY, SBIN, GOOGL, AMZN) quarterly: If True, quarterly data. If False (default), annual.

Examples: cash_flow("INFY") → Infosys annual cash flow cash_flow("GOOGL", quarterly=True) → Google quarterly cash flow

Get key financial ratios and valuation metrics for a company.

Returns comprehensive metrics organized into categories:

• Valuation: P/E, P/B, EV/EBITDA, PEG ratio, price-to-sales

• Profitability: ROE, ROA, profit margin, operating margin, gross margin

• Growth: Revenue growth, earnings growth

• Financial Health: Debt/equity, current ratio, quick ratio, free cash flow

• Per Share: EPS, book value, revenue per share

• Dividend: Yield, payout ratio, ex-dividend date

Works for both Indian and US stocks.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT)

Examples: key_ratios("RELIANCE") → Reliance complete ratio analysis key_ratios("AAPL") → Apple valuation & financial metrics key_ratios("HDFCBANK") → HDFC Bank financial health check

Get company overview and profile information.

Returns company name, sector, industry, country, number of employees, website, business description, exchange, and market cap.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT)

Examples: company_profile("RELIANCE") → What does Reliance Industries do? company_profile("TSLA") → Tesla company overview company_profile("INFY") → Infosys company details

Get historical dividend payments for a stock.

Returns past dividend dates and amounts, total dividends paid, average dividend, and latest dividend info.

Args: symbol: Stock ticker (e.g., ITC, COALINDIA, AAPL, MSFT)

Examples: dividend_history("ITC") → ITC dividend payment history dividend_history("COALINDIA") → Coal India dividends dividend_history("AAPL") → Apple dividend history

Compute technical indicators for a stock with buy/sell signals.

Calculates RSI, MACD, SMA (20/50/200), EMA, Bollinger Bands, ATR, Stochastic, ADX, OBV — all computed locally, no API cost.

Works for Indian (NSE/BSE) and US stocks.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, TSLA) period: Data period for calculation: 3mo, 6mo, 1y, 2y (default: 6mo) indicators: Comma-separated list of specific indicators. Options: RSI, MACD, SMA, EMA, BBANDS, ATR, STOCH, ADX, OBV Leave empty for ALL indicators.

Examples: technical_indicators("RELIANCE") → All indicators for Reliance technical_indicators("AAPL", "1y") → Apple with 1 year data technical_indicators("TCS", "6mo", "RSI,MACD,SMA") → Only RSI, MACD, SMA

Compare 2-5 stocks side by side.

Shows price, P/E, P/B, ROE, profit margin, revenue growth, debt/equity, dividend yield, beta, sector, and 52-week range for each stock in a comparison table format.

Args: symbols: Comma-separated stock symbols (2-5 stocks). e.g., "RELIANCE,TCS,INFY" or "AAPL,MSFT,GOOGL"

Examples: compare_stocks_tool("RELIANCE,TCS,INFY") → Compare 3 Indian IT giants compare_stocks_tool("AAPL,MSFT,GOOGL,AMZN") → Compare US tech compare_stocks_tool("HDFCBANK,ICICIBANK,SBIN,KOTAKBANK") → Compare banks

Get performance of Nifty sectoral indices.

Shows how different sectors (Banking, IT, Pharma, FMCG, Auto, Metal, Realty, Energy) performed today, with best and worst performers highlighted.

No arguments needed.

Examples: sector_performance() → Which sectors are up/down today?

Get FII (Foreign Institutional Investor) and DII (Domestic Institutional Investor) activity data.

Shows how much foreign and domestic institutions bought/sold today. FII net buy = bullish signal. DII net buy = domestic accumulation.

No arguments needed.

Examples: nse_fii_dii_data() → Today's FII/DII activity

Get recent bulk and block deals on NSE.

Shows large transactions where quantity traded exceeds 0.5% of total shares. Useful for tracking institutional activity.

No arguments needed.

Examples: nse_bulk_deals() → Recent bulk/block deals

Get corporate actions for an NSE stock — dividends, stock splits, bonuses.

Shows recent and historical corporate actions with dates and values.

Args: symbol: NSE stock symbol (e.g., ITC, RELIANCE, TCS, COALINDIA)

Examples: nse_corporate_actions("ITC") → ITC dividends and splits nse_corporate_actions("RELIANCE") → Reliance corporate actions

Get latest quarterly financial results for an NSE stock.

Shows revenue, profit, EPS, EBITDA for last 4 quarters with quarter-over-quarter growth rates.

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK)

Examples: nse_quarterly_results("RELIANCE") → Reliance Q results nse_quarterly_results("TCS") → TCS quarterly financials

Get upcoming earnings dates for a stock.

Shows when a company is expected to report earnings, along with analyst estimates (EPS and revenue).

Args: symbol: Stock ticker (e.g., RELIANCE, AAPL). Required.

Examples: earnings_calendar("RELIANCE") → When does Reliance report next? earnings_calendar("AAPL") → Apple earnings date

Get upcoming and recent IPOs on NSE.

Shows company name, price band, dates, issue size, and status.

No arguments needed.

Examples: ipo_calendar() → What IPOs are coming up?

Screen stocks by multiple financial criteria. [PRO]

Filter Nifty 50 or S&P 500 stocks by P/E ratio, ROE, market cap, dividend yield, debt/equity ratio, and sector.

Args: exchange: "NSE" for Indian stocks, "US" for US stocks (default: NSE) pe_max: Maximum P/E ratio (e.g., 15 for value stocks). 0 = no filter. pe_min: Minimum P/E ratio. 0 = no filter. roe_min: Minimum Return on Equity in % (e.g., 20). 0 = no filter. market_cap_min: Minimum market cap in USD (e.g., 1000000000 for $1B). 0 = no filter. dividend_yield_min: Minimum dividend yield in % (e.g., 2). 0 = no filter. debt_equity_max: Maximum debt-to-equity ratio (e.g., 50). 0 = no filter. sector: Filter by sector name (e.g., "Technology", "Financial"). Empty = all. limit: Max number of results (default: 15)

Examples: stock_screener("NSE", pe_max=15, roe_min=20) → Value stocks with high ROE stock_screener("NSE", dividend_yield_min=3) → High dividend yield stocks stock_screener("US", pe_max=20, sector="Technology") → Cheap US tech stocks

Compute support and resistance levels for a stock. [PRO]

Calculates pivot points (R1, R2, R3, S1, S2, S3) and identifies key price levels from historical price action.

Args: symbol: Stock ticker (e.g., RELIANCE, AAPL, TCS) period: Data period: 3mo, 6mo, 1y, 2y (default: 6mo)

Examples: support_resistance("RELIANCE") → Key levels for Reliance support_resistance("AAPL", "1y") → Apple support/resistance with 1yr data

Get options chain data for an NSE stock or index. [PRO]

Returns call and put options with strike price, premium, volume, open interest, implied volatility, and Put-Call Ratio (PCR).

Args: symbol: NSE stock or index symbol (e.g., RELIANCE, NIFTY, BANKNIFTY, TCS)

Examples: nse_options_chain("RELIANCE") → Reliance options chain nse_options_chain("NIFTY") → Nifty 50 options chain nse_options_chain("BANKNIFTY") → Bank Nifty options

Analyze a stock portfolio — P&L, weights, risk. [PRO]

Provide your holdings and get total P&L, individual stock performance, portfolio weights, concentration risk, winners and losers.

Args: holdings: JSON string of holdings array. Each holding needs: symbol, quantity, buy_price. Example: '[{"symbol":"RELIANCE","quantity":10,"buy_price":2500}, {"symbol":"TCS","quantity":5,"buy_price":3800}]'

Examples: portfolio_analysis('[{"symbol":"RELIANCE","quantity":10,"buy_price":2500}]') portfolio_analysis('[{"symbol":"AAPL","quantity":5,"buy_price":150}, {"symbol":"MSFT","quantity":3,"buy_price":380}]')

Backtest a Simple Moving Average (SMA) crossover strategy. [PRO]

Tests: Buy when short SMA crosses above long SMA, sell when it crosses below. Compares strategy return vs buy-and-hold.

Args: symbol: Stock ticker (e.g., RELIANCE, AAPL, TCS) short_window: Short SMA period in days (default: 20) long_window: Long SMA period in days (default: 50) period: Backtest period: 1y, 2y, 5y (default: 2y) initial_capital: Starting capital (default: 100000)

Examples: backtest_strategy("RELIANCE") → Default 20/50 SMA backtest backtest_strategy("AAPL", 10, 30, "5y") → Custom 10/30 SMA, 5 years backtest_strategy("TCS", 50, 200, "5y", 500000) → Golden cross, 5L capital

Calculate Indian LTCG / STCG tax liability for an equity or mutual fund trade.

Applies Indian tax rules (post July 2024 Budget):

• Listed equity / equity MF STCG (≤365 days): 20% flat (Section 111A)

• Listed equity / equity MF LTCG (>365 days): 12.5% above ₹1.25L exemption (Section 112A)

• Debt funds (post Apr 2023): taxed at income slab rate regardless of holding period

• Capital losses: carried forward for 8 years

Args: buy_price: Purchase price per share/unit in INR buy_date: Date of purchase in DD-MM-YYYY format (e.g. 15-01-2023) sell_price: Selling price per share/unit in INR sell_date: Date of sale in DD-MM-YYYY format (e.g. 20-03-2024) quantity: Number of shares or units asset_type: One of: equity, mutual_fund_equity, mutual_fund_debt, debt_fund symbol: Optional stock/fund symbol for display (e.g. RELIANCE, TCS)

Returns: Formatted tax summary with holding period, gain classification, and tax liability.

Examples: calculate_tax_liability(buy_price=1200, buy_date="01-01-2023", sell_price=1500, sell_date="15-03-2024", quantity=100, symbol="RELIANCE")

Advanced options OI analytics: Max Pain, PCR trend, IV summary, top OI strikes.

Covers features Sensibull Pro charges ₹1,300/month for — free here.

Provides:

• Put-Call Ratio (OI and Volume) with sentiment signal

• Max Pain calculation (price gravity at expiry)

• Top call OI strikes (resistance levels from options market)

• Top put OI strikes (support levels from options market)

• Average IV across expiry

• Analysis for 3 nearest expiries

Args: symbol: NSE stock or index symbol (e.g., NIFTY, BANKNIFTY, RELIANCE, TCS)

Examples: options_oi_analytics("NIFTY") → Nifty OI analytics, Max Pain, PCR options_oi_analytics("RELIANCE") → Reliance OI analysis options_oi_analytics("BANKNIFTY") → Bank Nifty options sentiment

Calculate Black-Scholes Greeks (Delta, Gamma, Theta, Vega, Rho) for all option strikes.

Covers features Sensibull Pro charges ₹1,300/month for — free here.

Provides:

• Delta: price sensitivity to underlying move

• Gamma: rate of change of delta (acceleration)

• Theta: daily time decay (what options lose per day)

• Vega: sensitivity to 1% change in implied volatility

• Rho: sensitivity to 1% change in interest rate

• Full chain with Greeks for both calls and puts

Args: symbol: NSE stock or index symbol (e.g., NIFTY, RELIANCE, INFY) expiry: Optional expiry date string YYYY-MM-DD (uses nearest if not provided)

Examples: options_greeks("NIFTY") → Full Greeks for nearest Nifty expiry options_greeks("RELIANCE", "2025-04-24") → Greeks for specific expiry

NSE insider trading and SAST (substantial acquisition) disclosures for a stock.

Covers features Trendlyne (₹4,950/yr) and Screener Pro (₹4,999/yr) charge for — free here.

Shows:

• All SEBI-mandated insider trading disclosures from NSE

• Buy vs sell transaction count

• Insider sentiment summary

• Acquirer/seller name, shares traded, dates

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK) days: Lookback period in days (default 90, max ~365)

Examples: nse_insider_trading("RELIANCE") → Last 90 days insider activity for Reliance nse_insider_trading("TCS", 180) → Last 6 months insider trades for TCS

Shareholding pattern for an NSE stock: promoter, FII, DII, public breakdown.

Covers features Screener.in Pro (₹4,999/yr) and Trendlyne charge for — free here.

Shows:

• Promoter holding percentage

• FII (Foreign Institutional Investor) holding

• DII (Domestic Institutional Investor) holding

• Public / retail holding

• Top institutional and mutual fund holders

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK)

Examples: promoter_shareholding("RELIANCE") → Who owns Reliance and how much promoter_shareholding("HDFCBANK") → HDFC Bank ownership breakdown

Current RBI monetary policy rates: Repo, Reverse Repo, CRR, SLR, MSF, Bank Rate.

Bloomberg Terminal charges $31,980/year for central bank data access. RBI publishes all policy rates free on rbi.org.in — we surface them here.

Provides:

• Repo rate (current RBI lending rate to banks)

• Reverse repo rate

• Marginal Standing Facility (MSF) rate

• Cash Reserve Ratio (CRR)

• Statutory Liquidity Ratio (SLR)

• Bank Rate

• Monetary policy stance

• Last policy action summary

Examples: rbi_policy_rates() → All current RBI policy rates and stance

India macroeconomic indicators: CPI inflation, GDP growth, current account, unemployment.

Bloomberg and Refinitiv charge $24,000–$32,000/year for macro data access. World Bank publishes India macro data free — we surface it here.

Provides:

• CPI inflation (latest and previous year)

• GDP growth rate

• Current account balance as % of GDP

• Unemployment rate

• Gross capital formation

• RBI inflation target and tolerance band

Examples: india_macro_indicators() → Latest India macro data from World Bank

AMFI mutual fund industry data: total AUM, SIP flows, scheme count by category.

Morningstar Direct charges $17,500/year for mutual fund flow data. AMFI (Association of Mutual Funds in India) publishes all data free.

Provides:

• Total industry AUM (approximate)

• Monthly SIP inflow figures

• Total folios and investor count

• Scheme breakdown by category (Equity, Debt, Hybrid, ETF, ELSS, etc.)

• Links to detailed AMFI data portal

Examples: amfi_fund_flows() → India mutual fund industry overview and flows

India Government Securities (G-Sec) yield curve: 91-day T-bill to 30-year bond.

Bloomberg Terminal charges $31,980/year for government bond data. RBI and CCIL publish India G-Sec yields free.

Provides:

• 91-day, 182-day, 364-day T-bill yields

• 5-year, 10-year, 30-year G-Sec yields

• Real interest rate (World Bank)

• Live data source links (CCIL, RBI)

Examples: india_gsec_yields() → Current India government bond yield curve

India VIX — the NSE fear/volatility index with history and signal.

Trendlyne charges for historical India VIX data. NSE publishes it free via ^INDIAVIX.

Provides:

• Current VIX level and daily change

• Signal: low fear / elevated / panic zone

• 30-day high, low, average

• Full daily history for the requested period

• Interpretation guide (what VIX levels mean for markets)

Args: days: Lookback period in days (default 30)

Examples: india_vix() → Current India VIX with signal and 30-day history india_vix(90) → 90-day VIX history for trend analysis

GIFT Nifty pre-market data + overnight global indices for Indian market preview.

Bloomberg charges for global futures data. This is free.

Provides:

• Nifty 50 last close and change

• Global indices overnight performance (S&P 500, Dow, NASDAQ, Hang Seng)

• Market status from NSE

• Links to live GIFT Nifty sources

Examples: gift_nifty() → Pre-market global sentiment + Nifty reference

Promoter pledge percentage — how much of promoter holding is pledged as loan collateral.

Screener.in Pro (₹4,999/yr) charges for this data. NSE publishes it free.

High pledge = risk signal: if the stock falls, lenders can force-sell pledged shares, causing further decline. A key red flag before investing.

Provides:

• Promoter pledge % of total shares

• Pledge % of promoter holding

• Risk signal (clean / low / moderate / HIGH RISK)

• Quarter-wise breakdown

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, ADANIENT)

Examples: promoter_pledge("ADANIENT") → Adani pledge levels and risk signal promoter_pledge("RELIANCE") → Reliance promoter pledge status

10-year dividend history with yield calculation and annual summary.

Bloomberg and FactSet charge for deep dividend history. yfinance has it free.

Provides:

• Full dividend payment history (up to 60 entries)

• Annual dividend totals per year (last 10 years)

• Trailing 12-month dividend yield %

• Total dividends on record

Args: symbol: NSE or global stock symbol (e.g., RELIANCE, TCS, INFY, AAPL)

Examples: dividend_history_deep("TCS") → TCS 10-year dividend history + yield dividend_history_deep("HDFCBANK") → HDFC Bank dividend track record

Nifty PCR (Put-Call Ratio) trend across multiple expiries — market sentiment gauge.

Sensibull Pro charges ₹1,300/month for PCR trend data. We calculate it free.

Provides:

• PCR (OI-based and Volume-based) per expiry

• Overall averaged PCR with sentiment signal

• Bullish / Bearish / Neutral interpretation per expiry

• Total call and put OI per expiry

Args: num_expiries: Number of expiries to analyze (default 5)

Examples: nifty_pcr_trend() → Nifty PCR across 5 expiries with overall sentiment nifty_pcr_trend(3) → Quick 3-expiry PCR snapshot

Real-time NSE quote via Angel One SmartAPI — zero delay, no yfinance lag.

Requires Angel One API credentials in your .env file (stays local, never on GitHub). Falls back gracefully if not configured, with setup instructions.

Zerodha Kite Connect charges ₹500/month for real-time data API. Angel One SmartAPI is free for account holders.

Provides (when configured):

• Live Last Traded Price (LTP) — real-time, zero delay

• OHLC for the day

• Volume, average price

• Upper/lower circuit limits

• Buy/sell quantity

• 52-week high/low

Setup (one-time): Add to .env: ANGEL_API_KEY, ANGEL_CLIENT_ID, ANGEL_PASSWORD, ANGEL_TOTP_SECRET pip install finstack-mcp[broker]

Args: symbol: NSE symbol (e.g., RELIANCE, TCS, NIFTY, BANKNIFTY)

Examples: live_quote("RELIANCE") → Real-time Reliance price (if Angel One configured) live_quote("NIFTY") → Live Nifty index price

Level 2 order book depth — top 5 bid/ask prices and quantities.

This is exchange-licensed real-time data. Zerodha Kite Connect charges ₹500/month for this. Angel One SmartAPI provides it free to account holders.

Requires Angel One API credentials in .env (stays local, never on GitHub).

Provides (when configured):

• Top 5 buy orders (bid price + quantity)

• Top 5 sell orders (ask price + quantity)

• Total buy and sell queue size

Args: symbol: NSE symbol (e.g., RELIANCE, TCS, HDFCBANK)

Examples: market_depth("RELIANCE") → Live order book for Reliance

Check Angel One SmartAPI integration status and get setup instructions.

Shows whether your Angel One credentials are configured and working. Also explains how to set up if not configured yet.

Your API key stays in your local .env file — never committed to GitHub. The open-source code only reads environment variables, never stores keys.

Examples: broker_setup_status() → Check if Angel One is connected + setup guide

Credit ratings for an Indian listed company from SEBI-mandated exchange filings.

SEBI requires all rated instruments to disclose credit rating changes on NSE/BSE. Bloomberg charges $24,000/year to access this. SEBI makes it public. We surface it free.

Provides:

• Rating agency (CRISIL, ICRA, CARE, India Ratings)

• Current rating and rating action (upgraded/downgraded/reaffirmed)

• Instrument type and rated amount

• Outlook (stable/positive/negative/watch)

• Filing date

Args: symbol: NSE stock symbol (e.g., RELIANCE, TATAMOTORS, ADANIENT)

Examples: credit_ratings("RELIANCE") → Reliance credit ratings from CRISIL/ICRA credit_ratings("ADANIENT") → Adani credit rating history and current outlook

BRSR (Business Responsibility & Sustainability Report) ESG data for listed companies.

SEBI mandates BRSR from India's top 1000 listed companies since FY2022-23. Bloomberg and LSEG charge $24,000+/year for ESG scores. SEBI makes BRSR filings publicly available. We surface them free.

Provides:

• BRSR filing links (PDF) for last 3-5 years

• BRSR framework: 9 principles covering ESG topics

• Environment disclosures (GHG, energy, water, waste)

• Social disclosures (employees, safety, CSR)

• Governance disclosures (ethics, stakeholder engagement)

• Direct links to NSE/BSE BRSR portals

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK)

Examples: brsr_esg("TCS") → TCS BRSR filings and ESG framework coverage brsr_esg("RELIANCE") → Reliance sustainability disclosures

Real-time NSE stock quote via Fyers API v3 (zero delay when configured).

Returns LTP, O/H/L/C, volume, change%, 52W high/low.

Setup: pip install fyers-apiv3 FYERS_APP_ID=... FYERS_ACCESS_TOKEN=... FYERS_CLIENT_ID=... Get credentials at https://myapi.fyers.in/

Args: symbol: NSE symbol (e.g. RELIANCE, TCS, INFY)

Historical OHLCV candles from Fyers API v3.

interval options: 1m, 3m, 5m, 10m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo

Args: symbol: NSE symbol (e.g. RELIANCE) interval: Candle interval (default: 1d) days: Number of days of history (default: 30)

Check Fyers API v3 configuration status and setup instructions.

Real-time NSE quote via ICICI Breeze API (zero delay when configured).

Returns LTP, O/H/L, previous close, volume, change%.

Setup: pip install breeze-connect ICICI_API_KEY=... ICICI_API_SECRET=... ICICI_SESSION_TOKEN=... Session token refreshed daily: ICICIdirect app → My Account → Generate API Session

Args: symbol: NSE symbol (e.g. RELIANCE, TCS, HDFCBANK)

Historical OHLCV candles from ICICI Breeze API.

interval options: 1m, 5m, 30m, 1h, 1d

Args: symbol: NSE symbol (e.g. RELIANCE) interval: Candle interval (default: 1day) days: Number of days of history (default: 30)

Check ICICI Breeze API configuration status and daily session token instructions.

Analyze social media sentiment for any NSE stock using Reddit + Twitter.

Scrapes up to limit posts from r/IndiaInvestments, r/DalalStreetTalks, and Twitter/X, classifies each as bullish/bearish/neutral, extracts key themes, and returns a BUY/HOLD/SELL signal with confidence level.

Falls back to yFinance news headlines if social APIs are not configured.

Args: symbol: NSE stock symbol (e.g. RELIANCE, TCS, INFY) limit: Max posts to analyze (default 100, max 200)

Returns JSON with: - bullish_pct / bearish_pct / neutral_pct - signal (BUY / HOLD / SELL) - confidence (low / medium / high) - key_themes: top recurring topics in the posts - summary: single-line readable summary - sample_posts: top 5 posts with sentiment tag

Setup (optional, for real social data): pip install praw tweepy REDDIT_CLIENT_ID=... REDDIT_CLIENT_SECRET=... TWITTER_BEARER_TOKEN=...

Multi-agent AI stock brief: 6 personas debate whether to BUY, HOLD, or SELL.

Like a Rs500Cr fund meeting, 6 different experts analyse the same stock from their angle and reach a consensus using real Indian market data:

• FII Desk: institutional flows, promoter holding, FII %

• Algo Trader: RSI, MACD, VWAP, volume anomaly

• Value Investor: P/E, ROE, debt ratio, credit rating

• Retail Pulse: news tone, 52W position, India VIX

• Macro Analyst: RBI rates, CPI inflation, G-Sec yields

• Options Flow: PCR, max pain, OI skew

Args: symbol: NSE stock symbol (e.g. RELIANCE, TCS, HDFCBANK)

Returns JSON with: - consensus: {signal, strength, votes, disagreement} - debate: [{agent, verdict, argument, one_liner}] - the 6-way debate - agents_detail: full data + reasoning per agent

3-round sequential debate: AI agents read each other's arguments and rebut.

Unlike get_stock_brief (parallel analysis), this runs a live debate: Round 1 - Each agent analyses independently Round 2 - Each agent reads all other Round 1 verdicts and can change mind Round 3 - Final lock-in with closing statement

Watch for "minds_changed" - when agents flip verdict mid-debate, it signals a complex setup worth closer attention.

Also returns "debate_edges" - who influenced whom - consumable by the AgentBattle canvas visualisation.

Args: symbol: NSE stock symbol (e.g. RELIANCE, TCS, HDFCBANK)

Returns JSON with: - rounds: {round1, round2, round3} - full transcript - debate_edges: [{from, to, type, text}] - influence graph - minds_changed: how many agents revised their verdict - final_consensus: {signal, strength, votes, note}

Detect smart money and unusual activity for any NSE stock.

Scans 4 signals simultaneously: • Volume anomaly — current volume vs 20-day average (flags 2x+) • Options OI — strikes with 2x+ average open interest buildup • Block/bulk deals — institutional buy/sell transactions on NSE • Promoter change — QoQ shareholding increase (insider buying signal)

Returns an alert level (high/moderate/low/none) with specific findings.

Example output: "Unusual call OI at 3000 strike — someone is positioning for a breakout" "Promoter increased holding by 2.3% QoQ — insider buying signal"

Args: symbol: NSE stock symbol (e.g. RELIANCE, HDFC, TATAMOTORS)

Returns JSON with: - alert_level: high / moderate / low / none - verdict: human-readable summary - alerts: list of specific signals fired - findings: per-category details (volume, OI, deals, promoter)

Compute the probability that Nifty 50 closes UP in the next trading session.

Aggregates 6 market signals into a single % score: • RSI(14) — overbought/oversold momentum • FII net flow (5d) — institutional buy/sell pressure • Put/Call Ratio — options market positioning (contrarian signal) • India VIX — fear index (low=risk-on, high=fear) • G-Sec 10Y yield — interest rate pressure on equities • GIFT Nifty — overnight global pre-market signal

Returns JSON with: - probability_up: e.g. 67 (% chance Nifty goes up) - signal: "Bullish" / "Cautiously bullish" / "Neutral" / "Bearish" - bull_factors: list of signals supporting upside - bear_factors: list of signals supporting downside - inputs: raw values for all 6 signals

Example: "67% probability Nifty up tomorrow — FII buying + low VIX but overbought RSI"

Build a clean NIFTY / BANKNIFTY options setup for intraday decisions.

This packages the strongest nifty-agent behavior into one MCP call: read trend, RSI, MACD, FII flows, PCR, VIX regime, and overnight context, then return one clear action:

• BUY_CE

• BUY_PE

• NO_TRADE

Also returns:

• confidence_pct

• preferred ATM strike zone

• approve_message

• bull and bear factors

• risk flags

AI earnings preview before quarterly results.

Combines 4 signals to estimate beat/miss probability:

• Last 4 quarters EPS trend (improving / declining / mixed)

• Analyst consensus recommendation + target price upside

• FII QoQ shareholding change (building before results = positive)

• Stock alpha vs Nifty last 30 days (momentum into results)

Returns:

• beat_probability_pct: e.g. 72

• signal: BEAT LIKELY / SLIGHT BEAT / IN-LINE OR MISS / MISS LIKELY

• key_risks: list of red flags

• what_to_watch: what to monitor on results day

• next_earnings_date: from yFinance calendar

Viral use: post prediction before TCS/Infy results. Screenshot if correct.

Args: symbol: NSE symbol (e.g. TCS, INFY, HDFCBANK, RELIANCE)

Portfolio X-ray: deep risk + return analysis for your holdings.

Input format — list of holdings: [ {"symbol": "RELIANCE", "qty": 10, "avg_price": 2400, "buy_date": "2024-01-15"}, {"symbol": "TCS", "qty": 5, "avg_price": 3800} ]

Returns:

• total invested, current value, P&L, P&L %

• XIRR (if buy_date provided)

• per-holding breakdown with sector

• sector concentration % (flags if > 40% in one sector)

• risk flags: pledged promoters, single stock > 30%, FII reducing

• diversification score (0–100)

Args: holdings: list of {symbol, qty, avg_price, buy_date (optional)}

Mutual fund overlap analyzer using public AMFI portfolio disclosures.

"Your HDFC Flexi Cap + Mirae Asset Large Cap have 68% overlap — you're not diversified, you're holding the same stocks twice."

Supported funds include: HDFC Flexi Cap, Mirae Asset Large Cap, Parag Parikh Flexi Cap, Axis Bluechip, SBI Bluechip, Nippon Large Cap, Kotak Emerging Equity, Quant Small Cap, DSP Small Cap, Nifty 50 Index.

Returns:

• overlap_pct: % of stocks common between both funds

• common_stocks: list of shared holdings

• unique_to_fund1, unique_to_fund2

• verdict + risk level (low / medium / high)

Args: fund1: Fund name (e.g. "HDFC Flexi Cap") fund2: Fund name (e.g. "Mirae Asset Large Cap")

Detect FII vs retail divergence — the highest-conviction signal in Indian markets.

When FII and retail move in OPPOSITE directions on the same stock:

• FII buying + retail selling = institutional accumulation (BUY signal)

• FII selling + retail buying = institutional distribution (SELL signal)

"FIIs bought ₹800Cr of HDFC Bank while retail was panic selling — historically this means +18% in 3 months"

Based on public NSE shareholding disclosures (quarterly).

Args: symbol: NSE symbol (e.g. HDFCBANK, RELIANCE, TATAMOTORS)

Returns:

• divergence_type, signal, confidence

• interpretation + historical_implication

• raw shareholding change data (FII, DII, retail QoQ)

8:15 AM pre-market brief for Indian traders.

Compiles in one call:

• GIFT Nifty pre-market signal

• India VIX fear index

• Nifty direction probability (6-signal model)

• FII net flow from yesterday

• Top gainers / losers

• Sector performance

• Upcoming earnings today

• Watchlist signals for top 5 Nifty stocks

Returns structured JSON + morning_text (ready to copy-paste or send via WhatsApp/email).

8:15 AM F&O-focused morning brief for NIFTY and BANKNIFTY traders.

Compiles in one call:

• GIFT Nifty and India VIX

• Nifty direction probability

• NIFTY options setup

• BANKNIFTY options setup

• ready-to-send morning_text for Telegram / WhatsApp style delivery

Promoter pledge early warning for an NSE stock.

Checks current pledge % and QoQ change velocity. Risk levels: safe (< 10%) / watch (rising) / danger (> 30%) / critical (> 50%)

"Caught 3 stocks before they fell 40% — promoter was pledging shares"

Risk: When promoters pledge shares as collateral for loans, a falling stock price can trigger margin calls → forced selling → crash.

Args: symbol: NSE symbol (e.g. ADANIENT, ZEEL, any stock)

Returns:

• pledge_pct, pledge_change_qoq

• risk_level: safe / watch / danger / critical

• alert: specific warning message

• historical: last 4 quarters of pledge data

Scan multiple NSE stocks for promoter pledge risk simultaneously.

Returns results sorted by risk level (critical first). Useful for screening your watchlist or Nifty 500 for pledge dangers.

Args: symbols: list of NSE symbols (e.g. ["ADANIENT", "ZEEL", "RELIANCE", "TCS"])

Detect pump-and-dump operator activity in an NSE stock.

Scans for coordinated pump patterns:

• Volume spike > 3x 20-day average

• Price surge > 20% in 5 days without news

• Multiple upper circuit days in last week

• Micro/small cap (highest vulnerability)

"This microcap hit 3 upper circuits in a week — 9 out of 10 times this reverses violently"

Returns:

• pump_probability: low / medium / high / critical

• red_flags: specific signals that fired

• verdict + recommendation (exit / avoid / cautious)

Args: symbol: NSE symbol (most useful for small/micro caps)

Batch-rank a watchlist using FinStack's multi-factor stock signal score.

Best use:

• daily watchlist triage

• n8n / WhatsApp automation

• finding top buys and top risks in one shot

Args: symbols: list of NSE symbols (e.g. ["RELIANCE", "TCS", "HDFCBANK", "INFY"])

Returns:

• ranked_watchlist: sorted by signal_score

• top_buys

• top_risks

Unified stock timeline: news, results, insider, bulk deals, sentiment, pledge, smart money.

This is the "what changed recently?" tool for a stock.

Args: symbol: NSE symbol (e.g. RELIANCE, HDFCBANK, TCS) max_events: max timeline events to return

Automation-friendly stock ranking score built from FinStack signals.

Combines:

• multi-agent consensus

• smart money activity

• social sentiment

• promoter pledge risk

• insider signal

• technical momentum

• peer / sector context

• earnings setup

Returns:

• signal_score: 0-100

• signal: BUY / HOLD / SELL

• automation_rank

• top_supports / top_risks

• full component breakdown

Sector and peer context for a stock.

Shows:

• likely peer basket

• peer rank

• valuation vs peers

• sector performance context

Args: symbol: NSE symbol (e.g. RELIANCE, HDFCBANK, INFY)

Lightweight evaluation / proof layer for the signal engine's price-action core.

Important:

• this is an honesty tool, not a marketing gimmick

• it does not claim the full live system has exactly this accuracy

• it gives a defensible evaluation layer before making accuracy claims

Args: symbol: NSE symbol lookback_months: historical window for checkpoints holding_days: forward return horizon for hit evaluation

Predict lower circuit risk for an NSE stock.

Combines 5 signals: price proximity to 52W low, volume dry-up, promoter pledge velocity, FII net selling, negative news sentiment.

Risk levels: safe / watch / danger / imminent

"Predicted 4 lower circuits in March — here's how"

Args: symbol: NSE symbol (most useful for mid/small caps under stress)

SEBI enforcement order tracker — early warning before regulatory crash.

Fetches recent SEBI orders and classifies by severity and sector. High-severity actions (fraud, manipulation, debarment) historically precede 15-30% corrections in the affected stock.

"SEBI filed 3 orders against this sector this week — historically precedes 15% correction"

Args: sector: Filter by sector (e.g. "Banking", "SME/Micro", "Broking"). Use "all" for full report.

GST collection data → sector performance predictor.

Monthly GST figures (Finance Ministry, public) are a 1-3 month leading indicator for demand-sensitive sectors.

"GST from auto sector up 24% YoY → MSIL/Bajaj Auto historically follow in 2-3 months"

Sectors covered: Auto, FMCG, Real Estate, Cement, Steel, IT, Banking, Retail.

Args: sector: Sector name (e.g. "Auto", "FMCG", "Cement"). Use "all" for full cross-sector report.

AI briefing for upcoming AGM/EGM resolutions from NSE filings.

Flags unusual resolutions:

• Large debt issuance (₹500Cr+ raise)

• Management salary hikes

• Related-party transactions (promoter benefit risk)

• New subsidiary creation (liability hiding risk)

• Buyback cancellation (cash crunch signal)

• Fresh equity (dilution)

• Auditor resignation (serious red flag)

• Promoter pledge approval

"This company is passing a resolution to raise ₹500Cr debt next week — should you be worried?"

Args: symbol: NSE symbol (e.g. RELIANCE, ZEEL, ADANIENT)

Insider trading pattern analysis from SEBI SAST disclosures (public).

Tracks promoter/director/KMP buy and sell transactions. Insiders buying their own stock = strongest possible conviction signal.

"When this CFO buys his own stock → average return is +23% in 6 months"

Returns:

• signal: BUY / SELL / NEUTRAL

• net_signal: accumulating / distributing / neutral

• recent buy/sell transactions with person + designation

• price change since last insider buy

Args: symbol: NSE symbol (e.g. RELIANCE, INFY, ZEEL)

Dalal Street Telegram signal tracker.

Compares 50 public Indian stock tip channels by accuracy %, average return %, and pump-and-dump probability.

"I tracked 50 Indian stock tip channels for 30 days — here's which ones are scamming you"

Works out of the box with curated channel database. Enable live tracking with: pip install telethon + TELEGRAM_API_ID/HASH/PHONE

Args: channel: Specific channel handle (e.g. "@NSEBSEtips"). Leave empty for full comparison database.

Real-time budget speech analyzer — use on Feb 1st as FM speaks.

Paste the Finance Minister's speech text (any length, even partial). Returns instant sector + stock impact mapping.

"FM just said ₹2L Cr for infrastructure → BUY L&T, NTPC, IRB Infra"

Detects mentions of: Infrastructure, Defence, Pharma, Renewable Energy, Real Estate, Agriculture, Auto, FMCG, IT/Digital, Steel, Telecom, Tax changes.

Args: text: Budget speech transcript text (paste directly from live broadcast)

Historical Union Budget impact by year.

Returns key announcements, sector winners, sector losers, and market reaction from past Indian Union Budgets.

Available years: 2023, 2024, 2025

Args: year: Budget year as string (e.g. "2025", "2024", "2023")

Show how accurate FinStack signals have been — backed by real outcome data.

Signals are logged automatically every time get_stock_brief or get_stock_debate runs. After 7 days, the actual stock price is checked and outcomes are labelled correct / wrong / neutral.

Use this to:

• Prove to users/investors that the signals work

• Find which signal source (brief vs debate) is more accurate

• Find which stocks the model reads best

Args: source: filter by source — 'brief', 'debate', 'score', or '' for all symbol: filter by NSE symbol, or '' for all stocks days: look-back window in days (default 30)

Returns: Accuracy %, avg 7-day return, breakdown by signal type, top symbols.

View recent signals logged by FinStack with their actual outcomes.

Each row shows: symbol, signal (BUY/HOLD/SELL), price at signal time, 7-day actual return, and outcome label (correct/wrong/neutral).

Use this to audit the model, build trust with users, or export for analysis.

Args: symbol: NSE symbol to filter (e.g. RELIANCE), or '' for all limit: number of rows to return (default 20, max 100)

Manually trigger outcome checking for all pending signals.

Normally runs automatically, but you can call this to force-check any signals whose 7-day or 30-day window has elapsed.

Returns how many signals were updated.

Return basic server metadata and useful links.