94 tools your AI can call

The DocStoX guide: every tool grouped by area with its parameters, the NSE symbol convention, data-freshness notes and worked examples of multi-tool research. Takes no arguments and is never counted against usage quota.

Search for Indian stocks by symbol, company name, or ISIN.

query required

Symbol, company name or ISIN, matched as a case-insensitive substring. Examples: 'RELIANCE', 'tata motors', 'INE002A01018'.

sector optional

Sector name, e.g. 'Information Technology'. Case-insensitive.

limit optional

Max rows to return (1-50).

Top movers for the current or latest NSE session: gainers, losers, most active and high delivery.

category optional

Gainers / losers = largest % rise / fall on the day; volume = most traded (live: most active; end-of-day: by traded value); delivery_high = highest delivery % (>= 50%, SME / trade-for-trade series excluded).

limit optional

Max rows to return (1-100).

Current price, change %, volume, delivery %, 52-week high/low, key ratios.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Quotes for up to 20 stocks in a single call: portfolio snapshots and side-by-side comparison.

symbols required

1-20 NSE symbols, e.g. ['RELIANCE', 'TCS', 'HDFCBANK'].

Historical OHLCV (max 2000 days) plus a smoothed returns block that anchors headline return/CAGR on trailing medians and flags single-session anomalies, so a spiky last candle doesn't distort the numbers.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

days optional

Calendar days of history (1-3650). EOD data starts 2020.

exchange optional

Prices are keyed by (symbol, exchange); ~46% of names are dual-listed, so pick the one you mean.

adjusted optional

True = prices adjusted for splits and bonuses, one row per session. Use it for charts and multi-year returns: the raw series shows a bonus or split as a fake crash. Default false returns the prices as the exchange printed them.

Commodities, GIFT Nifty, Indian and world indices and FX, refreshed every minute.

group optional

Restrict to one section; omit for the whole board

item optional

Name or id, matched loosely: 'gold', 'silver', 'crude', 'gift nifty', 'nasdaq', 'usd/inr', 'MCX_GOLD'

history_days optional

Daily session closes for one item (needs item)

Everything about one stock in a single call: the A-Z research dossier.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

sections optional

Subset of: profile, quote, fundamentals, financials, valuation, ownership, technicals, peers, themes, analysts, news, events, calendar, documents. Omit for all.

news_days optional

News lookback window in days.

AI-ready Research View for a stock: a decision aid, not raw data.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Deterministic composite score (0 to 10) with BUY/HOLD/AVOID verdict, confidence %, and sub-scores (growth, quality, momentum, risk) each with explanatory factors, plus key strengths/risks and the analyst target/upside. The figures are the engine's fixed output for this stock, not an estimate. [Pro] Non-Pro callers get a locked stub: the AI Score/Verdict is Pro-exclusive.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Rule-based thesis for a stock: bull case, bear case, key monitorables, what must happen and what would break the thesis, each line derived from a measured factor (growth, return ratios, leverage, cash flow, ownership changes, trend) and carrying its current value. Not a forecast.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Full fair-value workup: models, assumptions, scenarios, sensitivity, reverse-DCF, moat and confidence.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

include_models optional

Include every model run, with rejection reasons.

include_assumptions optional

Include the assumption ledger.

include_sensitivity optional

Include the sensitivity grid.

Same-sector peers (computed PE, market cap, revenue/profit growth, ROE, debt/equity) plus sector medians for relative valuation.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

limit optional

Max peers to return (1-50).

Plain-English strengths (pros) and weaknesses (cons) plus growth-rate metrics (QoQ/1Y/3Y/5Y revenue, profit, EBITDA, ROE) for a stock.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Backtested performance of the scoring engine: returns-based metrics (hit rate, avg/median forward return, alpha vs Nifty) per verdict. Pass an NSE symbol for stock-level, omit for model-wide. This is a backtest, not a prediction-accuracy guarantee.

symbol optional

NSE symbol for a stock-level record, e.g. 'TCS'. Omit for the model-wide record.

How a stock's scoring-engine verdict has trended over time: score, verdict, confidence, fair-value range, sub-scores, and price at each snapshot. Reveals whether the thesis is strengthening or deteriorating.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

limit optional

Max snapshots, newest first (1-100).

