Questions
Questions DalalOS can answer
DalalOS connects an AI assistant such as Claude or ChatGPT to Indian stock market data through an MCP server (the standard AI apps use to read data from other services). Ask in your own words and the assistant picks from the 69 tools below. A tool is one thing it can do, mostly looking something up. Answers about market data come with their source and date.
What the tools do
62 of the 69 tools only read data. 2 save or remove a stock on your own DalalOS watchlist. 1 sends a report to the team, only when you ask or agree. 4 start background work on company filings. None places a trade.
Prices are end of day, not live. How fresh is the data?
Facts, not tips
Find companies
Look a company up, or list every company in an index.
EXAMPLE PROMPTS
- What is the NSE symbol and BSE code for Tata Motors?
- List every stock in the NIFTY IT index.
- Show me a heatmap of NIFTY 50 with 1-month and 1-year returns.
Find a company from its name, symbol or code.
Readssearch_stocksFind a company by name, symbol, BSE code or ISIN
USE WHEN
Resolve a company from a name, ticker, BSE code or ISIN before asking anything else — usually the first tool your assistant calls.
PARAMETERS
search_stocks parameters Name Type Required Default Description querystringYes — Company name, NSE symbol, BSE code or ISIN. Typos are tolerated. limitintegerNo 10 Max results, clamped 1–50. RESPONSE DATA
- A list of matches: isin, company_id, name, nse_symbol, bse_code, sector, industry, company_type.
NOTES
- Resolution order: exact ISIN → exact NSE symbol → exact BSE code → fuzzy match → typo suggestion (reason_code: "typo_suggestion").
Also available via REST:EXAMPLE PROMPTS
- Find the ISIN for a stock called 'Infy' — I don't know the exact ticker.
/searchFull detailsFilter all listed companies by measures such as valuation (price compared with profit), debt or ownership.
Readsscreen_stocksFilter the entire market by valuation, quality and ownership metrics
USE WHEN
The screener: combine PE, ROE, debt, promoter holding, sector and 20+ other filters across thousands of NSE/BSE stocks.
PARAMETERS
screen_stocks parameters Name Type Required Default Description filtersobjectYes — Range filters (a metric name ending in _min or _max, e.g. pe_min, roe_max) plus exact filters: sector, industry, igroup, isubgroup, company_type (general, bank, nbfc or insurer), index and is_sme. Units depend on the metric: fractions for ROE-style ratios, percentages for promoter_pct and similar, rupees for market_cap and price. sort_bystringNo market_cap Field to sort results by. orderstringNo desc "asc" or "desc". limitintegerNo 25 Max rows, 1 to 100. RESPONSE DATA
- results — rows shaped like a quote+ratios row, each flagged if a value looks structurally off.
- match_count, total_scanned, truncated (whether the scan was capped).
NOTES
- An exact filter name is matched whatever the case. A name that is not recognised returns the closest valid names (reason_code "unrecognised_name") in place of an empty result.
- A security with no value for a filtered metric is left out and counted in excluded_missing_metric; margin, debt and enterprise-value metrics have no value for banks, NBFCs and insurers.
- Fraction-based metrics (ROE, ROA, ROCE, net margin, dividend/earnings/FCF yield) must be passed as fractions — 0.15, not 15. A bare percentage is rejected with a clear error rather than silently misfiltering.
Also available via REST:EXAMPLE PROMPTS
- Find IT-sector stocks with ROE over 20% and PE under 30.
/screenFull detailsSee how a whole sector is priced against profit and net assets, and its dividends.
Readsget_sector_overviewSector or industry aggregates — median PE, PB, dividend yield
USE WHEN
Zoom out from one stock to a whole sector: median valuation and how many companies sit in it.
PARAMETERS
get_sector_overview parameters Name Type Required Default Description sectorstringNo — Omit to list every group at the chosen grain; pass a name at that grain for one group. Matched whatever the case; a name that is not recognised returns the closest valid names. grainstringNo sector "sector" | "igroup" (SEBI industry) | "isubgroup" (SEBI basic industry). RESPONSE DATA
- groups — name, count, total_market_cap, median_pe, mean_pe, median_pb, and (when precomputed) median_dividend_yield / median_return_1y.
Also available via REST:EXAMPLE PROMPTS
- What's the median PE and dividend yield across the banking sector right now?
/sectorsFull detailsList the companies in an index, such as NIFTY 50.
Readslist_index_constituentsEvery member stock of a named index
USE WHEN
All constituents of an index like NIFTY 50 or NIFTY BANK, ranked by market cap.
PARAMETERS
list_index_constituents parameters Name Type Required Default Description indexstringYes — Index name such as NIFTY 50 or BSE SENSEX (a name, not a slug), matched whatever the case. limitintegerNo 100 1 to 500, largest company first. RESPONSE DATA
- constituents — isin, nse_symbol, name, sector, market_cap; sorted by market cap descending.
NOTES
- An unrecognized index name comes back with the closest valid index names. It gives membership only, not index weights.
Also available via REST:EXAMPLE PROMPTS
- List every stock in the NIFTY IT index.
/indices/{index}/constituentsFull detailsSee which indices exist and how many companies each holds.
Readslist_indicesEvery index tracked, with member counts
USE WHEN
See what indices exist before asking for constituents or a heatmap.
PARAMETERS
No parameters.
RESPONSE DATA
- indices — every distinct index name with its member count.
Also available via REST:EXAMPLE PROMPTS
- What indices do you track, and how many stocks are in each?
/indicesFull detailsSee how every company in an index moved over a day, a month or a year.
Readsget_market_heatmapIndex constituents with multi-horizon returns
USE WHEN
See how every stock in an index has moved over 1 day to 1 year, side by side.
PARAMETERS
get_market_heatmap parameters Name Type Required Default Description indexstringYes — Index name such as NIFTY 50 or BSE SENSEX (a name, not a slug), matched whatever the case. A name that is not recognised returns the valid ones. limitintegerNo 100 1 to 500, largest company first. RESPONSE DATA
- constituents — market_cap, pe, pb, and precomputed returns (1d/1w/1m/3m/6m/1y) with return_flags for structural events.
NOTES
- Deliberately sortable only by market cap — never by return — so this can't read as a "top movers" ranking.
Also available via REST:EXAMPLE PROMPTS
- Show me a heatmap of NIFTY 50 with 1-month and 1-year returns.
/indices/{index}/heatmapFull detailsSee ready-made filters, such as shares priced low against profit, refreshed overnight.
Readslist_preset_screensThe fixed, nightly-precomputed screens
USE WHEN
Ready-made screens like "low PE" or "high dividend yield, large cap" that refresh overnight — instant, no live computation.
PARAMETERS
No parameters.
RESPONSE DATA
- presets — name, description, computed_at, stale.
NOTES
- The names are low_price_to_earnings, high_dividend_yield_large_market_cap, low_leverage_high_roe, high_promoter_holding_low_pledge and high_growth_latest_results. For your own conditions use screen_stocks.
Also available via REST:EXAMPLE PROMPTS
- What preset screens are available?
/presetsFull detailsGet the latest results of one ready-made filter.
Readsrun_preset_screenRun one of the fixed preset screens
USE WHEN
The latest results for a named preset (e.g. "low_leverage_high_roe") — precomputed overnight, never live.
PARAMETERS
run_preset_screen parameters Name Type Required Default Description namestringYes — Must match a name returned by list_preset_screens. RESPONSE DATA
- The stored screen_stocks-shaped result for that preset, verbatim: up to 50 rows, the filters it applied and the number of matches.
NOTES
- For more rows or other thresholds, pass the returned filters to screen_stocks.
- An uncomputed preset returns success with reason_code "no_data" rather than an error.
Also available via REST:EXAMPLE PROMPTS
- Show me the results of the high-dividend-yield, large-cap preset screen.
/presets/{name}Full detailsFilter companies with a rule you write, such as profit above a level and debt below one.
Readsscreen_by_queryScreen companies with a numerical query expression
USE WHEN
Evaluate user-defined numerical conditions, including OR and arithmetic, against the cached company metrics.
PARAMETERS
screen_by_query parameters Name Type Required Default Description querystringYes — One expression of metric names, numbers, comparisons (= != > < >= <=), AND, OR, brackets, + - * / and the functions COALESCE, IF, LEAST, POWER, ABS, SQRT and LOG. It has no text values; restrict by name with scope. dialectstringNo screener "screener" (common screener names, percentages written as 22%, market cap in crore) or "dalalos" (DalalOS metric ids in stored units: fractions and rupees). sort_bystringNo market_cap Metric id to sort by; missing values sort last. orderstringNo desc asc or desc. limitintegerNo 25 Rows per page, 1 to 100. offsetintegerNo 0 Pagination offset, at most 5000. snapshot_idinteger | nullNo — Pass pagination.snapshot_id from the first page on later pages for consistent pagination. If a call returns snapshot_expired, start again from offset 0. definitionsobject[] | nullNo — Named ratios to use in the query. columnsstring[] | nullNo — Other metrics to return on each row, beyond the core columns and the metrics the query names. scopeobject | nullNo — Restrict by sector, industry, igroup, isubgroup, company_type or index, such as {"index": "NIFTY 50"}. A name that is not recognised is refused with the closest valid names. only_latest_resultsbooleanNo false Keep only companies that have filed results for the latest quarter most companies have reported. include_condition_countsbooleanNo false Add condition_counts: for each AND-ed condition, how many companies pass it and how many fail only it. only_failing_conditioninteger | nullNo — 0-based index of a condition in condition_counts: returns the companies that fail only that condition. include_row_contextbooleanNo false Add each row's 52-week low and high and the dates of the filings behind it. include_column_scalesbooleanNo false Add the minimum, maximum and 5th and 95th percentile of each numeric column across all matches. RESPONSE DATA
- Matching company rows, pagination snapshot and numerical metric values, including the metrics the query names (referenced_metrics).
NOTES
- Uses cached metrics and preserves unavailable values; screening matches are data rather than recommendations.
- An unknown metric name is an error, never a guess. A comparison with a missing value does not match; wrap the metric in COALESCE to give it a default.
Full detailsEXAMPLE PROMPTS
- Screen companies where PE is below 25 and return on equity exceeds 15%.
Read what a term or ratio means and how it is calculated.
Readsget_glossaryPlain definitions of the terms and ratios DalalOS reports
USE WHEN
Define a term or ratio (P/E, ROE, TTM, gross NPA, promoter pledge) in plain words, with its inputs, unit, period basis and when it is not meaningful.
PARAMETERS
get_glossary parameters Name Type Required Default Description termstring | nullNo — One or more comma-separated keys, such as pe,market_cap. One unknown key fails the call. Omit it to get the index of keys. kindstring | nullNo — metric, line_item, term or section. RESPONSE DATA
- Per entry: plain_description, basis_text (inputs, unit, period basis), applies_to (company types), not_meaningful_when and reviewed_by.
NOTES
- Without term the call returns only the list of keys, so pass term for the definitions.
- A definition says what a term is and how it is calculated; it never says whether a value is good or bad.
Full detailsEXAMPLE PROMPTS
- What does ROCE mean, and how is it calculated?
Quotes & prices
Where a stock closed, how its price has moved and how much of the trading ended in real delivery.
EXAMPLE PROMPTS
- What's Reliance trading at, and where does that sit versus its 52-week range?
- How far is ITC from its 52-week high and low?
- Show daily closing prices for Maruti Suzuki over the last six months.
Get the latest end-of-day price, 52-week high and low, and valuation figures for a stock.
Readsget_stock_quoteLatest end-of-day price, valuation ratios and 52-week range
USE WHEN
The one-stop quote: price, change, PE/PB, 52-week high/low and dividend info for a single stock.
PARAMETERS
get_stock_quote parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. RESPONSE DATA
- price, change, pct_change, day OHLC, prev_close, volume, turnover, market_cap.
- pe, pb, week52_high/low (plus unadjusted variants).
- recent_dividends, upcoming_dividends, dividend_yield.
- valuation_flags / valuation_notes when a ratio looks structurally off (e.g. negative net worth nulls PE/PB).
NOTES
- Prices are end-of-day (NSE bhavcopy) — never a real-time feed.
Also available via REST:EXAMPLE PROMPTS
- What's Reliance trading at, and where does that sit versus its 52-week range?
/stocks/{q}/quoteFull detailsGet quotes for several stocks at once.
Readsget_batch_quotesQuotes for up to 20 stocks in one call
USE WHEN
The same data as get_stock_quote, for a whole watchlist at once — one bad ticker never fails the rest.
PARAMETERS
get_batch_quotes parameters Name Type Required Default Description symbolslist[string]Yes — Up to 20 symbols, ISINs or codes. RESPONSE DATA
- A per-symbol array: query, status, quote, cached_at, error, reason_code.
Also available via REST:EXAMPLE PROMPTS
- Give me quotes for RELIANCE, TCS, HDFCBANK, INFY and ICICIBANK.
/quotesFull detailsSee a stock's opening, high, low and closing prices and volume, by day, week or month.
Readsget_price_historyDaily, weekly or monthly OHLCV bars
USE WHEN
Raw price history for charting or your own return calculations — split/bonus-adjusted on request.
PARAMETERS
get_price_history parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. daysintegerNo 90 Lookback window, clamped 1–1825. adjustedbooleanNo false Rescale pre-event bars for splits/bonuses. intervalstringNo daily "daily" | "weekly" | "monthly". RESPONSE DATA
- bars — date, open, high, low, close, prev_close, volume, turnover, num_trades, deliv_pct.
- count, adjustments_applied.
NOTES
- Auto-coarsens to weekly bars if a daily request would return more than 750 rows (resampled_reason).
Also available via REST:EXAMPLE PROMPTS
- Give me two years of weekly price history for TCS.
/stocks/{q}/price-historyFull detailsSee how a stock's price changed over periods from a week to a year, and its biggest fall from a peak.
Readsget_returnsMechanically-computed returns, volatility and drawdown
USE WHEN
Returns over 1 week to 5 years, year to date and full history, with annualised returns, volatility and max drawdown — computed from the price series, not opinion.
PARAMETERS
get_returns parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. RESPONSE DATA
- returns (1W/1M/3M/6M/1Y/3Y/5Y/YTD/max), cagr, annualized_volatility, max_drawdown, high_52w, low_52w.
NOTES
- There is no period parameter: for another period use get_price_history or get_stock_vs_index. Returns use prices adjusted for splits and bonuses and exclude dividends.
- A window spanning a major corporate action (e.g. a demerger) is nulled rather than reported as a distorted figure.
Also available via REST:EXAMPLE PROMPTS
- What's the 1-year and 3-year return for this stock, and its max drawdown?
/stocks/{q}/returnsFull detailsSee how much of the trading in a stock ended in real delivery of shares.
Readsget_delivery_trendsDelivery-quantity and delivery-% trend
USE WHEN
How much of the traded volume is actually delivered (held), not just churned intraday.
PARAMETERS
get_delivery_trends parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. daysintegerNo 90 Window in days, 1 to 1825, counted back from today. RESPONSE DATA
- series — date, deliv_pct, deliv_qty, volume.
- mean_deliv_pct, latest_deliv_pct, recent_5d_mean.
NOTES
- A long daily series comes back weekly.
Also available via REST:EXAMPLE PROMPTS
- Has delivery percentage in this stock been rising over the last 3 months?
/stocks/{q}/delivery-trendsFull detailsGet chart measures calculated from past prices, such as moving averages.
Readsget_technical_indicatorsMechanically-computed technical indicators
USE WHEN
Read moving averages, RSI, MACD, Bollinger Bands and beta from the cached price series.
PARAMETERS
get_technical_indicators parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. RESPONSE DATA
- Latest values of the moving averages, RSI (14), MACD (12, 26, 9), Bollinger Bands (20, 2) and beta against the Nifty 50. Latest values only, with no history of an indicator.
- circuit_band_pct, circuit_band_as_of, circuit_hit_days — raw/unadjusted-close circuit-filter fields with distinct null reasons.
- insufficient_history — list of indicators skipped because the cached price series was too short.
NOTES
- Indicators are calculations over cached end-of-day prices, not trading signals or recommendations.
Also available via REST:EXAMPLE PROMPTS
- Show the technical indicators for TCS and include the calculation window.
/stocks/{q}/technical-indicatorsFull detailsSee a security's raw daily NSE rows, SME stocks and bonds included, with delivery.
Readsget_security_historyRaw daily NSE rows for any security, SME and bonds included
USE WHEN
Read NSE's daily bhavcopy rows for one security in any series it trades in, including SME stocks, bonds, G-secs, SGBs and fund units, with delivery and trade counts.
PARAMETERS
get_security_history parameters Name Type Required Default Description symbolstringYes — NSE symbol or ISIN. seriesstring | nullNo — One series, such as EQ, BE, SM or GB. daysinteger | nullNo 30 Days back from the newest stored day, up to 1825. from_datedate | nullNo — Optional ISO start date. to_datedate | nullNo — Optional ISO end date. RESPONSE DATA
- Per day: open, high, low, close, last, prev_close, volume, turnover, trades, delivery quantity and delivery %.
NOTES
- Prices are as NSE published them that day, not adjusted for splits or bonus issues (adjusted: false). Use get_price_history for an adjusted series.
Full detailsEXAMPLE PROMPTS
- Show the last 30 days of NSE trading for an SME stock, with delivery percentage.
See a stock's return beside an index's over the same period.
Readsget_stock_vs_indexOne stock's return beside an NSE index
USE WHEN
Put one stock's price return beside an NSE index's over the same window, with volatility, maximum drawdown, the largest daily rise and fall, and the difference in percentage points.
PARAMETERS
get_stock_vs_index parameters Name Type Required Default Description symbolstringYes — NSE equity symbol. indexstringNo Nifty 50 NSE index name, such as Nifty Bank or Nifty IT. daysinteger | nullNo 365 Window in days, up to 1825. from_datedate | nullNo — Optional ISO start date. to_datedate | nullNo — Optional ISO end date. RESPONSE DATA
- Each side's return %, annualised volatility, maximum drawdown, best and worst day, and difference_pct (stock minus index, percentage points).
NOTES
- The stock's return compounds NSE's own close/prev_close, so splits and bonuses do not break it. Price returns, no dividends.
Full detailsEXAMPLE PROMPTS
- How has Tata Motors done against the Nifty 50 over the last year?
Financials & ratios
What a company sold, earned and owes, as it reported.
EXAMPLE PROMPTS
- Show quarterly sales and net profit for Hindustan Unilever for the last 8 quarters.
- Show the year-on-year change in sales and net profit for the last four quarters of Havells.
- Build a source-linked report for Infosys from the last 90 days of disclosures.
See a company's quarterly or yearly sales, profit, debt and ratios.
Readsget_financialsQuarterly or annual P&L, balance sheet and computed ratios
USE WHEN
Revenue, margins, ROE/ROCE and debt ratios pulled from SEBI BSE-XBRL filings — adapted automatically for banks, NBFCs and insurers.
PARAMETERS
get_financials parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. period_typestringNo quarterly "quarterly" | "annual". limitintegerNo 8 Number of periods, newest first, 1 to 20. RESPONSE DATA
- periods — income, balance_sheet, ratios (margins, or asset-quality for banks/NBFCs), optional cash_flow (annual only, incl. free_cash_flow).
- ttm — trailing-twelve-month figures.
- growth — YoY and 3y/5y CAGR per metric, with base-effect and demerger caveats.
- Per period: net_income_owners (profit attributable to owners), source_document_url, and other_income_step_change when other income jumps.
- Per period, general companies: pretax_income_after_associates (the profit before tax most results print), ebit_ex_other_income (operating profit before other income, after depreciation), ebitda_ex_other_income, ebitda_before_exceptional, depreciation and share_of_associates.
- Per quarter: document_check — whether the company's own results statement confirms the filed figures, with the document link. Where the statement adds up and the exchange data fails its own checks, the statement's figure is shown with the exchange value beside it.
- definitions (what each figure measures; ebitda includes other income, net_income is group profit) and freshness (whether this is the newest period filed, and when the source was last checked).
NOTES
- Company-type aware: banks/NBFCs surface NII and GNPA/NNPA instead of a generic P&L; insurers surface premium income.
- Quarterly periods carry no cash flow and the balance sheet is filed half-yearly, so use period_type annual for cash flow. The trailing-twelve-month block comes only with quarterly periods.
Also available via REST:EXAMPLE PROMPTS
- Show me TCS revenue, margins, ROCE and debt-to-equity for the last 5 years.
/stocks/{q}/financialsFull detailsSee whether sales and profit margins are rising or falling, quarter by quarter or year by year.
Readsget_financial_trendsQuarter-over-quarter or year-over-year deltas, not just levels
USE WHEN
See the direction of travel — margin expansion or contraction, revenue and free-cash-flow growth.
PARAMETERS
get_financial_trends parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. period_typestringNo quarterly "quarterly" | "annual". limitintegerNo 8 Number of periods, newest first, 1 to 20. RESPONSE DATA
- periods — QoQ (quarterly) or YoY (annual) deltas, net_margin_delta, fcf_growth.
- Quarterly year-on-year changes use the year-ago figure as restated in the company's latest results statement where it differs (yoy_base: restated_in_latest_filing), with prior_as_filed beside it.
- revenue_cagr, net_income_cagr, fcf_cagr over the requested window.
Also available via REST:EXAMPLE PROMPTS
- Is this company's net margin expanding or contracting quarter over quarter?
/stocks/{q}/financial-trendsFull detailsGet one summary of a company: who it is, its price and its latest results.
Readsget_company_profileOne-call company snapshot: identity, market data and fundamentals
USE WHEN
A single roll-up of who a company is, what it trades at, and its latest fundamentals, in one call.
PARAMETERS
get_company_profile parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. RESPONSE DATA
- identity — sector, industry, indices, face value, listing date, company_type.
- market — price, pe, pb, market_cap, week52 range (null if no quote cached).
- fundamentals — latest-period and TTM headline figures and margins (null if none cached), fundamentals_available flag.
NOTES
- Assembled purely from cache — no new upstream fetch — so it's fast and always consistent with the other tools.
Also available via REST:EXAMPLE PROMPTS
- Give me a quick profile of Asian Paints — sector, current valuation, and latest margins.
/stocks/{q}/profileFull detailsRead a company's reported figures on energy, water, waste, emissions and staff (its sustainability report, BRSR).
Readsget_brsrRaw BRSR sustainability disclosures
USE WHEN
Read reported emissions, energy, water, waste, workforce and other BRSR figures from company filings.
PARAMETERS
get_brsr parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. yearsintegerNo 3 Lookback window, clamped 1–10. include_rawbooleanNo false Include additional raw filing fields. RESPONSE DATA
- Reported BRSR metrics, filing period, source and extraction metadata.
NOTES
- Raw disclosures only — no ESG score or rating is produced.
- Coverage starts only from whenever the nightly refresh job began ingesting that company's BRSR filings, not from its first-ever filed BRSR.
Also available via REST:EXAMPLE PROMPTS
- Show the latest BRSR energy and emissions figures for Reliance.
/stocks/{q}/brsrFull detailsSee the business figures a company chooses to report, over time.
Readsget_company_operating_metricsSource-grounded operating KPI history
USE WHEN
Read company-disclosed operating KPIs over time, preserving what was disclosed and what was not rather than filling gaps with inference.
PARAMETERS
get_company_operating_metrics parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. metricslist[string]No — Optional list from order_book, order_inflow, execution_period, working_capital_days_change, capacity, installed_capacity, planned_capacity, power_capacity, utilisation, commissioning_date, announced_capex, capex_spent, remaining_capex, store_count, inventory, aum, disbursements, net_interest_margin, casa_ratio and average_interest_earning_assets; the default is all. from_datedateNo — Optional ISO start date. to_datedateNo — Optional ISO end date. latest_onlybooleanNo false Return only the latest observation per requested metric. limitintegerNo 100 Maximum observations, at most 100, applied across metrics in alphabetical order, so name the metrics you need. RESPONSE DATA
- Reported operating-metric observations with metric key/value or text, unit, as-of/disclosure dates, source evidence and coverage status.
NOTES
- Coverage distinguishes disclosed values from not-disclosed fields; DalalOS does not infer a current KPI from a related announcement.
Full detailsEXAMPLE PROMPTS
- Show the latest disclosed operating metrics for this company and their source context.
Get one report on a company that links each figure to its source.
Readsget_company_reportCanonical source-linked company research report
USE WHEN
Assemble one validated company report from sourced facts, mechanical calculations, evidence-referenced claims, recent events and explicit coverage gaps.
PARAMETERS
get_company_report parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. daysintegerNo 90 Disclosure/reporting window, clamped 1–365. detailstringNo compact "compact" leaves out older trend periods, quotes and audit hashes; "full" returns everything. sectionsstring[]No — Section ids to return in full, e.g. quarterly_performance or ownership; an unknown id returns the valid ids. Cannot be combined with detail=full. RESPONSE DATA
- definitions and freshness: what each quoted figure measures, and whether it is the newest period the company has filed.
- company_report_v1 — company identity, source-linked facts/citations, mechanically-computed calculations, evidence-referenced claims, materiality-bucketed events and coverage gaps.
NOTES
- The default over MCP is a compact report: the latest three quarters and two years, material events in full and routine filings as a line each. detail=full is too large for most clients to read.
- Read-only and source-linked: every numeric claim references supporting evidence/calculation, and the validator rejects target-price or buy/sell language.
- This is DalalOS's consolidated report contract; similarly named tools from another connected server are separate sources.
Full detailsEXAMPLE PROMPTS
- Build a source-linked company report for RELIANCE using the last 90 days of relevant disclosures.
See how a company's price compared with its profit and sales over time.
Readsget_valuation_historyPoint-in-time P/E and price-to-sales history
USE WHEN
Read historical valuation points using only filings that were public on each trade date, so later results are not back-applied to earlier dates.
PARAMETERS
get_valuation_history parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. daysintegerNo 365 Lookback window, clamped 1–1825. intervalstringNo daily daily | weekly | monthly. RESPONSE DATA
- Points with date, close, P/E, price-to-sales and the financial-period/filed-at basis used for that date, plus count/truncation metadata.
NOTES
- Daily output auto-coarsens to weekly if it would exceed 750 points.
- Each valuation point uses the latest TTM filing that was public on that trade date; no look-ahead filing data is applied.
Full detailsEXAMPLE PROMPTS
- Show five years of monthly point-in-time valuation history for TCS.
Peer comparison
How a company sits next to others in its line of business.
EXAMPLE PROMPTS
- Find operating peers for Titan and explain why each is included.
- Which companies are the closest peers of Zomato by business?
Compare a company with others in the same industry on valuation and profit.
Readsget_peer_comparisonAuto-selected peer group with valuation & profitability medians
USE WHEN
Compare a company against its actual industry peers — sized and grouped automatically, not a hand-picked watchlist.
PARAMETERS
get_peer_comparison parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. limitintegerNo 8 Max peers, capped at 15. RESPONSE DATA
- peers — market_cap, price, pe, pb, revenue_ttm, net_income_ttm, net_margin, roe/roa/roce, ev multiples, price-to-fcf, debt_to_equity, is_query.
- peer_medians — pe, pb, net_margin, roe.
- grain, grain_value, grain_widened, size_banded, peer_count.
NOTES
- Peers are picked by SEBI industry classification (isubgroup, widening to igroup if fewer than 4 peers) within a 0.1x–10x market-cap band.
Also available via REST:EXAMPLE PROMPTS
- Compare HDFC Bank against its peers on PE, PB and ROE.
/stocks/{q}/peersFull detailsFind similar companies to compare with, and why each was picked.
Readsget_relevant_peersPurpose-specific, explainable peer selection
USE WHEN
Choose a smaller evidence-backed peer set for operating, financial or valuation comparison instead of relying only on broad industry membership.
PARAMETERS
get_relevant_peers parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. purposestringNo operating operating | financial | valuation. event_contextstringNo — Optional public event/context text used only as declared comparison context. limitintegerNo 8 Peer count, clamped 1–15. RESPONSE DATA
- Selected peers with company/market fields, comparison metrics, business-tag evidence and explainable inclusion/override context for the chosen purpose.
NOTES
- Insufficient reviewed evidence returns fewer peers rather than silently broadening a thin peer group into a claimed operating peer set.
- Use get_peer_comparison for the broader automatic sector/industry comparison table.
Full detailsEXAMPLE PROMPTS
- Find the most relevant operating peers for this company and explain why each peer belongs.
Who owns a company
Who holds a company's shares: promoters (the controlling shareholders), foreign institutions (FII), domestic institutions (DII) and the public. Also which commodity, currency and rate changes a company is linked to.
EXAMPLE PROMPTS
- Show quarterly promoter, FII and DII holding for Zomato.
- Show the quarterly promoter pledge percentage for Vedanta.
- Which reviewed currency exposures are documented for Tata Motors?
See how much of the promoters' stake is pledged against loans, over time.
Readsget_pledge_trendPromoter share-pledge percentage over time
USE WHEN
How much of the promoter's stake is pledged against loans, quarter by quarter, and whether that share is rising or falling — reported as filed.
PARAMETERS
get_pledge_trend parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. limitintegerNo 12 Number of quarters, clamped ≤16. RESPONSE DATA
- periods — period_end, promoter_pct, pledged_pct (share of the promoter holding), pledged_pct_of_total_shares, pledged_shares, locked_in_pct, voting_rights_pct.
- latest_pledged_pct, pledge_change_vs_prev, definitions, freshness.
Also available via REST:EXAMPLE PROMPTS
- Is promoter pledge in this company rising or falling?
/stocks/{q}/pledge-trendFull detailsSee which commodity, currency or interest-rate changes a company's business is linked to, with the evidence.
Readsget_company_exposuresReviewed company exposures to macro factors
USE WHEN
Read the company's reviewed, source-grounded exposure pathways to factors such as commodities, currencies or rates — evidence only, not a causal forecast.
PARAMETERS
get_company_exposures parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. RESPONSE DATA
- Reviewed exposures with factor key/label/dimension, directness, direction, lag, mechanism, sensitivity, mitigants/scope and source evidence where recorded.
NOTES
- This is the plain evidence listing. Use get_company_macro_exposures when you also need eligibility against supported official macro windows.
- No reviewed exposure returns an empty success result; DalalOS does not infer an exposure from sector membership or price movement.
Full detailsEXAMPLE PROMPTS
- What reviewed macro-factor exposures are documented for this company?
See shares that promoters and directors disclosed buying, selling or pledging.
Readsget_insider_tradesDisclosed insider trades by promoters and directors
USE WHEN
Read the buys, sells and pledges that promoters, directors, key managers and designated persons disclosed under SEBI's insider-trading rules, market-wide or for one company.
PARAMETERS
get_insider_trades parameters Name Type Required Default Description symbolstring | nullNo — NSE symbol, ISIN or BSE code; omit for the whole market. daysintegerNo 30 Trade-date window back from today, 1 to 365. from_datedate | nullNo — Optional ISO start of the trade-date window. to_datedate | nullNo — Optional ISO end of the trade-date window. categorystringNo promoters promoters | directors_kmp | designated | relatives | all. sidestringNo trades trades (buys and sells) | buy | sell | pledge | all. min_value_inrnumber | nullNo — Drop trades smaller than this value in rupees. include_derivativesbooleanNo false Include derivative trades; equity only by default. group_bystringNo trade trade (newest first) | company (buy, sell and net value per company). limitintegerNo 100 1 to 500 rows. RESPONSE DATA
- Trades with the person's category, side, quantity, value, trade date and mode, or per-company buy, sell and net value, plus a coverage_note.
NOTES
- Sources, both from BSE: System-Driven Disclosures (published 7 to 14 days after the trade) and company Form C (next day). A trade in both is counted once.
- The latest two weeks fill in as reports arrive. Disclosed facts only, with no view on why anyone traded. For bulk and block deals use get_bulk_block_deals.
Full detailsEXAMPLE PROMPTS
- Have the promoters of Adani Ports bought or sold shares in the last 30 days?
Announcements & events
What companies tell the exchanges, and what is coming up: results, dividends, splits and IPOs (a company's first sale of shares to the public).
EXAMPLE PROMPTS
- Which companies are announcing results in the next two weeks?
- List ITC's dividends per share for the last five financial years.
- Which Indian IPOs are upcoming or currently open?
See every dividend a company has paid, and what it is as a share of the latest price.
Readsget_dividendsDividend history, trailing yield and payout ratio
USE WHEN
Every cash dividend a company has paid, plus trailing yield and payout ratio against the latest price.
PARAMETERS
get_dividends parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. yearsintegerNo 5 Lookback window in years, 1 to 15. RESPONSE DATA
- dividends — ex_date, type, amount, record_date, payment_date.
- annual_totals, trailing_12m_dividend, dividend_yield, payout_ratio.
NOTES
- A dividend declared only as % of face value (not ₹) is marked amount_unavailable rather than guessed.
Also available via REST:EXAMPLE PROMPTS
- What dividends has Infosys paid over the last 5 years, and what's the trailing yield?
/stocks/{q}/dividendsFull detailsSee splits, bonus shares (free extra shares), buybacks and mergers in one timeline.
Readsget_corporate_actionsFull corporate-action timeline: splits, bonuses, buybacks, mergers
USE WHEN
Every disclosed corporate action in one timeline, not just dividends — useful for understanding a jump in the price series.
PARAMETERS
get_corporate_actions parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. yearsintegerNo 5 Lookback window in years, 1 to 20. typeslist[string]No — Filter to a list from dividend, bonus, split, consolidation, rights, buyback, demerger, spinoff, merger, distribution and other. RESPONSE DATA
- actions — ex_date, event_type, sub_type, ratio_text, amount, record_date, payment_date, raw_purpose.
NOTES
- Newest ex-date first, including any announced with an ex-date in the coming weeks.
Also available via REST:EXAMPLE PROMPTS
- Has this company done a stock split, bonus issue or buyback in the last 5 years?
/stocks/{q}/corporate-actionsFull detailsSee a company's latest announcements to the exchange.
Starts filing workget_stock_eventsRecent regulatory announcements and filings
USE WHEN
The BSE announcement feed for a company — headlines and categories, so you know what's been disclosed recently.
PARAMETERS
get_stock_events parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. daysintegerNo 30 Window in days, 1 to 365. categorystringNo — One of Company Update, Board Meeting, Corp. Action, AGM/EGM, Insider Trading / SAST, Integrated Filing or Others; any other value returns nothing. RESPONSE DATA
- events — title (one readable line per event), filed_at, category, sub_category, subject, headline, attachment_url, critical, news_id. Rows that attach the same document are returned as one event.
- truncated — set when a long list was cut to fit.
NOTES
- Metadata only — attachment PDFs are linked, not parsed; pass news_id values to get_filing_extracts for their contents. The results announcement itself is not listed; use get_financials instead.
- This capability can queue filing extraction or background prefetch and consume the caller's on-demand quota.
Also available via REST:EXAMPLE PROMPTS
- What has this company announced to the exchange in the last month?
/stocks/{q}/eventsFull detailsSee which companies report results in the next two weeks.
Readsget_upcoming_resultsBoard-meeting / results calendar across the market
USE WHEN
See which companies have results due in the next couple of weeks, market-wide or filtered by sector.
PARAMETERS
get_upcoming_results parameters Name Type Required Default Description daysintegerNo 14 Look-ahead window, 1 to 90 days. sectorstringNo — Filter to one sector, matched whatever the case. A name that is not recognised returns the closest valid names; companies not matched to a sector are left out. limitintegerNo 50 1 to 200 rows, earliest first. RESPONSE DATA
- results — meeting_date, bse_code, isin, nse_symbol, name, sector.
- total_count and truncated — truncated says when limit cut later dates.
Also available via REST:EXAMPLE PROMPTS
- Which companies are announcing results in the next two weeks?
/results-calendarFull detailsRead the key facts from one company filing, with the source page.
Starts filing workget_filing_extractGrounded facts extracted from a filing
USE WHEN
Read source-grounded facts from a selected filing after finding it in the company events feed.
PARAMETERS
get_filing_extract parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. news_idstringYes — Filing/news identifier returned by get_stock_events or get_announcement_bucket. RESPONSE DATA
- Extracted facts with source quotes, page references, filing metadata and guard status.
- On a cache miss: status ("pending"/"failed"/"not_queued"), queued flag, and attachment_url so the raw filing is still reachable.
NOTES
- Call get_stock_events first to find a news_id.
- If the filing has not been extracted yet, the call queues it and waits up to about 30 seconds; otherwise it returns status "pending" with retry_after_seconds, and the call can be repeated after that long. Queuing counts against a small daily allowance; reading an already-extracted filing does not.
- Financial-results filings are not extracted; use get_financials. For several filings of one company use get_filing_extracts.
- reason_code on a non-pending miss: "not_queued" (with sub-reasons "results_available_via_financials" or "no_document_to_extract") or "failed" (with error_reason), plus "on_demand_quota_exceeded" if the caller is rate-limited.
- This capability can queue filing extraction or background prefetch and consume the caller's on-demand quota.
Also available via REST:EXAMPLE PROMPTS
- Extract the reported facts from this company's latest investor presentation filing.
/stocks/{q}/filings/{news_id}/extractFull detailsSee the categories exchange announcements are sorted into.
Readslist_announcement_bucketsDisclosure categories available for discovery
USE WHEN
List the controlled announcement buckets before exploring market-wide disclosures.
PARAMETERS
No parameters.
RESPONSE DATA
- buckets — a fixed, server-defined list of {id, label} pairs, plus a total count.
NOTES
- This registry is not cache-derived — it's always fresh, unlike the announcements returned by get_announcement_bucket.
Also available via REST:EXAMPLE PROMPTS
- What announcement categories can I explore?
/bucketsFull detailsBrowse recent announcements from all companies in one category.
Starts filing workget_announcement_bucketMarket-wide disclosures by category
USE WHEN
Browse recent exchange announcements grouped by a known disclosure bucket.
PARAMETERS
get_announcement_bucket parameters Name Type Required Default Description bucketstringYes — One of order-receipts, fundraise, credit-rating, acquisitions or management-changes (the ids list_announcement_buckets returns). daysintegerNo 7 Lookback window, 1 to 90 days. RESPONSE DATA
- events — company identifiers, filed_at, headline, category, source attachment, and news_id (usable with get_filing_extract).
- truncated, total_scanned — rows are capped at 200.
NOTES
- An unrecognized bucket id returns bad_request with the list of valid ids.
- This capability can queue filing extraction or background prefetch and consume the caller's on-demand quota.
Also available via REST:EXAMPLE PROMPTS
- Show recent major order-win announcements across the market.
/buckets/{bucket}Full detailsSee results, dividends, splits and other company events for a date range.
Readsget_market_calendarMarket-wide event calendar
USE WHEN
Bring results, dividends, splits, bonuses, demergers and other market events into one date range.
PARAMETERS
get_market_calendar parameters Name Type Required Default Description date_fromdateNo — ISO start date; defaults to today. date_todateNo — ISO end date, on or after date_from and at most 180 days later; defaults to 30 days after date_from. typeslist[string]No — Subset of results, dividend, split, bonus, demerger, ipo, consolidation, rights, buyback, spinoff, merger, distribution, other. Unknown type is rejected. limitintegerNo 150 1 to 2000. The default is 150 over MCP and 500 on the REST route. RESPONSE DATA
- events — date, type, isin, nse_symbol, name, detail; merged from the results calendar, corporate-action disclosures and IPO dates, sorted chronologically.
NOTES
- An event's date is the board-meeting date for results, the ex-date for a corporate action, and the opening, closing or listing date for an IPO.
- A list that was cut says so: ask again with date_from set to the last date returned, or with fewer types.
Also available via REST:EXAMPLE PROMPTS
- What Indian stock-market events are scheduled for next week?
/calendarFull detailsSee open, upcoming and recent IPOs: dates, price range and listing facts.
Readsget_iposUpcoming and recently listed IPO facts
USE WHEN
Read IPO status, dates, price bands, issue details and listing facts where available.
PARAMETERS
get_ipos parameters Name Type Required Default Description statusstringNo — "upcoming" | "open" | "listing_pending" | "listed"; omitted returns all four. Unknown value is rejected. limitintegerNo 100 1 to 500. Rows are ordered by opening date, latest first, whatever their status. RESPONSE DATA
- IPO name, issuer, status (derived at read time from today's IST date, never stale), price band, issue size, opening, closing and listing dates, the closing price on listing day, and a DRHP/prospectus link.
NOTES
- Lot size, final issue price, subscription multiples and listing gain are not available from the sources DalalOS reads; the fields come back empty.
- No Grey Market Premium (GMP) field is ever returned — GMP has no official exchange source, so it's deliberately excluded under the SEBI-RA raw-facts-only line.
Also available via REST:EXAMPLE PROMPTS
- Which Indian IPOs are upcoming or currently open?
/iposFull detailsRead the key facts from several filings of one company at once.
Starts filing workget_filing_extractsRead several filing extractions in one batch
USE WHEN
Retrieve cached facts from up to ten filings of one company, with shared retry guidance for pending processing.
PARAMETERS
get_filing_extracts parameters Name Type Required Default Description querystringYes — NSE symbol, ISIN or BSE code. news_idsstring[]Yes — Up to ten filing identifiers from the company's disclosures. RESPONSE DATA
- Per-filing extraction results, pending_news_ids and shared retry_after_seconds.
NOTES
- Cache misses can queue extraction and use the caller's on-demand quota; this is a processing action, not a read-only operation.
- Pending processing is not a completed extraction; follow the returned retry guidance.
- This capability can queue filing extraction or background prefetch and consume the caller's on-demand quota.
Full detailsEXAMPLE PROMPTS
- Read the extracted facts from these filings of this company and list any still pending.
See the history around one company announcement, and what is still unanswered.
Readsget_event_contextHistorical context for one canonical filing event
USE WHEN
Read evidence-backed context around a previously extracted filing, including its disclosure thread and unresolved factual follow-ups where available.
PARAMETERS
get_event_context parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. news_idstringYes — Filing/news identifier returned by disclosure/event tools. RESPONSE DATA
- Canonical event fields with source evidence, related prior/context events, event-family timeline and open factual questions where available.
NOTES
- This reads already-canonicalized evidence; if a filing is not extracted yet, use get_filing_extract first.
- It does not infer business causality or correlate the filing with price moves or external news.
Full detailsEXAMPLE PROMPTS
- Show the historical context for this filing news_id and the related disclosure timeline.
Search the text of a company's filings and get the matching passages with page numbers.
Readssearch_company_disclosuresSearch page-preserving company filing text
USE WHEN
Search already indexed official filings for one company and return matched passages with their original PDF page references and coverage metadata.
PARAMETERS
search_company_disclosures parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. search_textstringYes — A few distinctive words. A passage matches if it contains any of them, best matches first; AND and OR are not operators. from_datedateNo — Optional ISO date limiting the filing date. to_datedateNo — Optional ISO date limiting the filing date. document_typeslist[string]No — Optional list from concall, presentation, order_win, rating, debt_security, acquisition, results, press_release, sast_disclosure, corp_action, governance_change, fund_raise, scheme_of_arrangement, business_update, annual_report, brsr, meeting_notice, compliance_noise and other; any other value matches nothing. limitintegerNo 10 Passages returned, 1 to 20, with at most two per filing. RESPONSE DATA
- Matched filing passages with news_id, filed date/category/subject, document type, original source_page, attachment URL, match terms and coverage metadata.
NOTES
- Search covers only already indexed filings whose page boundaries were preserved; older parsed filings without page indexes are reported in coverage rather than silently searched without citations.
- No upstream fetch occurs on this search path and it never queues a filing for reading, so no match does not mean the company never disclosed it; coverage shows what is indexed.
Full detailsEXAMPLE PROMPTS
- Search this company's indexed filings for 'capacity expansion' and show the source pages.
Find a company's annual reports, results, presentations and call transcripts.
Readsget_company_documentsA company's filed documents, grouped by type
USE WHEN
List the documents an Indian listed company filed (results, annual reports, investor presentations, call transcripts and recordings, board and AGM papers, ratings), each with its source link.
PARAMETERS
get_company_documents parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. daysintegerNo 365 Trailing window in days, 1 to 1825. document_typestring | nullNo — One of results, annual_report, presentation, transcript, recording, board_meeting, agm_egm, insider_takeover, rating, management_change, deal, corporate_action, press_release, investor_meet, compliance or other. limitintegerNo 60 Maximum documents returned, 1 to 1000, newest first. The default is 60 over MCP and 500 on the REST route; pass a document type or fewer days when the list is cut. RESPONSE DATA
- Documents grouped by type, each with type, filing_type, source_url, published_at and a nullable extraction_id; filings with no attachment are counted in without_source.
NOTES
- Transcripts and recordings are the company's own uploads under SEBI LODR Regulation 30, as links only; they are not transcribed or summarised.
- The results type can be incomplete; the figures are in get_financials. A document with an extraction_id has already been read: pass it as news_id to get_filing_extract.
- Cache-only. For what was announced and when, use get_stock_events.
Full detailsEXAMPLE PROMPTS
- Where are Infosys's latest annual report and earnings call transcript?
The whole market
Figures that cover the whole market, not one company: money flows, indices, volatility and official economic data.
EXAMPLE PROMPTS
- Show market-wide FII and DII cash flows for the last month.
- How many stocks advanced and declined on the NSE yesterday?
- Show the last six months of India CPI inflation.
See large single trades reported by the exchanges, with date, quantity and price.
Readsget_bulk_block_dealsBulk and block deal disclosures
USE WHEN
Inspect exchange-reported bulk and block deals with date, security, quantity and price details.
PARAMETERS
get_bulk_block_deals parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. deal_typestringNo — "bulk" or "block"; omitted returns both. daysintegerNo 90 Trailing lookback window, clamped 1–1825. limitintegerNo 100 Max rows, newest first, clamped 1–500. RESPONSE DATA
- deals — trade_date, client_name, buy_sell ("BUY"/"SELL"), quantity, price, remarks (bulk only).
- One row per counter-party + direction, not a matched buyer/seller pair — NSE doesn't publish that pairing.
NOTES
- Only NSE's most-recently-published trading day is fetched upstream (no reachable historical bulk/block archive) — coverage starts from whenever the nightly refresh job began running, not further back.
Also available via REST:EXAMPLE PROMPTS
- Show bulk and block deals for the last two weeks.
/stocks/{q}/bulk-block-dealsFull detailsSee open positions in futures and options (F&O) on a stock or an index.
Readsget_derivatives_positioningPer-stock or index F&O positioning
USE WHEN
Read futures/open-interest changes, call/put open interest, PCR and F&O-ban status for an underlying.
PARAMETERS
get_derivatives_positioning parameters Name Type Required Default Description querystringYes — Stock identifier or raw index name such as NIFTY or BANKNIFTY. RESPONSE DATA
- Underlying, futures OI/OI change, call/put OI, PCR, volume and ban-list status.
NOTES
- PCR is a mechanically-computed ratio, not a signal or recommendation.
Also available via REST:EXAMPLE PROMPTS
- Show the latest derivatives positioning for NIFTY and RELIANCE.
/stocks/{q}/derivatives-positioningFull detailsSee how foreign institutions, domestic institutions and others hold futures and options positions, day by day.
Readsget_fo_participant_activityMarket-wide F&O participant activity
USE WHEN
Compare daily FII, DII, proprietary and client open interest and volume across the derivatives segment.
PARAMETERS
get_fo_participant_activity parameters Name Type Required Default Description daysintegerNo 10 Trailing window in days, 1 to 366. The default is 10 over MCP and 30 on the REST route. RESPONSE DATA
- Daily participant-wise open interest, change and volume across the F&O segment.
Also available via REST:EXAMPLE PROMPTS
- Show FII and client F&O positioning for the last 30 days.
/fo-participant-activityFull detailsSee how an index's price compared with its profit, net assets and dividends over the years.
Readsget_index_valuationIndex valuation history
USE WHEN
Read NSE-sourced index-level PE, PB and dividend-yield time series, including sector indices.
PARAMETERS
get_index_valuation parameters Name Type Required Default Description indexstringYes — NSE index name such as Nifty 50, Nifty Bank or Nifty IT; list_index_valuations gives the names. from_datedateNo — ISO start date; the window is at most 1825 days. to_datedateNo — ISO end date. The default window is the 30 days to today. RESPONSE DATA
- Index valuation rows with date, open, high, low, close, PE, PB and dividend yield.
NOTES
- An unrecognized index name returns reason_code "no_data" with an available_indices_hint rather than a bare error.
Also available via REST:EXAMPLE PROMPTS
- Show NIFTY IT valuation history over the last year.
/index-valuations/{index}Full detailsSee which indices have that valuation history.
Readslist_index_valuationsIndices with valuation history
USE WHEN
List the index names available for PE, PB and dividend-yield history.
PARAMETERS
No parameters.
RESPONSE DATA
- Index names, aliases and available valuation coverage.
Also available via REST:EXAMPLE PROMPTS
- Which indices have valuation history available?
/index-valuationsFull detailsSee the India VIX over time, the NSE's gauge of how sharply the market swings.
Readsget_india_vixIndia VIX history
USE WHEN
Read the NSE-sourced India VIX time series as a market-volatility fact.
PARAMETERS
get_india_vix parameters Name Type Required Default Description from_datedateNo — ISO start date. to_datedateNo — ISO end date. RESPONSE DATA
- Date, open, high, low, close, points change and percentage change.
NOTES
- This is DalalOS's own India VIX series — if another connected MCP server also exposes a VIX tool, treat them as separate, non-interchangeable series.
Also available via REST:EXAMPLE PROMPTS
- Show India VIX over the last 30 days.
/india-vixFull detailsSee how many companies rose, fell or were unchanged each day.
Readsget_market_breadthWhole-market advance/decline breadth
USE WHEN
Read daily advancing, declining and unchanged security counts across the market.
PARAMETERS
get_market_breadth parameters Name Type Required Default Description from_datedateNo — ISO start date; the window is at most 366 days and the default is the 30 days to today. to_datedateNo — ISO end date. universestring | nullNo — Omit for NSE's own published counts. "all_series" (every listed security), "equity_sme" (shares and SME shares) or "equity" (mainboard shares only) compute the counts from the daily price file instead, which go back further. RESPONSE DATA
- Daily advances, declines, unchanged counts and breadth fields.
NOTES
- NSE's own published counts are held only from the day DalalOS began collecting them, so an empty result for an older date is expected; the universe option reaches back further. Use equity when the question is about stocks.
Also available via REST:EXAMPLE PROMPTS
- Show market breadth for the last two weeks.
/market-breadthFull detailsSee official figures for inflation, economic growth, industrial output and crude oil prices.
Readsget_macro_indicatorsOfficial India macroeconomic indicators
USE WHEN
Read official CPI, WPI, IIP, GDP and Indian basket crude-oil series for market context.
PARAMETERS
get_macro_indicators parameters Name Type Required Default Description datasetstringYes — "cpi" | "wpi" | "iip" | "gdp" | "crude_basket"; any other value is rejected. from_periodstringNo — Starting period — "YYYY-MM" for cpi/wpi/iip/crude_basket, fiscal-year string e.g. "2024-25" for gdp. to_periodstringNo — Ending period, same format as from_period. series_containsstringNo — Substring filter on series_key (e.g. "Food", "Manufacturing"); a no-op for crude_basket, which has only one series. limitintegerNo 200 Clamped 1–2000, newest period first. RESPONSE DATA
- Officially reported macro observations with period, series, value, unit and source.
Also available via REST:EXAMPLE PROMPTS
- Show India's CPI, GDP growth and crude-oil indicators for the latest available periods.
/macro/indicatorsFull detailsSee the official daily rupee reference rates against major currencies.
Readsget_fx_reference_ratesFBIL INR reference exchange rates
USE WHEN
Read daily official INR reference rates for supported currency pairs.
PARAMETERS
get_fx_reference_rates parameters Name Type Required Default Description currency_pairstringNo — One pair, such as USD/INR. Covers USD, GBP, EUR, JPY, AED and IDR against the rupee. from_datedateNo — ISO start date; the default window is the last 30 days. to_datedateNo — ISO end date. RESPONSE DATA
- Date, currency pair, unit_base, reference rate and source.
NOTES
- rate is rupees per unit_base units of the foreign currency: 1 for most pairs, 100 for JPY, 10,000 for IDR.
- These are reference rates published on business days, not live quotes.
Also available via REST:EXAMPLE PROMPTS
- Show the USD/INR reference rate for the last month.
/macro/fx-ratesFull detailsSee daily buying and selling by foreign investors in each sector. The source covers only part of the market.
Readsget_sector_fii_flowDaily FII/FPI transaction flow by sector
USE WHEN
Read available CDSL-sourced daily FII/FPI transaction activity aggregated by sector.
PARAMETERS
get_sector_fii_flow parameters Name Type Required Default Description from_datedateNo — ISO start date; the window is at most 366 days. to_datedateNo — ISO end date. sectorstringNo — Optional sector filter, matched whatever the case. A name that is not found returns the valid names (valid_sectors). RESPONSE DATA
- Sector-level daily transaction flow, totals, changes, coverage note, and effective_from and effective_to for the dates covered.
NOTES
- CDSL-only coverage is partial, not a complete view of all FII/FPI activity.
- The CDSL data ends in March 2025. With no dates given, the window is the 30 days up to the latest data held, not the last 30 days; with explicit dates it is as asked. For current sector flows use get_sector_fpi_investment.
Also available via REST:EXAMPLE PROMPTS
- Which sectors saw the most reported FII activity in the latest CDSL data held?
/fii-dii/sectorsFull detailsOlder name for get_stock_fii_flow. Use that one.
Readsget_fii_activityDeprecated alias — daily per-stock FII/FPI transaction flow
USE WHEN
Compatibility alias for get_stock_fii_flow; use the current name for new integrations.
PARAMETERS
get_fii_activity parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. daysintegerNo 90 Series length in days, 1 to 1825, counted back from the latest day of data held, not from today. RESPONSE DATA
- Per-day transaction activity, summaries and coverage note.
NOTES
- Deprecated compatibility alias; prefer get_stock_fii_flow.
- CDSL-only coverage is partial, not a complete view of all FII/FPI activity.
- The CDSL data ends in March 2025, so the series and its 30-day summary describe that period, not the last 30 days.
Also available via REST:EXAMPLE PROMPTS
- Show the reported FII activity for RELIANCE in the latest CDSL data held.
/stocks/{q}/fii-activityFull detailsSee foreign portfolio investment in each sector, fortnight by fortnight.
Readsget_sector_fpi_investmentFortnightly sector FPI investment and custody totals
USE WHEN
Read NSDL's reported sector-level net investment and assets under custody across both depositories, with units and period dates.
PARAMETERS
get_sector_fpi_investment parameters Name Type Required Default Description from_datedate | nullNo — Optional ISO date, matched to the fortnight's end. to_datedate | nullNo — Optional ISO date, matched to the fortnight's end. sectorstring | nullNo — One of NSDL's own sector names, or "Grand Total" for all sectors; call without it to see the names. The names changed on 30 April 2022, so a name may match only one side of that date. instrumentstringNo equity Reported instrument column: equity, debt_general, debt_vrr, debt_far, hybrid, aif, total, mf_equity, mf_debt, mf_hybrid, mf_solution_oriented or mf_other. Before 2020 only equity, debt_general and total were reported. include_subsectorsbooleanNo false Include pre-2022 subsector rows already included in parent totals. RESPONSE DATA
- Period dates, sector taxonomy, row kind, net investment and assets under custody in INR crore and USD million.
NOTES
- Fortnightly NSDL sector data is distinct from daily cash flows and quarterly company holding percentages.
- Covers all FPIs across both depositories from 2012. Default window is the last six months; the longest window is five years unless a sector is given. Missing published values remain null.
Full detailsEXAMPLE PROMPTS
- Show the latest fortnightly equity FPI net investment by NSDL sector.
See a company's linked commodity, currency or rate factors next to official figures for them, where the data allows.
Readsget_company_macro_exposuresCompany exposure evidence with eligible official macro context
USE WHEN
Combine reviewed company exposure pathways with supported official macro windows when the evidence and coverage policy allow eligible macro context.
PARAMETERS
get_company_macro_exposures parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. factorslist[string]No — Optional filter from crude_oil, usd_inr, interest_rates, gold_price, silver_price, steel_price, aluminium_price, government_capex, real_estate_activity, power_sector_capex and renewable_policy_and_tenders; up to 12. as_of_datedateNo — ISO date the exposures apply on and the macro window is judged at; defaults to today. RESPONSE DATA
- Reviewed company exposure evidence, eligible official context signals, and explicit coverage/eligibility status for requested factors.
NOTES
- A macro signal is conditional context only — it never claims that a macro move caused or will cause earnings, price or investment outcomes.
- Use get_company_exposures for the simpler reviewed exposure list without macro-window eligibility evaluation.
Full detailsEXAMPLE PROMPTS
- Show this company's reviewed crude-oil and USD/INR exposures with eligible official macro context.
See which stocks are barred from new futures and options positions in the latest list.
Readsget_fno_ban_listCurrent NSE F&O securities-in-ban list
USE WHEN
Return the complete latest published F&O ban list in one market-wide call instead of checking one underlying at a time.
PARAMETERS
No parameters.
RESPONSE DATA
- ban_date (the latest day NSE published the list) and every security in ban that day. An empty list means nothing is in ban that day.
NOTES
- Use get_derivatives_positioning when the question is about one underlying's positioning and its in_ban_list flag; this tool is the whole-list view.
Full detailsEXAMPLE PROMPTS
- Which securities are on the latest available NSE F&O ban list?
See daily buying and selling by foreign (FII) and domestic (DII) institutions across the whole market.
Readsget_market_fii_dii_flowMarket-wide daily FII/DII cash flows
USE WHEN
Read daily market-wide FII/DII cash-market transaction totals and mechanically-computed net flows with per-date provenance.
PARAMETERS
get_market_fii_dii_flow parameters Name Type Required Default Description from_datedateNo — Optional ISO start date; omitted uses the trailing window. to_datedateNo — Optional ISO end date; the window is capped at 366 days. segmentstringNo cash Cash only. Use get_fo_participant_activity for F&O participant positioning. RESPONSE DATA
- Daily trade_date, FII/DII buy, sell and net values in Rs crore, plus the source for each row.
NOTES
- This is market-wide cash flow, distinct from sector/stock FII transaction-flow tools and quarterly shareholding.
- Historical and recent rows can have different provenance; the envelope reports the shared source or mixed while each row retains its own source.
Also available via REST:EXAMPLE PROMPTS
- Show market-wide FII and DII cash flows for the last month.
/fii-diiFull detailsSee daily buying and selling by foreign investors in one company. The source covers only part of the market.
Readsget_stock_fii_flowDaily per-stock FII/FPI transaction flow
USE WHEN
Read available CDSL-sourced daily FII/FPI transaction activity for one listed company, with an explicit partial-coverage note.
PARAMETERS
get_stock_fii_flow parameters Name Type Required Default Description querystringYes — One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first. daysintegerNo 90 Series length in days, 1 to 1825, counted back from the latest day of data held for the stock, not from today. RESPONSE DATA
- Per-day FII/FPI buy, sell and mechanically-computed net transaction values, plus a 30-day summary, effective_from and effective_to for the dates covered, and coverage context.
NOTES
- CDSL-only transaction coverage is partial and is not the same dataset as quarterly foreign holding percentage. The data ends in March 2025, so the series and its 30-day summary describe that period, not the last 30 days.
- get_fii_activity is the deprecated compatibility alias for this tool.
Full detailsEXAMPLE PROMPTS
- Show reported FII transaction flow for RELIANCE in the latest CDSL data held.
See which stocks in an index rose or fell most, or traded most, in the last session.
Readsget_top_moversMechanically ranked index movers and most-active names
USE WHEN
Rank one index's constituents for a completed EOD session by day change, traded value or volume — a raw sort, not an investment ranking.
PARAMETERS
get_top_movers parameters Name Type Required Default Description indexstringNo NIFTY 500 Index name returned by list_indices, matched whatever the case; a name that is not recognised returns the valid ones. metricstringNo pct_change pct_change | change | turnover | volume. directionstringNo desc desc for largest/highest activity or asc for lowest/losers. limitintegerNo 20 1 to 100 rows. RESPONSE DATA
- Ranked constituent rows for one completed EOD session with price/change/activity fields and the requested mechanical sort context.
NOTES
- Distinct from get_market_heatmap: the heatmap is deliberately market-cap sorted and not return-sortable; this tool explicitly performs caller-chosen raw ranking.
- The session cannot be chosen: the result's as_of says which one was ranked. To rank every NSE security on a past day use get_market_ranking.
- A sorted mover list is descriptive market data, not a recommendation or signal.
Full detailsEXAMPLE PROMPTS
- Show the largest NIFTY 500 gainers by day percentage change, limited to 20 rows.
Compare indices on return, swings and their biggest fall over the same period.
Readscompare_indicesCompare NSE indices on return, volatility and drawdown
USE WHEN
Put 2 to 10 NSE indices side by side over the same window: price return, annualised volatility, maximum drawdown and the largest daily rise and fall, from NSE's own daily closes.
PARAMETERS
compare_indices parameters Name Type Required Default Description indicesstring[]Yes — 2 to 10 NSE index names, such as "Nifty 50" and "Nifty Bank" (case-insensitive; a miss lists the valid names). daysinteger | nullNo 365 Days back from the newest stored day, up to 1825. from_datedate | nullNo — Optional ISO start date instead of days. to_datedate | nullNo — Optional ISO end date. RESPONSE DATA
- Per index: price return %, annualised volatility of daily returns (x sqrt 252), maximum drawdown, and the best and worst day.
NOTES
- Arithmetic on published closes. For one index's OHLC and P/E use get_index_valuation.
Full detailsEXAMPLE PROMPTS
- How did Nifty Bank do against Nifty IT over the last year?
See NSE's market cap and shares in issue for a company over time.
Readsget_market_cap_historyNSE's market cap and shares in issue over time
USE WHEN
Read NSE's own published market capitalisation, shares in issue and face value for one company over time, or the largest companies on a day.
PARAMETERS
get_market_cap_history parameters Name Type Required Default Description symbolstring | nullNo — One NSE security; omit for the largest companies on a day. daysinteger | nullNo 30 Window for one security. from_datedate | nullNo — Optional ISO start date. to_datedate | nullNo — Optional ISO end date. datedate | nullNo — The day for the largest-companies list (default the newest day). limitintegerNo 25 1 to 100 companies. RESPONSE DATA
- Per day: market_cap in rupees as NSE published it, shares in issue and face value; without a symbol, NSE's listed, permitted and total market cap for the day.
NOTES
- market_cap is not always issue size times close and is not corrected. History starts 1 Feb 2024.
Full detailsEXAMPLE PROMPTS
- How has Reliance's market cap changed over the last 30 days?
See which stocks traded the most on a day, by volume, value or delivery.
Readsget_market_rankingNSE stocks ranked by volume, turnover or delivery on a day
USE WHEN
Rank NSE securities on one trading day by a published number: volume, turnover, number of trades, delivery percentage or percentage change.
PARAMETERS
get_market_ranking parameters Name Type Required Default Description datedate | nullNo — ISO date; default the newest stored day. metricstringNo volume volume | turnover | num_trades | deliv_pct | pct_change. directionstringNo desc desc | asc. limitintegerNo 25 1 to 100. instrument_classstringNo equity equity (mainboard) | sme | fund_unit | all. seriesstring | nullNo — One NSE series, such as EQ or BE. RESPONSE DATA
- Ranked rows from NSE's daily bhavcopy with the chosen metric and the day's price fields.
NOTES
- pct_change is (close - prev_close) / prev_close rounded to two places, NSE's own rule for advances and declines. For movers within one index use get_top_movers.
Full detailsEXAMPLE PROMPTS
- Which stocks traded the most on NSE today?
See which stocks hit their upper or lower price limit (circuit) on a day.
Readsget_price_band_hitsStocks that hit their upper or lower circuit
USE WHEN
Read NSE's official list of securities that hit their price band (circuit) on a day, or how often one stock has.
PARAMETERS
get_price_band_hits parameters Name Type Required Default Description datedate | nullNo — The day to list every hit (default the newest day). symbolstring | nullNo — One security's hits over a window instead. daysinteger | nullNo 90 Window for one symbol, up to 1825. directionstringNo all upper | lower | all. limitintegerNo 200 1 to 500. RESPONSE DATA
- Securities with the band they hit (upper or lower) and the date.
NOTES
- This is the exchange's own record, which OHLC alone cannot reproduce: a stock can touch its band intraday and close inside it. From 2010.
Full detailsEXAMPLE PROMPTS
- Which stocks hit the upper or lower circuit today?
Your watchlist
The stocks you have saved on DalalOS. These tools read your list, add to it and remove from it.
EXAMPLE PROMPTS
- Show my DalalOS watchlist.
- Add RELIANCE, TCS and INFY to my DalalOS watchlist.
- Remove Wipro from my watchlist.
See the stocks saved on your DalalOS watchlist.
Readsget_watchlistRead your DalalOS watchlist
USE WHEN
Retrieve your saved stock symbols with best-effort company enrichment.
PARAMETERS
No parameters.
RESPONSE DATA
- Symbols, added timestamps and optional name, sector and market-cap enrichment (best-effort; a delisted/renamed symbol still returns as a bare row rather than failing the call).
NOTES
- Account-scoped and requires OAuth or API-key authentication; this is not a portfolio (no quantity or cost basis).
- reason_code "unauthorized" if unauthenticated, "not_configured" if the deployment has no watchlist backend wired up.
- Has a REST equivalent: GET /v1/account/watchlist, same credential (API key or OAuth) as this tool.
Full detailsEXAMPLE PROMPTS
- Show my DalalOS watchlist.
Save stocks to your watchlist.
Edits your watchlistadd_to_watchlistSave stocks to your DalalOS watchlist
USE WHEN
Add one or more symbols to your account-scoped watchlist for later research.
PARAMETERS
add_to_watchlist parameters Name Type Required Default Description symbolslist[string] | stringYes — NSE symbols, ISINs, BSE codes or company names, as a list or one pasted string separated by commas, semicolons, new lines, tabs or pipes (not spaces). Up to 200 entries per call. RESPONSE DATA
- watchlist (the entries saved by this call, including any already on the list), unmatched and ambiguous.
NOTES
- Account-scoped write action; it does not store quantity, cost basis or orders.
- An entry is saved only when it identifies one NSE-listed company exactly. A misspelt or partial name is not saved: it comes back under ambiguous with its candidates and a reason, and unmatched entries carry a reason in unmatched_reasons.
- Re-adding a symbol already on the watchlist is a no-op, not an error.
- reason_code "unauthorized" if unauthenticated, "not_configured" if the deployment has no watchlist backend wired up.
- Has a REST equivalent: POST /v1/account/watchlist, same credential (API key or OAuth) as this tool.
Full detailsEXAMPLE PROMPTS
- Add RELIANCE, TCS and INFY to my DalalOS watchlist.
Remove a stock from your watchlist.
Edits your watchlistremove_from_watchlistRemove a stock from your watchlist
USE WHEN
Remove one or more saved symbols from your DalalOS watchlist.
PARAMETERS
remove_from_watchlist parameters Name Type Required Default Description symbolslist[string] | stringYes — Symbols as get_watchlist returns them, or the ISIN or BSE code of a company on the list, as a list or one pasted string separated by commas, semicolons, new lines, tabs or pipes. Up to 200 entries per call. Company names are not matched. RESPONSE DATA
- removed and not_found, with removed_symbols and not_found_reasons where relevant.
NOTES
- Account-scoped write action; it does not place trades.
- Every entry is reported: one that is not on the list comes back under not_found and does not fail the others. A value made only of delimiters is rejected as a bad request.
- To clear the list, call get_watchlist and pass every symbol it returns.
- reason_code "unauthorized"/"not_configured" for auth/deployment issues.
- Has REST equivalents: DELETE /v1/account/watchlist/{symbol} for one symbol and DELETE /v1/account/watchlist with a symbols list, same credential (API key or OAuth) as this tool.
Full detailsEXAMPLE PROMPTS
- Remove INFY from my DalalOS watchlist.
Feedback
Tell the DalalOS team about a figure that looks wrong or a feature you want. Your assistant sends a report only when you ask it to or agree to its offer. It's free and doesn't use your credits. The team uses reports to improve DalalOS and doesn't reply to individual reports for now.
EXAMPLE PROMPTS
- Report to DalalOS that this revenue figure looks different from the annual report.
- Send DalalOS a feature request: I'd like quarterly segment revenue.
Report a data problem or ask for a feature. It's free, and the team doesn't reply to individual reports for now.
Sends feedbacksubmit_dalalos_feedbackReport a data problem or request a feature
USE WHEN
Tell the DalalOS team about a figure that looks wrong, a tool error, an unclear description or a feature you want, without leaving your AI assistant.
PARAMETERS
submit_dalalos_feedback parameters Name Type Required Default Description categoryenumYes — One of data_inaccurate, data_outdated, data_missing, tool_error, unexpected_result, feature_request, documentation, other. summarystringYes — Short description, up to 160 characters. detailsstringYes — What happened or what you need, up to 2,000 characters. request_idstring (UUID)Yes — A fresh UUID per report, generated by the assistant. Reusing it for the same report makes a retry safe: you get the original report back instead of a duplicate. related_toolstring | nullNo — The DalalOS tool involved, such as get_financials. security_identifierstring | nullNo — NSE symbol, BSE code or ISIN. Give it together with security_identifier_type. security_identifier_typense_symbol | bse_code | isin | nullNo — Which kind of identifier security_identifier is. metricstring | nullNo — The affected metric or field. observed_valuestring | nullNo — The value you saw, with its unit, up to 200 characters. expected_valuestring | nullNo — The value you expected, with its unit, up to 200 characters. as_of_datestring | nullNo — The date or reporting period concerned. source_referencestring | nullNo — A short citation or URL for what you compared against. It is stored as text and never fetched. RESPONSE DATA
- report_id and status "received", with a short acknowledgement. Received means the report was saved, not that it has been checked, prioritised or fixed.
NOTES
- Account-scoped write action that sends a report to the DalalOS team. It changes no market data and places no orders.
- Asks first: an assistant should submit only when you ask it to, or after you agree to its offer to report something it noticed.
- Free: it does not use your monthly credits and still works after you reach your plan's limit. A separate per-account limit stops abuse.
- The team uses reports to improve DalalOS and does not reply to individual reports for now.
- A reported discrepancy is stored as your claim, not a confirmed error: units, periods or source timing can explain an apparent difference.
- Do not include passwords, API keys, tokens, contact details, portfolio holdings or whole conversations; the server tries to reject reports that contain a credential but cannot catch every secret.
- reason_code "unauthorized" if unauthenticated; "bad_request" for invalid input; "request_id_conflict" if the request_id was already used for a different report; "rate_limited" over the per-account limit; "save_failed" if the report could not be stored (retry with the same request_id); "feedback_disabled" or "not_configured" when submissions are not available.
- MCP only: there is no REST equivalent.
Full detailsEXAMPLE PROMPTS
- Report to DalalOS that the ROE it gave me for INFY looks different from the annual report.
Data checks
Checks on DalalOS itself.
EXAMPLE PROMPTS
- How fresh is the underlying data right now?
- When was price data last refreshed?
Check that the DalalOS server is reachable.
ReadspingHealth check
USE WHEN
Confirms the server is reachable — useful when wiring up a new MCP client.
PARAMETERS
No parameters.
RESPONSE DATA
- message: "pong".
Full detailsEXAMPLE PROMPTS
- Ping the server.
See when each kind of data was last refreshed and whether any is out of date.
Readsget_data_freshnessPer-data-domain freshness and job status
USE WHEN
See exactly when each data domain (prices, financials, shareholding, ...) last refreshed, and whether it's stale.
PARAMETERS
No parameters.
RESPONSE DATA
- Per-job status, age and staleness; an overall status.
Also available via REST:EXAMPLE PROMPTS
- How fresh is the underlying data right now?
/freshnessFull details
How it works
Connect once
Add DalalOS to your AI assistant and sign in.
Ask in plain English
Your assistant works out which tools answer the question.
Get sourced answers
Answers about market data carry their source and date.
More things you could ask
EXAMPLE PROMPTS
- Screen the FMCG sector for companies with low debt and a high return on equity.
- Compare Titan and Kalyan Jewellers on margins and debt-to-equity.
- Has promoter pledge in this company gone up in the last year?
- Which stocks in NIFTY 500 report results in the next 10 days?
- Show delivery percentage trend for this stock over the last quarter.
Need help getting started? Read the guided documentation or open the connection guide.
FAQ
Common questions
- How many tools does DalalOS have?
- DalalOS has 69 tools. Each is one thing your AI assistant can do, mostly looking something up. This page also lists 1 retired name that still works and a server check called ping, so 71 names in all.
- Are all DalalOS tools read-only?
- No. 62 only read data. 2 save or remove a stock on your own DalalOS watchlist. 1 sends a report to the DalalOS team, only when you ask or agree. 4 start background work on company filings, which has its own daily limit. None places a trade or touches a brokerage account.
- How do I report a wrong number or ask for a feature?
- Ask your AI assistant to report it to DalalOS. It sends a short report with what you saw and, if you know it, what you expected. If it spots a likely problem on its own, it should offer first and send nothing unless you agree. Sending feedback is free and doesn't use your credits. The team uses reports to improve DalalOS and doesn't reply to individual reports for now. Don't put passwords, API keys or personal details in a report.
- Do I need to write code to use these tools?
- No. Once your AI assistant is connected, ask in plain English and the assistant picks the tools. Developers can also call the tools directly.
- Where can I see the exact parameters and response fields?
- Open any tool on this page, or follow Full details to its own page. All 71 names are covered, including the retired one and ping.
- Does any tool give a buy, sell or target-price signal?
- No. The tools return sourced facts and figures worked out by fixed formulas. They give no recommendation, rating or target price. The watchlist tools only save or remove a stock on your own list.
Connect your AI to Indian stock market data
Add DalalOS as a connector and sign in once. Free to start with no card and no waitlist; paid plans from ₹199 a month when you need more.
KEEP EXPLORING