REST REFERENCE

DalalOS REST API

Use the REST surface when your script, dashboard, or service does not speak MCP. It exposes the same read-only data functions and JSON envelope under /v1.

Base URL: https://mcp.dalalos.in/v1. The live data surface currently documents all 44 GET routes.

Authentication

Send an API key from your dashboardas Authorization: Bearer isk_live_…. Keep keys server-side; never put them in browser code.

Envelope and example

curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/RELIANCE/quote"

{"status":"success","data":{...},"source":"nse-bhavcopy","cached_at":"…","stale":false}

Errors use {"status":"error","error":"…","reason_code":"…"}. Values are raw disclosed facts and mechanically-computed ratios; the API does not provide investment advice or recommendations.

Endpoint reference

Each route below links to the matching MCP tool reference. The REST and MCP surfaces use the same underlying data function.

Search & discovery

Search & discovery REST endpoints
Method	Path	Purpose	MCP tool
GET	`/search`	Search securities	search-stocks
GET	`/screen`	Screen stocks by mechanical filters	screen-stocks
GET	`/sectors`	List sector and industry aggregates	get-sector-overview
GET	`/sectors/{sector}`	Get one sector or industry aggregate	get-sector-overview
GET	`/indices`	List tracked indices	list-indices
GET	`/indices/{index}/constituents`	List index constituents	list-index-constituents
GET	`/indices/{index}/heatmap`	Get index constituents with multi-horizon returns	get-market-heatmap
GET	`/presets`	List preset screens	list-preset-screens
GET	`/presets/{name}`	Run a preset screen	run-preset-screen

Quotes & prices

Quotes & prices REST endpoints
Method	Path	Purpose	MCP tool
GET	`/quotes`	Get batch quotes	get-batch-quotes
GET	`/stocks/{q}/quote`	Get the latest end-of-day quote	get-stock-quote
GET	`/stocks/{q}/price-history`	Get historical OHLCV bars	get-price-history
GET	`/stocks/{q}/returns`	Get mechanical return statistics	get-returns
GET	`/stocks/{q}/delivery-trends`	Get delivery trends	get-delivery-trends
GET	`/stocks/{q}/technical-indicators`	Get technical indicators	get-technical-indicators

Financials & ratios

Financials & ratios REST endpoints
Method	Path	Purpose	MCP tool
GET	`/stocks/{q}/financials`	Get financial statements and ratios	get-financials
GET	`/stocks/{q}/financial-trends`	Get financial trends	get-financial-trends
GET	`/stocks/{q}/profile`	Get a company profile	get-company-profile
GET	`/stocks/{q}/brsr`	Get BRSR filing data	get-brsr

Peer comparison

Peer comparison REST endpoints
Method	Path	Purpose	MCP tool
GET	`/stocks/{q}/peers`	Compare company peers	get-peer-comparison

Ownership & risk

Ownership & risk REST endpoints
Method	Path	Purpose	MCP tool
GET	`/stocks/{q}/shareholding`	Get shareholding data	get-shareholding
GET	`/stocks/{q}/pledge-trend`	Get promoter pledge trends	get-pledge-trend

Corporate actions & events

Corporate actions & events REST endpoints
Method	Path	Purpose	MCP tool
GET	`/stocks/{q}/dividends`	Get dividend disclosures	get-dividends
GET	`/stocks/{q}/corporate-actions`	Get corporate actions	get-corporate-actions
GET	`/stocks/{q}/events`	Get corporate events and filings	get-stock-events
GET	`/results-calendar`	Get upcoming results	get-upcoming-results
GET	`/stocks/{q}/filings/{news_id}/extract`	Extract a filing	get-filing-extract
GET	`/calendar`	Get the market event calendar	get-market-calendar
GET	`/ipos`	Get IPO calendar data	get-ipos
GET	`/buckets`	List announcement buckets	list-announcement-buckets
GET	`/buckets/{bucket}`	Get one announcement bucket	get-announcement-bucket

Market context

Market context REST endpoints
Method	Path	Purpose	MCP tool
GET	`/fii-dii`	Get FII/DII flow	get-fii-dii-flow
GET	`/fii-dii/sectors`	Get sector FII flow	get-sector-fii-flow
GET	`/stocks/{q}/fii-activity`	Get security FII activity	get-fii-activity
GET	`/index-valuations`	List index valuations	list-index-valuations
GET	`/index-valuations/{index}`	Get one index valuation	get-index-valuation
GET	`/india-vix`	Get India VIX data	get-india-vix
GET	`/market-breadth`	Get market breadth	get-market-breadth
GET	`/fo-participant-activity`	Get F&O participant activity	get-fo-participant-activity
GET	`/macro/indicators`	Get macro indicators	get-macro-indicators
GET	`/macro/fx-rates`	Get FX reference rates	get-fx-reference-rates
GET	`/stocks/{q}/bulk-block-deals`	Get bulk and block deals	get-bulk-block-deals
GET	`/stocks/{q}/derivatives-positioning`	Get derivatives positioning	get-derivatives-positioning

System

System REST endpoints
Method	Path	Purpose	MCP tool
GET	`/freshness`	Get data freshness	get-data-freshness

MCP-only account tools

ping, get_watchlist, add_to_watchlist, andremove_from_watchlist are account-scoped MCP tools and have no public REST equivalent. See the tool reference for their behavior.

KEEP EXPLORING

Connect your AI to Indian stock market data

Get started free →