Full company profile: sector, industry, fundamentals, listing info.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

include_technicals optional

True adds the latest RSI, SMAs, MACD, Bollinger, Supertrend, ADX, ATR and Stochastic readings.

include_peers optional

True adds up to 6 same-sector peers (price, P/E, ROE, revenue).

P&L, balance sheet, cash flow, and computed ratios.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

period_type optional

Q = quarterly, A = annual. not 'quarterly'/'annual'.

report_type optional

Consolidated includes subsidiaries. Standalone has wider coverage in this DB, so retry with it if empty.

periods optional

How many periods, newest first (1-40).

Financial trend + analyst view + ownership shift for many stocks at once.

symbols required

NSE symbols, up to 25 per call (heavier than get_batch_fundamentals).

period_type optional

Q = quarterly, A = annual. not 'quarterly'/'annual'.

include_forecasts optional

Attach the analyst consensus + target per symbol.

include_shareholding optional

Attach the promoter/FII/DII shift per symbol.

Valuation, quality, growth and trend metrics for up to 50 stocks in one call.

symbols required

NSE symbols, up to 50 per call.

include_technicals optional

Also return RSI/SMA/trend fields per symbol.

Complete set of screener ratios from the mv_screener_snapshot view.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Analyst estimates vs actuals for a stock: revenue, EPS, EBITDA per fiscal period, with surprise %, plus the last known analyst price target. Includes forward periods (estimates, no actuals yet).

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

How analyst consensus and target price have moved: the revision trend.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

days optional

Lookback window in days (7-730).

Last known consensus, target price and computed upside for up to 50 symbols.

symbols required

NSE symbols, e.g. ['RELIANCE','TCS'].

Company filings & documents: quarterly/annual results, annual reports, concall transcripts, investor presentations, LODR filings, announcements, credit ratings, with title, date, and source URL, plus an AI-written summary of the filing where one has been produced.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

doc_type optional

Restrict to one document type; omit for all. counts_by_type in the response shows what exists.

limit optional

Max documents, newest first (1-100).

What a company disclosed over time: a dated, source-linked timeline of results, order wins, management and auditor changes, ratings, legal and capital events, ownership moves and deals.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

days optional

Days of history. Free: 365; Pro: up to 1825 (5 years); free callers asking for more get 365 plus a count of older events.

include_routine optional

Include routine filings. Default false: routine paperwork (e.g. trading-window notices) is left out.

kinds optional

Only these kinds, e.g. ['order','auditor']. Valid: results, board_meeting, order, capacity, deal, capital, buyback, dividend, rating, auditor, leadership, legal, ownership, investor_comm, shareholder_meeting, clarification, other. Omit for all.

limit optional

Max events. Material events are kept first when the window holds more.

Upcoming results / board meetings: who reports and when.

symbol optional

NSE symbol to scope results to. Omit for market-wide.

days_ahead optional

How far FORWARD to look, in days (0-180).

days_back optional

How far back to include, in days (0-180).

only_results optional

True = results meetings only; False = all board purposes (dividend, fundraising, ...).

limit optional

Max meetings to return, soonest first (1-200).

Corporate actions (dividends, splits, bonuses, buybacks) for a stock.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

limit optional

Max corporate-action rows (1-100), newest ex-date first. The 10 latest bulk/block deals are always included.

Structured corporate-action records (not headlines): dividends, splits, bonuses, buybacks, with ex/record/payment dates, amounts and ratios.

symbol optional

NSE symbol to scope results to. Omit for market-wide.

action_type optional

Corporate action type: DIVIDEND, BONUS, SPLIT, RIGHTS, BUYBACK or OTHER. Omit for all.

days optional

Window in days around today (1-365).

limit optional

Max rows to return (1-100).

Promoter, FII, DII, MF, and public holdings for last N quarters.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

quarters optional

Quarters of history, newest first (1-20).

Shareholding pattern and MF holdings for a stock.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

quarters optional

Quarters of shareholding history, newest first (1-20).

Scheme-level mutual fund ownership for a stock.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

top optional

Max schemes to return, largest position first (1-100).

Notable-investor portfolios: who holds what, and what they changed.

investor_slug optional

Investor slug returned by a prior call.

symbol optional

NSE symbol to scope results to. Omit for market-wide.

action optional

Quarter-on-quarter move to filter by.

min_value_cr optional

Minimum position value in INR crore.

limit optional

Max rows to return (1-100).

Insider trades (SEBI PIT): who inside a company bought or sold, and how much.

symbol optional

NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.

days optional

Lookback window in days by disclosure date (1-400).

transaction_type optional

PLEDGE/REVOKE move no economic ownership - they are not buying or selling, and are a separate signal from insider conviction.

promoters_only optional

True = promoter, promoter-group and director filings only (excludes routine employee ESOP activity).

min_value_inr optional

Minimum deal value in rupees (not crore), e.g. 10000000 for ₹1 crore.

limit optional

Max filings to return (1-200).

SAST disclosures: substantial (>5%) acquisitions and takeover activity.

symbol optional

NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.

days optional

Lookback window in days (1-4000); history reaches 1995.

acquirer optional

Case-insensitive substring of the acquirer's name, e.g. 'LIC' or 'Adani'.

promoter_group optional

True = promoter-group acquirers only; false = non-promoter only; omit for both.

min_pct_traded optional

Minimum % of the company's capital in the transaction, e.g. 2.

limit optional

Max disclosures to return (1-200).

Promoter pledge events: shares pledged, released, or seized by lenders.

symbol optional

NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.

days optional

Lookback window in days (1-4000).

event_type optional

CREATION = shares pledged (risk up). RELEASE = pledge lifted (risk down). INVOCATION = the lender SEIZED the shares, a serious distress signal.

limit optional

Max events to return (1-200).

Promoter pledge / encumbrance events with the real encumbered percentage.

symbol optional

NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.

days optional

Lookback window in days (1-800).

min_pct optional

Minimum post-event encumbered % of the promoter's holding, e.g. 20.

invocations_only optional

True = only INVOCATION events (a lender seizing pledged shares).

limit optional

Max events to return (1-200).

What the exchange says about a stock's risk today: surveillance, circuit band, official volatility, 52-week position and short selling.

symbol optional

NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.

flagged_only optional

True = only names under ASM/GSM/ESM surveillance.

min_annualised_vol optional

Minimum exchange-computed annualised volatility as a FRACTION: 1.0 = 100%, 0.5 = 50%.

limit optional

Max rows to return (1-200).

Custom stock screener with fundamental, technical, market, ownership and corporate-action filters.

min_pe optional

Minimum trailing P/E ratio (price / EPS), e.g. 5.

max_pe optional

Maximum trailing P/E ratio, e.g. 20.

min_pb optional

Minimum price-to-book ratio, e.g. 0.5.

max_pb optional

Maximum price-to-book ratio, e.g. 3.

min_roe optional

Minimum return on equity, percent (15 = 15%).

min_roce optional

Minimum return on capital employed, percent (20 = 20%).

min_roa optional

Minimum return on assets, percent (5 = 5%).

min_roic optional

Minimum return on invested capital, percent.

min_net_margin optional

Minimum net profit margin, percent.

min_ebitda_margin optional

Minimum EBITDA margin, percent.

max_altman_z optional

Maximum Altman Z (distress screening).

max_debt_equity optional

Maximum debt-to-equity ratio as a multiple (0.5 = debt is half of equity).

max_net_debt_ebitda optional

Maximum net debt / EBITDA as a multiple, e.g. 2.

min_interest_coverage optional

Minimum interest coverage (EBIT / interest) as a multiple, e.g. 3.

min_free_cash_flow optional

Minimum latest annual free cash flow in ₹ crore; 0 keeps only FCF-positive companies.

min_rsi optional

Minimum 14-day RSI (0-100), e.g. 50.

max_rsi optional

Maximum 14-day RSI (0-100), e.g. 70.

sector optional

Sector name, e.g. 'Information Technology'. Case-insensitive.

market_cap_cat optional

Size band. A trailing ' Cap' is stripped before the query, so either spelling works.

min_revenue_yoy_pct optional

Minimum revenue growth vs the same period a year earlier, percent (15 = 15%).

min_pat_yoy_pct optional

Minimum net-profit (PAT) growth year on year, percent.

min_piotroski optional

Minimum Piotroski F-score (0-9); 7+ is strong.

min_altman_z optional

