Historical Data

1. Introduction

The Historical Data API returns historical candle (OHLCV) data for an instrument. The response is a single candles array — one fixed-order positional row per candle — with ISO 8601 timestamps.

2. API Endpoint

GET <Base URL>/market-data/1.0/historical/details?neosymbol=<exchange_segment>|<instrument_token>&fromdate=<YYYY-MM-DD>&todate=<YYYY-MM-DD>&interval=<interval>

Replace <Base URL> with the relevant Kotak environment base URL provided in response from the /tradeApiValidate API.

Key points about endpoint structure:

neosymbol, fromdate, todate and interval are all mandatory.
neosymbol is formatted as <exchange_segment>|<instrument_token>, e.g. nse_cm|1333. The pipe can be sent as a literal | (or percent-encoded as %7C).
Instrument token: use the token from the instrument/scrip master file.
Supported exchange segments (string): nse_cm (NSE Cash), nse_fo (NSE F&O), bse_cm (BSE Cash), bse_fo (BSE F&O) only.
Only active contracts with a valid neo symbol return historical data — expired or delisted instruments will not.
Expected values for interval are (string):
- 1min, 3min, 5min, 10min, 15min, 30min, 60min
- D (daily)
- W (weekly)

Date Range Limits

The maximum date range per request depends on the interval. A request exceeding the limit is rejected by the backend.

Interval	Max Range	Example Use Case
`1min`, `3min`, `5min`	30 days	Intraday trading charts
`10min`, `15min`	60 days	Short-term analysis
`30min`, `60min`	90 days	Medium-term analysis
`D` (daily)	180 days	Long-term charts
`W` (weekly)	180 days	Trend analysis

3. Headers

Name	Type	Description
Authorization	string	Token provided in your NEO API dashboard - use plain token
Content-Type	string	`application/json`

4. Request

Example Request: