Chart Data API

📊 Overview

This API is used to fetch intraday and historical chart data for supported exchanges and instruments.

📝 Endpoint Details

Property	Value
Name	Chart Data
Method	GET
Description	Fetches intraday & historic chart data

🌐🔗 Base URL Format

<protocol>://<host name>:<service port>/:version/chart/data/: exchange/: token/: period/: interval/:source?from=2021-05-25 09:00:00&to=2021-05-28 17:00:00

📜 Example Request

https://demo.synapsewave.com:3000/v1/chart/data/NSE_EQ/22/1/MIN/DIET?from=2021-05-25 09:00:00&to=2021-05-28 17:00:00

Request Format

🎫 Headers

Content-Type: application/json Authorization: Bearer <access_token>

Pass the access token as a Bearer token in the Authorization header. Token generation is explained in Access Key Generation Flow.

🛣️ URL Path Parameters

Parameter	Type	Required	Description	Values / Examples
version	varchar	Yes	API Version	v1
exchange	varchar(15)	Yes	Exchange name	NSE_EQ, NSE_FO, BSE_EQ, BSE_FO, MCX_FO, NCDEX_FO, NSE_CUR, NSE_COMM, BSE_CUR, BSE_COMM, ICEX_FO, MSE_EQ, MSE_FO, MSE_CUR, NSE_OTS
token	int	Yes	Instrument token	e.g., 22
period	varchar	Yes	Candle record period	See mapping below
interval	varchar	Yes	Candle record interval	1 MIN is intraday; others are historical
source	varchar	Yes	Source of request	DIET, WEBAPI, MOBILEAPI, AERO, WAVE, WAVE2

🛠️ Period & Interval Mapping

Period	Interval
1	MIN
1	DAY
1	WEEK
1	MONTH
1	YEAR

❓ Query String Parameters

Parameter	Type	Mandatory	Description	Example / Format
from	varchar	Optional	Start date-time of records	"YYYY-MM-DD HH:mm:ss" e.g., "2021-05-25 09:00:00"
to	varchar	Mandatory	End date-time of records	"YYYY-MM-DD HH:mm:ss" e.g., "2021-05-28 17:00:00"
countback	int	Mandatory	Number of candles to return	e.g., 100

Response

🌏 Schema

Key	Type	Description
status	string	Status of the request: success / failure
message	string	Error message in case of failure
data	array	Array of candle objects (O, H, L, C, V, DT)

Example

{
  "status": "success",
  "message": "",
  "data": [
    {
      "O": 78.53,
      "H": 78.66,
      "L": 78.03,
      "C": 78.43,
      "V": 4834800,
      "DT": "2021-05-28 17:00:00"
    }
  ]
}