Minimum Altman Z-score; above ~3 is the 'safe' zone, below 1.8 distress.

max_promoter_pledged optional

BROKEN: reads mv_screener_snapshot.promoter_pledged_pct, which is ~0% populated in this DB, so any value here matches almost nothing. Use screen_advanced with the own_pledged_pct metric instead, which reads the source table.

min_promoter_pct optional

Minimum promoter holding %. Also sparse here; screen_advanced own_promoter_pct reads the source table.

supertrend_bullish optional

True = Supertrend indicator in an uptrend; false = downtrend.

near_52w_low optional

Within 5% of the 52-week low.

new_52w_high optional

Printed a new 52-week high.

volume_breakout optional

Volume broke out versus its own average.

golden_cross optional

True = 50-day SMA crossed above the 200-day SMA in the latest session.

above_sma200 optional

True = price above its 200-day simple moving average.

min_delivery_pct optional

Minimum delivery percentage of traded volume (0-100), e.g. 50.

min_listing_age_months optional

Minimum months since listing. Defaults to 3 (thin history breaks technical screens); pass 0 to include new listings.

has_upcoming_corporate_action optional

True = an ex-date (dividend, bonus, split, rights, buyback) falls within catalyst_window_days.

catalyst_window_days optional

Days ahead to look for an ex-date when has_upcoming_corporate_action=True.

sort_by optional

Column to rank by.

sort_dir optional

DESC = largest first, ASC = smallest first.

limit optional

Max rows to return (1-100).

The stock-discovery primitive: compile an investment thesis into a screen.

filters optional

Filter tree. A leaf is {"metric": <id>, "op": ">=|<=|>|<|==|!=", "value": <number|bool|text>}. Combine with {"all":[...]} (AND), {"any":[...]} (OR) and {"not": <node>}; nesting is allowed. A plain list is treated as AND. Metric ids come from list_screener_metrics().

sort_by optional

Ranking. A metric name, or a list for multi-key ranking: [{"metric":"pat_yoy_pct","dir":"DESC"},{"metric":"pe_ratio","dir":"ASC"}]. An unknown key is REJECTED, never silently defaulted.

sort_dir optional

Direction for a plain-string sort_by: DESC = largest first, ASC = smallest first.

limit optional

Max rows to return (1-100).

exclude_etfs optional

Drop ETFs/fund units, which otherwise top any cheapness ranking (a Kotak ETF shows P/B 0.08).

min_listing_age_months optional

Exclude recent listings; thin history breaks technical and multi-year screens. 0 to include them.

min_liquidity optional

Require market cap >=100cr and 30d avg volume >=5,000 shares. Without it, ranking by a quality or growth metric surfaces untradeable shells whose ratios are noise.

Discover every metric screen_stocks can filter and sort on.

category optional

Metric family, e.g. growth | valuation | quality | balance_sheet. Omit for all.

filterable_only optional

Legacy flag: every metric listed is filterable, so this is a no-op kept for compatibility.

min_coverage_pct optional

Drop metrics covering less of the universe than this.

search optional

Substring match on metric id or description.

Full set of pre-computed technical indicators for a stock.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Screen active NSE equities by a technical pattern or signal on the latest session.

pattern optional

Golden_cross = 50-day SMA crossed above the 200-day SMA within the last ~10 sessions and is still above, newest cross first; rsi_oversold = 14-day RSI below 30, lowest first; rsi_overbought = RSI above 70, highest first; supertrend_bullish = Supertrend uptrend, strongest trend (ADX) first. Pass exactly one of pattern or signal.

signal optional

Breakout_52w_high = closed at a new 52-week high in the latest session, ranked by volume vs its 20-day average. Pass exactly one of pattern or signal.

limit optional

Max rows to return (1-100).

Market-wide technical signal board for the latest session.

Where the setups are: breadth, sector strength and sector rotation.

Market-wide state of the base/breakout universe.

Indian stocks building a base, or breaking out of one.

stage optional

Forming = under the pivot; fresh_breakout = cleared it within 5 sessions; climbing = broke out earlier and holding; played_out = fell back under it.

archetype optional

Comma-separated shapes: vcp, blue_sky, multi_year, ipo_base.

min_rs optional

Minimum relative strength 1-99. 70+ is a market leader.

within_pct_of_pivot optional

Only stocks this close BELOW the pivot. Pass 3 for 'within 3% of breaking out'. Use with stage='forming'.

sector optional

Exact sector name, e.g. 'Healthcare'. Omit for all.

industry optional

Exact industry name, e.g. 'Pharmaceuticals'. Omit for all.

min_turnover_cr optional

Minimum median daily turnover, ₹ crore.

sort optional

Column to rank by, always largest first: rs = relative strength rating; dist_pivot = % from pivot (nearest to or above the pivot first); turnover = median daily turnover; depth = base depth %; weeks = base length; coil = tightness score; dry = volume dry-up score; contractions = contraction count; breakout_date = most recent breakout.

limit optional

Max rows to return (1-50).

Screen Indian stocks for chart patterns, with trigger and invalidation prices.

pattern_type optional

Comma-separated pattern ids: vcp (volatility contraction), double_bottom, double_top, support_breakdown, blue_sky (base at the highest price since 2020), ipo_base, multi_year, and the one-day events high_52w, low_52w, nr4, nr7, inside_day. Loose names such as 'double bottom' or 'W' are accepted.

family optional

Comma-separated families instead of types: base, continuation, reversal_bull, reversal_bear, breakdown, price_action, stage. Omit both for every STRUCTURAL family (price_action excluded).

direction optional

Shape direction: bullish = trigger above price, bearish = trigger below. Geometry, not a forecast.

state optional

Open = not failed/broken/finished (default); near_trigger = complete and within a few % of the trigger; forming = not yet triggered; triggered = crossed the trigger; resolved = failed/broken/finished.

min_shape_match optional

Minimum shape match, 0-100: how closely the shape fits the definition. Not a confidence or probability.

min_rs optional

Minimum relative strength rating now, 1-99.

sector optional

Sector, e.g. 'Healthcare' or 'Information Technology'. Everyday words ('pharma', 'banks', 'IT') are matched to our sector names.

min_turnover_cr optional

Minimum median daily turnover, ₹ crore.

max_age_days optional

Only patterns whose shape completed within this many calendar days (default 120).

sort optional

Recent = newest formation first (default); shape_match / rs re-rank the 200 most recent matches.

limit optional

Max rows (1-50).

The custom setups screen builder: filter ~1,000 liquid stocks on any of 63 nightly price, trend, volume, volatility, strength and base measures.

conditions required

Conditions, all inclusive: [{"key": "rs", "min": 90}, {"key": "chg_3m", "min": 20}]. {"metric", "op", "value"} is also accepted. Useful keys: rs (relative strength 1-99), rs_mom (RS change over a month), chg_1m / chg_3m / chg_6m / chg_1y (% price change), dist_52w_high (% from the 52-week high, <= 0), vs_sma_50 / vs_sma_200 (% above the average), sma50_vs_200, vol_ratio_50 (volume vs 50-day average, x), atr_pct_14 (% daily range), med_turnover_cr (₹ crore/day), dist_pivot_pct, base_weeks, base_depth_pct, contractions, coil, dry. Full list: list_setup_measures.

stage optional

Only stocks in this setups stage.

archetypes optional

Base shapes, any of: vcp, blue_sky, multi_year, ipo_base.

combine optional

And = conditions AND stage/shapes; or = either group.

sort optional

Measure key to rank by (default rs).

descending optional

Highest first (default).

limit optional

Max rows (1-50).

Every measure screen_setups_custom can filter on: key, unit and meaning.

group optional

Only this group; omit for all 63.

One stock's base/breakout position, written out in plain English.

symbol required

NSE symbol, e.g. CUPID. Case-insensitive.

Every chart pattern live on one stock right now, in plain words.

symbol required

NSE symbol, e.g. CUPID. Case-insensitive.

include_resolved optional

Also list patterns that failed, broke or finished recently.

recent_days optional

A triggered pattern older than this is treated as history, not live (default 90 days).

Every base one stock has formed since 2020, and how each one resolved.

symbol required

NSE symbol, e.g. CUPID.

What a chart pattern is, how DocStoX detects it, and how past cases went.

pattern_type required

Pattern to explain: vcp (volatility contraction), double_bottom, double_top, support_breakdown, blue_sky (base at the highest price since 2020), ipo_base, multi_year, and the one-day events high_52w, low_52w, nr4, nr7, inside_day. Loose names accepted.

