REST API
Predictable data over HTTP.
Use the REST API from applications, notebooks, backend services and deterministic agent tools.
Authentication
Send X-API-Key: YOUR_API_KEY with every request. Authorization: Bearer YOUR_API_KEY is also accepted.
Response envelope
Successful JSON responses use {"data": ..., "meta": ...}. Metadata carries the response timestamp and endpoint-specific context such as counts, ticker, period, basis and dataset.
Endpoints
GET
/v1/companiesSearch and enumerate the canonical Indian listed-company master.→GET/v1/instrumentsFind tradable securities and exchange identifiers attached to companies.→GET/v1/pricesRetrieve the latest known quote or historical OHLCV candles.→GET/v1/financialsRetrieve normalized income statement, balance sheet and cash-flow facts.→GET/v1/financial-metricsGet ratios and growth measures derived from canonical financial facts.→GET/v1/shareholdingRetrieve promoter, public and institutional ownership snapshots.→GET/v1/filingsFind the source documents behind company facts and disclosures.→GET/v1/corporate-actionsRetrieve dividends, splits, bonuses, rights issues and buybacks.→GET/v1/eventsRead company disclosures as one normalized event stream.→POST/v1/searchResolve companies, securities, filings and phrases across the corpus.→POST/v1/queryAsk a market question and receive structured facts plus evidence.→POST/v1/askStream an evidence-grounded answer with visible execution steps.→Errors and limits
401 | Missing, invalid or revoked key |
404 | Company, instrument or source record not found |
422 | Request validation failed |
429 | Per-minute ceiling or monthly allowance reached; rejected requests are not billed |
503 | Requested dataset is unavailable |
One authenticated REST data call counts once. Responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for the minute, plus X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset for the month.