Tool reference
Indian stock returns, volatility and drawdown
get_returns — Mechanically-computed returns, volatility and drawdown. This is a read-only research or operational tool. It does not place trades or issue investment recommendations.
What you can ask
Connect DalalOS to Claude or ChatGPT and ask in plain English; the assistant calls get_returns for you and answers from the figures it returns.
EXAMPLE PROMPTS
- What's the 1-year and 3-year return for this stock, and its max drawdown?
- What were the 1-month, 6-month and 1-year returns for Bajaj Finance?
- Show the annualised volatility, CAGR and maximum drawdown for Sun Pharma.
Parameters and response fields
get_returns
Mechanically-computed returns, volatility and drawdownUSE WHEN
1W/1M/3M/6M/1Y/YTD returns, CAGR, volatility and max drawdown — computed from the price series, not opinion.
PARAMETERS
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Company name, symbol, code or ISIN. |
RESPONSE DATA
- returns (1W/1M/3M/6M/1Y/YTD/max), cagr, annualized_volatility, max_drawdown, high_52w, low_52w.
NOTES
- A window spanning a major corporate action (e.g. a demerger) is nulled rather than reported as a distorted figure.
/stocks/{q}/returnsSee the same data on DalalOS
Public pages that need no sign-in and show data from the same source.
Related tools
KEEP EXPLORING
Connect your AI to Indian stock market data
Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.