horizon optional

Window after the trigger over which past outcomes were measured: 1m, 3m (default) or 6m.

What changed in the base/breakout universe at the last close.

date optional

Run date YYYY-MM-DD; omit for the latest close.

kind optional

Only this kind of change.

limit optional

Max rows (1-50).

Stocks that cleared their pivot in the last few sessions.

days optional

Sessions to look back (1-30).

limit optional

Max rows to return (1-50).

NSE industries in the setups universe, or one industry in depth.

industry optional

Industry name or slug, e.g. 'Pharmaceuticals & Biotechnology' or 'auto-components'. Omit for the list of all industries.

sector optional

List mode only: keep industries whose sector contains this text.

limit optional

Max member stocks in detail mode (1-50).

All thematic baskets with performance, breadth, momentum and valuation.

state optional

Theme state: Trending, Cooling, Weak or Turning Around (capitalised). Omit for all.

sort_by optional

Ranking key, highest first: momentum_score, ret_1m, ret_3m, ret_6m, ret_1y (cap-weighted returns, %), rs_3m (relative strength), breadth (% of members above 200-DMA) or n_members.

limit optional

Max themes to return (1-60).

Constituents of one theme, heaviest weight first, with live metrics.

theme_slug required

Theme slug from get_themes(), e.g. 'defence'.

limit optional

Max members, heaviest weight first (1-200).

Which themes a stock belongs to (reverse lookup), with each theme's state.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

Factor-scored sector ranking for rotation analysis.

sort_by optional

Ranking key, highest first: overall, momentum, relative_strength, earnings, valuation (higher = cheaper), institutional, ret_1m, ret_3m, ret_12m.

Today's AI market brief + the current market-regime read.

brief_date optional

ISO date YYYY-MM-DD.

Latest Indian stock-market news, AI-enriched with sentiment + impact score.

symbol optional

NSE symbol to scope results to. Omit for market-wide.

category optional

News category: company, global_macro, markets, sector, ipo, commodity or forex. Omit for all categories.

limit optional

Max rows to return (1-100).

News for a macro category, ranked by impact + recency.

category required

News category: global_macro, markets, commodity, forex, sector, ipo or company.

days optional

Lookback window in days (1-365).

limit optional

Max rows to return (1-100).

Company news for one stock, optionally filtered by topic.

symbol required

NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.

topic optional

Topic tag: corporate_action, results, orders_deals or earnings. Tagged on ~36% of articles; omit for all.

days optional

Lookback window in days (1-365).

limit optional

Max rows to return (1-100).

sort optional

Ordering. 'material' (default) ranks by what actually moves the stock: 0.60*impact_score + 0.25*recency (exp decay, 36h) + 0.15*source editorial signal, and applies a materiality floor of impact_score >= 4, which hides routine exchange filings such as auditor changes and meeting notices. 'latest' is strict newest-first with NO floor and returns everything, including procedural filings and not-yet-scored articles; it suits 'what was filed/published today' and checking that nothing is hidden.

Top news for up to 40 symbols in one call, grouped by symbol.

symbols required

NSE symbols, up to 40 per call.

days optional

Lookback window in days (1-365).

min_impact optional

Minimum impact score 0-10. >=5 is materially market-moving.

per_symbol optional

Max articles per symbol (1-10).

The highest-impact, market-moving news across all categories: the "what's moving the market right now" feed (impact_score >= 5, newest first).

days optional

Lookback window in days (1-30).

limit optional

Max articles to return (1-100).

The news search: one composable tool covering every news question.

symbols optional

NSE symbols; matches an article mentioning any of them.

sector optional

Sector name, e.g. 'Information Technology'. Case-insensitive.

category optional

News category: company, global_macro, markets, sector, ipo, commodity or forex. Omit for all categories.

event_type optional

Structured event tag. The only machine-readable way to find order wins (ORDER_WIN) and capacity expansion (CAPEX_EXPANSION). Present on ~2% of articles.

topic optional

Topic tag: corporate_action, results, orders_deals or earnings. Tagged on ~36% of articles; omit for all.

sentiment optional

Article sentiment: positive, negative or neutral. Omit for all.

min_impact optional

