Discovery & prices

read_meFree

Read Me

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.

Takes no parameters.

search_stocksFree

Search stocks

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

queryrequired

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

sectoroptional

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

limitoptional

Max rows to return (1-50).

get_trending_stocksFree

Get trending stocks

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

categoryoptional

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).

limitoptional

Max rows to return (1-100).

get_stock_quoteFree

Get stock quote

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

symbolrequired

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

get_batch_quotesFree

Get batch quotes

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

symbolsrequired

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

get_price_historyFree

Get price history

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.

symbolrequired

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

daysoptional

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

exchangeoptional

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

adjustedoptional

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.

get_global_marketsFree

Get global markets

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

groupoptional

Restrict to one section; omit for the whole board

itemoptional

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

history_daysoptional

Daily session closes for ONE item (needs item)