Skip to content

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

DalalOS gives numbers and where they came from. It does not say what to buy or sell, and it does not predict a price.

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_stocks

    Find 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
    NameTypeRequiredDefaultDescription
    querystringYes—Company name, NSE symbol, BSE code or ISIN. Typos are tolerated.
    limitintegerNo10Max 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").

    EXAMPLE PROMPTS

    • Find the ISIN for a stock called 'Infy' — I don't know the exact ticker.
    Also available via REST: /searchFull details
  • Filter all listed companies by measures such as valuation (price compared with profit), debt or ownership.

    Readsscreen_stocks

    Filter 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
    NameTypeRequiredDefaultDescription
    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_bystringNomarket_capField to sort results by.
    orderstringNodesc"asc" or "desc".
    limitintegerNo25Max 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.

    EXAMPLE PROMPTS

    • Find IT-sector stocks with ROE over 20% and PE under 30.
    Also available via REST: /screenFull details
  • See how a whole sector is priced against profit and net assets, and its dividends.

    Readsget_sector_overview

    Sector 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
    NameTypeRequiredDefaultDescription
    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.
    grainstringNosector"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.

    EXAMPLE PROMPTS

    • What's the median PE and dividend yield across the banking sector right now?
    Also available via REST: /sectorsFull details
  • List the companies in an index, such as NIFTY 50.

    Readslist_index_constituents

    Every 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
    NameTypeRequiredDefaultDescription
    indexstringYes—Index name such as NIFTY 50 or BSE SENSEX (a name, not a slug), matched whatever the case.
    limitintegerNo1001 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.

    EXAMPLE PROMPTS

    • List every stock in the NIFTY IT index.
    Also available via REST: /indices/{index}/constituentsFull details
  • See which indices exist and how many companies each holds.

    Readslist_indices

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

    EXAMPLE PROMPTS

    • What indices do you track, and how many stocks are in each?
    Also available via REST: /indicesFull details
  • See how every company in an index moved over a day, a month or a year.

    Readsget_market_heatmap

    Index 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
    NameTypeRequiredDefaultDescription
    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.
    limitintegerNo1001 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.

    EXAMPLE PROMPTS

    • Show me a heatmap of NIFTY 50 with 1-month and 1-year returns.
    Also available via REST: /indices/{index}/heatmapFull details
  • See ready-made filters, such as shares priced low against profit, refreshed overnight.

    Readslist_preset_screens

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

    EXAMPLE PROMPTS

    • What preset screens are available?
    Also available via REST: /presetsFull details
  • Get the latest results of one ready-made filter.

    Readsrun_preset_screen

    Run 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show me the results of the high-dividend-yield, large-cap preset screen.
    Also available via REST: /presets/{name}Full details
  • Filter companies with a rule you write, such as profit above a level and debt below one.

    Readsscreen_by_query

    Screen 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
    NameTypeRequiredDefaultDescription
    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.
    dialectstringNoscreener"screener" (common screener names, percentages written as 22%, market cap in crore) or "dalalos" (DalalOS metric ids in stored units: fractions and rupees).
    sort_bystringNomarket_capMetric id to sort by; missing values sort last.
    orderstringNodescasc or desc.
    limitintegerNo25Rows per page, 1 to 100.
    offsetintegerNo0Pagination 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_resultsbooleanNofalseKeep only companies that have filed results for the latest quarter most companies have reported.
    include_condition_countsbooleanNofalseAdd 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_contextbooleanNofalseAdd each row's 52-week low and high and the dates of the filings behind it.
    include_column_scalesbooleanNofalseAdd 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.

    EXAMPLE PROMPTS

    • Screen companies where PE is below 25 and return on equity exceeds 15%.
    Full details
  • Read what a term or ratio means and how it is calculated.

    Readsget_glossary

    Plain 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • What does ROCE mean, and how is it calculated?
    Full details

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_quote

    Latest 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • What's Reliance trading at, and where does that sit versus its 52-week range?
    Also available via REST: /stocks/{q}/quoteFull details
  • Get quotes for several stocks at once.

    Readsget_batch_quotes

    Quotes 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
    NameTypeRequiredDefaultDescription
    symbolslist[string]Yes—Up to 20 symbols, ISINs or codes.

    RESPONSE DATA

    • A per-symbol array: query, status, quote, cached_at, error, reason_code.

    EXAMPLE PROMPTS

    • Give me quotes for RELIANCE, TCS, HDFCBANK, INFY and ICICIBANK.
    Also available via REST: /quotesFull details
  • See a stock's opening, high, low and closing prices and volume, by day, week or month.

    Readsget_price_history

    Daily, 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    daysintegerNo90Lookback window, clamped 1–1825.
    adjustedbooleanNofalseRescale pre-event bars for splits/bonuses.
    intervalstringNodaily"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).

    EXAMPLE PROMPTS

    • Give me two years of weekly price history for TCS.
    Also available via REST: /stocks/{q}/price-historyFull details
  • See how a stock's price changed over periods from a week to a year, and its biggest fall from a peak.

    Readsget_returns

    Mechanically-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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • What's the 1-year and 3-year return for this stock, and its max drawdown?
    Also available via REST: /stocks/{q}/returnsFull details
  • Get chart measures calculated from past prices, such as moving averages.

    Readsget_technical_indicators

    Mechanically-computed technical indicators

    USE WHEN

    Read moving averages, RSI, MACD, Bollinger Bands and beta from the cached price series.

    PARAMETERS

    get_technical_indicators parameters
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show the technical indicators for TCS and include the calculation window.
    Also available via REST: /stocks/{q}/technical-indicatorsFull details
  • See a security's raw daily NSE rows, SME stocks and bonds included, with delivery.

    Readsget_security_history

    Raw 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
    NameTypeRequiredDefaultDescription
    symbolstringYes—NSE symbol or ISIN.
    seriesstring | nullNo—One series, such as EQ, BE, SM or GB.
    daysinteger | nullNo30Days 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.

    EXAMPLE PROMPTS

    • Show the last 30 days of NSE trading for an SME stock, with delivery percentage.
    Full details
  • See a stock's return beside an index's over the same period.

    Readsget_stock_vs_index

    One 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
    NameTypeRequiredDefaultDescription
    symbolstringYes—NSE equity symbol.
    indexstringNoNifty 50NSE index name, such as Nifty Bank or Nifty IT.
    daysinteger | nullNo365Window 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.

    EXAMPLE PROMPTS

    • How has Tata Motors done against the Nifty 50 over the last year?
    Full details

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_financials

    Quarterly 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    period_typestringNoquarterly"quarterly" | "annual".
    limitintegerNo8Number 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.

    EXAMPLE PROMPTS

    • Show me TCS revenue, margins, ROCE and debt-to-equity for the last 5 years.
    Also available via REST: /stocks/{q}/financialsFull details
  • Get one summary of a company: who it is, its price and its latest results.

    Readsget_company_profile

    One-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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Give me a quick profile of Asian Paints — sector, current valuation, and latest margins.
    Also available via REST: /stocks/{q}/profileFull details
  • Read a company's reported figures on energy, water, waste, emissions and staff (its sustainability report, BRSR).

    Readsget_brsr

    Raw BRSR sustainability disclosures

    USE WHEN

    Read reported emissions, energy, water, waste, workforce and other BRSR figures from company filings.

    PARAMETERS

    get_brsr parameters
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    yearsintegerNo3Lookback window, clamped 1–10.
    include_rawbooleanNofalseInclude 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.

    EXAMPLE PROMPTS

    • Show the latest BRSR energy and emissions figures for Reliance.
    Also available via REST: /stocks/{q}/brsrFull details
  • See the business figures a company chooses to report, over time.

    Readsget_company_operating_metrics

    Source-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
    NameTypeRequiredDefaultDescription
    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_onlybooleanNofalseReturn only the latest observation per requested metric.
    limitintegerNo100Maximum 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.

    EXAMPLE PROMPTS

    • Show the latest disclosed operating metrics for this company and their source context.
    Full details
  • Get one report on a company that links each figure to its source.

    Readsget_company_report

    Canonical 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    daysintegerNo90Disclosure/reporting window, clamped 1–365.
    detailstringNocompact"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.

    EXAMPLE PROMPTS

    • Build a source-linked company report for RELIANCE using the last 90 days of relevant disclosures.
    Full details
  • See how a company's price compared with its profit and sales over time.

    Readsget_valuation_history

    Point-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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    daysintegerNo365Lookback window, clamped 1–1825.
    intervalstringNodailydaily | 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.

    EXAMPLE PROMPTS

    • Show five years of monthly point-in-time valuation history for TCS.
    Full details

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_comparison

    Auto-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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    limitintegerNo8Max 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.

    EXAMPLE PROMPTS

    • Compare HDFC Bank against its peers on PE, PB and ROE.
    Also available via REST: /stocks/{q}/peersFull details
  • Find similar companies to compare with, and why each was picked.

    Readsget_relevant_peers

    Purpose-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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    purposestringNooperatingoperating | financial | valuation.
    event_contextstringNo—Optional public event/context text used only as declared comparison context.
    limitintegerNo8Peer 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.

    EXAMPLE PROMPTS

    • Find the most relevant operating peers for this company and explain why each peer belongs.
    Full details

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 what share of a company the promoters, foreign investors, funds and the public hold, over time.

    Readsget_shareholding

    Promoter, FII, DII and public holding over time

    USE WHEN

    Track how promoter, FII, DII and public ownership has shifted quarter to quarter — the raw holding percentages as disclosed.

    PARAMETERS

    get_shareholding parameters
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    limitintegerNo8Number of quarters, newest first, 1 to 20.

    RESPONSE DATA

    • periods — period_end, promoter_pct, fii_pct, dii_pct, public_category_total_pct, and a pledge/lock-in detail breakdown when filed.

    NOTES

    • Filed quarterly — this updates roughly every 90 days.

    EXAMPLE PROMPTS

    • How has promoter and FII holding in Adani Power changed over the last two years?
    Also available via REST: /stocks/{q}/shareholdingFull details
  • See how much of the promoters' stake is pledged against loans, over time.

    Readsget_pledge_trend

    Promoter 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    limitintegerNo12Number 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.

    EXAMPLE PROMPTS

    • Is promoter pledge in this company rising or falling?
    Also available via REST: /stocks/{q}/pledge-trendFull details
  • See which commodity, currency or interest-rate changes a company's business is linked to, with the evidence.

    Readsget_company_exposures

    Reviewed 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • What reviewed macro-factor exposures are documented for this company?
    Full details
  • See shares that promoters and directors disclosed buying, selling or pledging.

    Readsget_insider_trades

    Disclosed 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
    NameTypeRequiredDefaultDescription
    symbolstring | nullNo—NSE symbol, ISIN or BSE code; omit for the whole market.
    daysintegerNo30Trade-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.
    categorystringNopromoterspromoters | directors_kmp | designated | relatives | all.
    sidestringNotradestrades (buys and sells) | buy | sell | pledge | all.
    min_value_inrnumber | nullNo—Drop trades smaller than this value in rupees.
    include_derivativesbooleanNofalseInclude derivative trades; equity only by default.
    group_bystringNotradetrade (newest first) | company (buy, sell and net value per company).
    limitintegerNo1001 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.

    EXAMPLE PROMPTS

    • Have the promoters of Adani Ports bought or sold shares in the last 30 days?
    Full details

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_dividends

    Dividend 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    yearsintegerNo5Lookback 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.

    EXAMPLE PROMPTS

    • What dividends has Infosys paid over the last 5 years, and what's the trailing yield?
    Also available via REST: /stocks/{q}/dividendsFull details
  • See splits, bonus shares (free extra shares), buybacks and mergers in one timeline.

    Readsget_corporate_actions

    Full 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    yearsintegerNo5Lookback 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.

    EXAMPLE PROMPTS

    • Has this company done a stock split, bonus issue or buyback in the last 5 years?
    Also available via REST: /stocks/{q}/corporate-actionsFull details
  • See a company's latest announcements to the exchange.

    Starts filing workget_stock_events

    Recent 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    daysintegerNo30Window 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.

    EXAMPLE PROMPTS

    • What has this company announced to the exchange in the last month?
    Also available via REST: /stocks/{q}/eventsFull details
  • See which companies report results in the next two weeks.

    Readsget_upcoming_results

    Board-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
    NameTypeRequiredDefaultDescription
    daysintegerNo14Look-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.
    limitintegerNo501 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.

    EXAMPLE PROMPTS

    • Which companies are announcing results in the next two weeks?
    Also available via REST: /results-calendarFull details
  • Read the key facts from one company filing, with the source page.

    Starts filing workget_filing_extract

    Grounded 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Extract the reported facts from this company's latest investor presentation filing.
    Also available via REST: /stocks/{q}/filings/{news_id}/extractFull details
  • See the categories exchange announcements are sorted into.

    Readslist_announcement_buckets

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

    EXAMPLE PROMPTS

    • What announcement categories can I explore?
    Also available via REST: /bucketsFull details
  • Browse recent announcements from all companies in one category.

    Starts filing workget_announcement_bucket

    Market-wide disclosures by category

    USE WHEN

    Browse recent exchange announcements grouped by a known disclosure bucket.

    PARAMETERS

    get_announcement_bucket parameters
    NameTypeRequiredDefaultDescription
    bucketstringYes—One of order-receipts, fundraise, credit-rating, acquisitions or management-changes (the ids list_announcement_buckets returns).
    daysintegerNo7Lookback 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.

    EXAMPLE PROMPTS

    • Show recent major order-win announcements across the market.
    Also available via REST: /buckets/{bucket}Full details
  • See results, dividends, splits and other company events for a date range.

    Readsget_market_calendar

    Market-wide event calendar

    USE WHEN

    Bring results, dividends, splits, bonuses, demergers and other market events into one date range.

    PARAMETERS

    get_market_calendar parameters
    NameTypeRequiredDefaultDescription
    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.
    limitintegerNo1501 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.

    EXAMPLE PROMPTS

    • What Indian stock-market events are scheduled for next week?
    Also available via REST: /calendarFull details
  • See open, upcoming and recent IPOs: dates, price range and listing facts.

    Readsget_ipos

    Upcoming and recently listed IPO facts

    USE WHEN

    Read IPO status, dates, price bands, issue details and listing facts where available.

    PARAMETERS

    get_ipos parameters
    NameTypeRequiredDefaultDescription
    statusstringNo—"upcoming" | "open" | "listing_pending" | "listed"; omitted returns all four. Unknown value is rejected.
    limitintegerNo1001 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.

    EXAMPLE PROMPTS

    • Which Indian IPOs are upcoming or currently open?
    Also available via REST: /iposFull details
  • Read the key facts from several filings of one company at once.

    Starts filing workget_filing_extracts

    Read 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Read the extracted facts from these filings of this company and list any still pending.
    Full details
  • See the history around one company announcement, and what is still unanswered.

    Readsget_event_context

    Historical 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show the historical context for this filing news_id and the related disclosure timeline.
    Full details
  • Search the text of a company's filings and get the matching passages with page numbers.

    Readssearch_company_disclosures

    Search 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
    NameTypeRequiredDefaultDescription
    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.
    limitintegerNo10Passages 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.

    EXAMPLE PROMPTS

    • Search this company's indexed filings for 'capacity expansion' and show the source pages.
    Full details
  • Find a company's annual reports, results, presentations and call transcripts.

    Readsget_company_documents

    A 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code.
    daysintegerNo365Trailing 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.
    limitintegerNo60Maximum 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.

    EXAMPLE PROMPTS

    • Where are Infosys's latest annual report and earnings call transcript?
    Full details

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_deals

    Bulk 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    deal_typestringNo—"bulk" or "block"; omitted returns both.
    daysintegerNo90Trailing lookback window, clamped 1–1825.
    limitintegerNo100Max 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.

    EXAMPLE PROMPTS

    • Show bulk and block deals for the last two weeks.
    Also available via REST: /stocks/{q}/bulk-block-dealsFull details
  • See open positions in futures and options (F&O) on a stock or an index.

    Readsget_derivatives_positioning

    Per-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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show the latest derivatives positioning for NIFTY and RELIANCE.
    Also available via REST: /stocks/{q}/derivatives-positioningFull details
  • See how foreign institutions, domestic institutions and others hold futures and options positions, day by day.

    Readsget_fo_participant_activity

    Market-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
    NameTypeRequiredDefaultDescription
    daysintegerNo10Trailing 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.

    EXAMPLE PROMPTS

    • Show FII and client F&O positioning for the last 30 days.
    Also available via REST: /fo-participant-activityFull details
  • See how an index's price compared with its profit, net assets and dividends over the years.

    Readsget_index_valuation

    Index valuation history

    USE WHEN

    Read NSE-sourced index-level PE, PB and dividend-yield time series, including sector indices.

    PARAMETERS

    get_index_valuation parameters
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show NIFTY IT valuation history over the last year.
    Also available via REST: /index-valuations/{index}Full details
  • See which indices have that valuation history.

    Readslist_index_valuations

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

    EXAMPLE PROMPTS

    • Which indices have valuation history available?
    Also available via REST: /index-valuationsFull details
  • See the India VIX over time, the NSE's gauge of how sharply the market swings.

    Readsget_india_vix

    India VIX history

    USE WHEN

    Read the NSE-sourced India VIX time series as a market-volatility fact.

    PARAMETERS

    get_india_vix parameters
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show India VIX over the last 30 days.
    Also available via REST: /india-vixFull details
  • See how many companies rose, fell or were unchanged each day.

    Readsget_market_breadth

    Whole-market advance/decline breadth

    USE WHEN

    Read daily advancing, declining and unchanged security counts across the market.

    PARAMETERS

    get_market_breadth parameters
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show market breadth for the last two weeks.
    Also available via REST: /market-breadthFull details
  • See official figures for inflation, economic growth, industrial output and crude oil prices.

    Readsget_macro_indicators

    Official 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
    NameTypeRequiredDefaultDescription
    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.
    limitintegerNo200Clamped 1–2000, newest period first.

    RESPONSE DATA

    • Officially reported macro observations with period, series, value, unit and source.

    EXAMPLE PROMPTS

    • Show India's CPI, GDP growth and crude-oil indicators for the latest available periods.
    Also available via REST: /macro/indicatorsFull details
  • See the official daily rupee reference rates against major currencies.

    Readsget_fx_reference_rates

    FBIL INR reference exchange rates

    USE WHEN

    Read daily official INR reference rates for supported currency pairs.

    PARAMETERS

    get_fx_reference_rates parameters
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show the USD/INR reference rate for the last month.
    Also available via REST: /macro/fx-ratesFull details
  • See daily buying and selling by foreign investors in each sector. The source covers only part of the market.

    Readsget_sector_fii_flow

    Daily 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Which sectors saw the most reported FII activity in the latest CDSL data held?
    Also available via REST: /fii-dii/sectorsFull details
  • Older name for get_stock_fii_flow. Use that one.

    Readsget_fii_activity

    Deprecated 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code.
    daysintegerNo90Series 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.

    EXAMPLE PROMPTS

    • Show the reported FII activity for RELIANCE in the latest CDSL data held.
    Also available via REST: /stocks/{q}/fii-activityFull details
  • See foreign portfolio investment in each sector, fortnight by fortnight.

    Readsget_sector_fpi_investment

    Fortnightly 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
    NameTypeRequiredDefaultDescription
    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.
    instrumentstringNoequityReported 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_subsectorsbooleanNofalseInclude 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.

    EXAMPLE PROMPTS

    • Show the latest fortnightly equity FPI net investment by NSDL sector.
    Full details
  • See a company's linked commodity, currency or rate factors next to official figures for them, where the data allows.

    Readsget_company_macro_exposures

    Company 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Show this company's reviewed crude-oil and USD/INR exposures with eligible official macro context.
    Full details
  • See which stocks are barred from new futures and options positions in the latest list.

    Readsget_fno_ban_list

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

    EXAMPLE PROMPTS

    • Which securities are on the latest available NSE F&O ban list?
    Full details
  • See daily buying and selling by foreign (FII) and domestic (DII) institutions across the whole market.

    Readsget_market_fii_dii_flow

    Market-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
    NameTypeRequiredDefaultDescription
    from_datedateNo—Optional ISO start date; omitted uses the trailing window.
    to_datedateNo—Optional ISO end date; the window is capped at 366 days.
    segmentstringNocashCash 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.

    EXAMPLE PROMPTS

    • Show market-wide FII and DII cash flows for the last month.
    Also available via REST: /fii-diiFull details
  • See daily buying and selling by foreign investors in one company. The source covers only part of the market.

    Readsget_stock_fii_flow

    Daily 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
    NameTypeRequiredDefaultDescription
    querystringYes—One company: NSE symbol, ISIN or BSE code. For a name, call search_stocks first.
    daysintegerNo90Series 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.

    EXAMPLE PROMPTS

    • Show reported FII transaction flow for RELIANCE in the latest CDSL data held.
    Full details
  • See which stocks in an index rose or fell most, or traded most, in the last session.

    Readsget_top_movers

    Mechanically 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
    NameTypeRequiredDefaultDescription
    indexstringNoNIFTY 500Index name returned by list_indices, matched whatever the case; a name that is not recognised returns the valid ones.
    metricstringNopct_changepct_change | change | turnover | volume.
    directionstringNodescdesc for largest/highest activity or asc for lowest/losers.
    limitintegerNo201 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.

    EXAMPLE PROMPTS

    • Show the largest NIFTY 500 gainers by day percentage change, limited to 20 rows.
    Full details
  • Compare indices on return, swings and their biggest fall over the same period.

    Readscompare_indices

    Compare 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
    NameTypeRequiredDefaultDescription
    indicesstring[]Yes—2 to 10 NSE index names, such as "Nifty 50" and "Nifty Bank" (case-insensitive; a miss lists the valid names).
    daysinteger | nullNo365Days 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.

    EXAMPLE PROMPTS

    • How did Nifty Bank do against Nifty IT over the last year?
    Full details
  • See NSE's market cap and shares in issue for a company over time.

    Readsget_market_cap_history

    NSE'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
    NameTypeRequiredDefaultDescription
    symbolstring | nullNo—One NSE security; omit for the largest companies on a day.
    daysinteger | nullNo30Window 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).
    limitintegerNo251 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.

    EXAMPLE PROMPTS

    • How has Reliance's market cap changed over the last 30 days?
    Full details
  • See which stocks traded the most on a day, by volume, value or delivery.

    Readsget_market_ranking

    NSE 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
    NameTypeRequiredDefaultDescription
    datedate | nullNo—ISO date; default the newest stored day.
    metricstringNovolumevolume | turnover | num_trades | deliv_pct | pct_change.
    directionstringNodescdesc | asc.
    limitintegerNo251 to 100.
    instrument_classstringNoequityequity (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.

    EXAMPLE PROMPTS

    • Which stocks traded the most on NSE today?
    Full details
  • See which stocks hit their upper or lower price limit (circuit) on a day.

    Readsget_price_band_hits

    Stocks 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
    NameTypeRequiredDefaultDescription
    datedate | nullNo—The day to list every hit (default the newest day).
    symbolstring | nullNo—One security's hits over a window instead.
    daysinteger | nullNo90Window for one symbol, up to 1825.
    directionstringNoallupper | lower | all.
    limitintegerNo2001 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.

    EXAMPLE PROMPTS

    • Which stocks hit the upper or lower circuit today?
    Full details

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_watchlist

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

    EXAMPLE PROMPTS

    • Show my DalalOS watchlist.
    Full details
  • Save stocks to your watchlist.

    Edits your watchlistadd_to_watchlist

    Save 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Add RELIANCE, TCS and INFY to my DalalOS watchlist.
    Full details
  • Remove a stock from your watchlist.

    Edits your watchlistremove_from_watchlist

    Remove a stock from your watchlist

    USE WHEN

    Remove one or more saved symbols from your DalalOS watchlist.

    PARAMETERS

    remove_from_watchlist parameters
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Remove INFY from my DalalOS watchlist.
    Full details

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_feedback

    Report 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
    NameTypeRequiredDefaultDescription
    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.

    EXAMPLE PROMPTS

    • Report to DalalOS that the ROE it gave me for INFY looks different from the annual report.
    Full details

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.

    Readsping

    Health check

    USE WHEN

    Confirms the server is reachable — useful when wiring up a new MCP client.

    PARAMETERS

    No parameters.

    RESPONSE DATA

    • message: "pong".

    EXAMPLE PROMPTS

    • Ping the server.
    Full details
  • See when each kind of data was last refreshed and whether any is out of date.

    Readsget_data_freshness

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

    EXAMPLE PROMPTS

    • How fresh is the underlying data right now?
    Also available via REST: /freshnessFull details

How it works

01

Connect once

Add DalalOS to your AI assistant and sign in.

02

Ask in plain English

Your assistant works out which tools answer the question.

03

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