Minimum impact score 0-10. >=5 is materially market-moving.

market_session optional

When the article was published relative to NSE hours: regular, after_hours, pre_market or weekend. Omit for all.

exclude_rumors optional

True drops articles the pipeline flagged as rumour or speculation.

query optional

Substring match on title/summary.

days optional

Lookback window in days (1-365).

date_from optional

ISO date YYYY-MM-DD.

date_to optional

ISO date YYYY-MM-DD.

sort_by optional

Impact = impact score with a recency decay (default); recent = newest first; sentiment = most positive first.

limit optional

Max rows to return (1-100).

Earnings / results news (highest-impact first), optionally scoped to one stock. Use for "how did the market react to <Company>'s results" or "this week's big earnings movers".

symbol optional

NSE symbol to scope results to. Omit for market-wide.

days optional

Lookback window in days (1-365).

limit optional

Max rows to return (1-100).

High-impact news joined to the stock's actual price reaction.

days optional

Lookback window in days (1-30).

min_impact optional

Minimum impact score 0-10.

direction optional

Up = price rose since publication; down = fell. Omit for both.

limit optional

Max rows to return (1-100).

News published while the market was closed, with expected reopen impact.

direction optional

Expected reopen direction.

min_impact optional

Minimum impact score 0-10.

limit optional

Max rows to return (1-100).

Company and market events (results, deals, policy moves, board meetings), each verified across news sources, so fact is separated from commentary.

symbol optional

NSE symbol to scope results to. Omit for market-wide.

event_type optional

Structured event tag (upper-case): MANAGEMENT_CHANGE, EARNINGS, REGULATORY, FUNDRAISING, ORDER_WIN, MA_DEAL, DIVIDEND, CAPEX_EXPANSION. Omit for all.

verification_status optional

Exact verification level, strongest first: Verified > Corroborated > Reported > Unverified. Omit for all.

min_corroboration optional

Minimum independent sources reporting the event.

multi_company_only optional

Only events touching more than one company.

include_scheduled optional

Also return FUTURE-dated events (board meetings, results dates). Rows are tagged timing=occurred|scheduled.

days optional

Lookback window in days (1-365).

limit optional

Max events to return (1-100).

Causal 'ripple' analysis of a market event: the Event Impact Graph.

event_text required

The event or headline in plain English, e.g. 'RBI cuts repo rate by 50bps' or 'crude oil spikes past $95'.

Browse pre-computed causal impact graphs (event → sectors → stocks).

symbol optional

NSE symbol to scope results to. Omit for market-wide.

sector optional

Sector name, e.g. 'Information Technology'. Case-insensitive.

days optional

Lookback window in days (1-365).

limit optional

Max graphs to return (1-50).

Today's market snapshot: FII/DII net flows, index PE/PB, market breadth.

Daily FII and DII net buy/sell flows in cash market (₹ crore).

days optional

Number of most recent trading sessions to return (1-365), newest first.

include_derivatives optional

True adds the NSE participant-wise F&O open interest (participant_oi) for each session.

Comprehensive FII/DII analysis with streaks, velocity, and summary stats.

days optional

Number of most recent trading sessions to analyse (1-365).

FPI sector-wise AUM from NSDL with fortnight change and 6-month flow.

Historical P/E, P/B and dividend yield (%) for an NSE index, with the index close. History starts 2026-06-18.

index_name optional

NSE index name, exactly as listed.

days optional

Number of most recent daily readings to return (1-1000), newest first.

Constituents of an NSE index with the latest session's price change.

index_name optional

NSE index whose current constituents to return, exactly as listed.

Bulk and block deals: client name, quantity, price, and total value.

days optional

Lookback window in calendar days (1-90).

deal_type optional

BULK = >0.5% of equity in a day; BLOCK = negotiated single trade.

symbol optional

NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.

Stocks with the highest delivery percentage in the latest NSE session.

min_delivery_pct optional

Minimum delivery percentage of traded volume (0-100). Example: 60.

limit optional

Max rows to return (1-100).

Current F&O ban list: stocks in ban or approaching ban (OI > 80% of MWPL).

Current and upcoming IPOs with price band, dates, and subscription data.

status optional

IPO lifecycle stage.

