Downstox public API

Free, unauthenticated, read-only JSON endpoints for Indian stock market data. No API key, no signup, no cookie. Machine-readable description at /openapi.json (OpenAPI 3.1) and a catalog record at /.well-known/api-catalog (RFC 9727).

What this is, and is not

Every endpoint listed on this page is public, unauthenticated and read-only. Calling any of them requires no API key, no account and no cookie. There is no published rate-limit guarantee, so callers should cache responses rather than poll aggressively.

Data on this page is for information only and is not investment advice. Downstox is not a SEBI-registered investment adviser, research analyst or stockbroker.

Downstox also has separate authenticated broker-trading endpoints, gated on a signed httpOnly cookie minted by a broker's own OAuth callback (Downstox is an OAuth client of brokers, never an authorization server), plus internal admin endpoints. Neither family is listed here or in openapi.json, because neither is callable by an unauthenticated agent.

robots.txt disallows crawling /api/. That line manages crawl budget for search-engine crawlers walking JSON; it is not an access-control rule, and it does not stop a script or agent from calling these endpoints directly with a normal GET request.

Endpoints

GET/api/india-markets/overview

NIFTY, SENSEX and GIFT Nifty levels, a sector heatmap and market news.

https://downstox.com/api/india-markets/overview
GET/api/markets/sentiments

One-line sentiment label and reason for 26 world indices.

https://downstox.com/api/markets/sentiments
GET/api/stocks/{symbol}

Fundamentals, sector and per-broker MTF margin rates for one NSE symbol. 404s for an unknown symbol.

https://downstox.com/api/stocks/RELIANCE
GET/api/mf/schemes

Paginated AMFI mutual fund scheme list with returns. Supports q, category, page, limit.

https://downstox.com/api/mf/schemes?q=bluechip&limit=2
GET/api/mf/scheme/{code}

Full NAV history for one scheme code. 404s for an unknown code.

https://downstox.com/api/mf/scheme/148101
GET/api/ipo/gmp

Grey market premium for current and upcoming IPOs.

https://downstox.com/api/ipo/gmp
GET/api/screener/count

How many stocks the full screener covers, and when that count last refreshed.

https://downstox.com/api/screener/count
GET/api/holidays/

NSE trading holiday calendar plus the current market-open status.

https://downstox.com/api/holidays/
GET/api/breakouts/

Stocks breaking their 10/20/50/100/200-day and 52-week highs.

https://downstox.com/api/breakouts/
GET/api/fiidii/daily

Most recent day's FII/DII net cash-market flows, in INR crore.

https://downstox.com/api/fiidii/daily
GET/api/other-side/

Latest participant (FII/DII/retail) open-interest regime read.

https://downstox.com/api/other-side/
GET/api/us-markets/multibaggers

US stocks bucketed by trailing 1-year return.

https://downstox.com/api/us-markets/multibaggers
GET/api/dividend-aristocrats/

NSE stocks with a long streak of consecutive dividend-paying years.

https://downstox.com/api/dividend-aristocrats/
GET/api/superinvestors/

Curated list of well-known investors and their notable public holdings.

https://downstox.com/api/superinvestors/
GET/api/superinvestors/{slug}

Full profile for one curated investor. 404s for an unknown slug.

https://downstox.com/api/superinvestors/rekha-jhunjhunwala
GET/api/announcements/

Merged NSE and BSE corporate announcements feed. Supports symbol and limit.

https://downstox.com/api/announcements/
GET/api/promises/

Management statements from filings, tagged with a target metric and status.

https://downstox.com/api/promises/
GET/api/weekly-outlook/

Weekly technical read (RSI, ATR, pivots, regime) for major indices.

https://downstox.com/api/weekly-outlook/
GET/api/closing-auction/status

Whether today's closing-auction tick capture ran, and session coverage.

https://downstox.com/api/closing-auction/status
GET/api/blog

Published blog posts, newest first. Supports limit, offset, category.

https://downstox.com/api/blog?limit=1
GET/api/pre-open/base-rates

Historical hit-rate of NSE pre-open buy/sell-leaning signals closing up.

https://downstox.com/api/pre-open/base-rates

Full parameter lists, response field descriptions and both verified success and error examples are in openapi.json. Questions or requests for a new public endpoint can go through the feedback form.