One-shot options snapshot for an index or F&O stock: spot, max-pain, PCR (OI & volume), ATM implied volatility (atm_iv as a fraction, atm_iv_pct in percent), net GEX + gamma-flip, top call/put OI walls (resistance / support) and a plain-English read of which side option writers dominate. Suited to 'why is <index> stuck / moving' questions. Live during market hours, else the latest end-of-day snapshot (snapshot_date).

symbol required

F&O underlying. Index options: NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, NIFTYNXT50 (NSE) and SENSEX, BANKEX (BSE). Stock options use the NSE symbol, e.g. RELIANCE.

expiry optional

Option expiry date as YYYY-MM-DD, e.g. '2026-10-06'. Omit for the nearest expiry on or after today (IST); an expiry that has already settled is never picked by default.

Compact option chain: ATM ± N strikes with CE/PE last price, OI, OI change, implied volatility (fraction: 0.14 = 14%) and delta.

symbol required

F&O underlying. Index options: NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, NIFTYNXT50 (NSE) and SENSEX, BANKEX (BSE). Stock options use the NSE symbol, e.g. RELIANCE.

expiry optional

Option expiry date as YYYY-MM-DD, e.g. '2026-10-06'. Omit for the nearest expiry on or after today (IST); an expiry that has already settled is never picked by default.

around_atm optional

Strikes to include on EACH side of the at-the-money strike (1-20); 6 returns 13 strikes.

Daily max-pain / PCR / spot series (nearest unexpired expiry each day): where option writers anchor, and whether spot drifts toward or away from max-pain.

symbol required

F&O underlying. Index options: NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, NIFTYNXT50 (NSE) and SENSEX, BANKEX (BSE). Stock options use the NSE symbol, e.g. RELIANCE.

days optional

Calendar days of daily history (1-365).

Per-strike OI-buildup quadrants (long buildup, short buildup, short covering, long unwinding) for the latest end-of-day snapshot, with counts and the most-active strikes.

symbol required

F&O underlying. Index options: NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, NIFTYNXT50 (NSE) and SENSEX, BANKEX (BSE). Stock options use the NSE symbol, e.g. RELIANCE.

expiry optional

Option expiry date as YYYY-MM-DD, e.g. '2026-10-06'. Omit for the nearest expiry on or after today (IST); an expiry that has already settled is never picked by default.

Put-Call Ratio (OI & volume) daily trend, with the latest value, min/max, rising/falling read and a bullish/bearish/neutral bias label.

symbol required

F&O underlying. Index options: NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, NIFTYNXT50 (NSE) and SENSEX, BANKEX (BSE). Stock options use the NSE symbol, e.g. RELIANCE.

days optional

Calendar days of daily history (1-365).

Gamma exposure: net GEX (₹ per 1% spot move, with a ₹ crore convenience field), gamma-flip level, and the largest positive / negative per-strike GEX clusters. GEX > 0 = dealers long gamma (pinning, mean-reverting); GEX < 0 = short gamma (moves amplified).

symbol required

F&O underlying. Index options: NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, NIFTYNXT50 (NSE) and SENSEX, BANKEX (BSE). Stock options use the NSE symbol, e.g. RELIANCE.

expiry optional

Option expiry date as YYYY-MM-DD, e.g. '2026-10-06'. Omit for the nearest expiry on or after today (IST); an expiry that has already settled is never picked by default.

FII derivatives positioning from NSE participant-wise open interest: index-futures long/short contracts with a net-long/short read, total F&O long minus short (in CONTRACTS, not rupees), the full participant OI breakdown, and the cash-market net flow (₹ crore) alongside.

days optional

Calendar days of daily history (1-365).

India VIX (NIFTY implied-volatility index) end-of-day series and latest reading, with 1-day change and 5-/20-session change in points.

days optional

Calendar days of daily closes in series (1-3650). The 5- and 20-session trends are computed independently of this window.

The caller's own real DocStoX portfolio (their default portfolio's actual stored holdings): not a quote lookup for arbitrary symbols. No params needed; the caller is identified from their API key / OAuth sign-in.

The caller's own real DocStoX watchlist (their default watchlist's actual stored symbols): not a quote lookup for arbitrary symbols. No params needed; the caller is identified from their API key / OAuth sign-in.

watchlist_id optional

Specific watchlist id. Omit for the default one.