Historical Data

Historical Data APIs

method	path	description
GET	https://api.mstock.trade/openapi/typea/instruments/historical/{exchange}/{instrument_token}/{interval}?from={2024-08-02+09:15:00}&to={2024-08-04+09:20:00}	View historical Data

The historical data API provides the historical data for instruments across various exchange segment.

Historical Data Limit

The maximum number of historical data bars retrievable per request is 1000, regardless of the timeframe. Please adjust your queries accordingly.

Query Parameter -

Field	Type	Description
Exchange	string	Exchange segment (NSE, NFO, BSE, BFO)
instrument_token	string	instrument_token based on Exchange Security file
interval	string	Interval frame (minute, day, 3minute, 5minute, 10minute, 15minute, 30minute and 60minute)

Request Headers -

• X-Mirae-Version: Specifies the version of the API being used. In this case, it is set to 1.

• Authorization: A token-based authentication header. The format is token api_key:access_token.

cURLNode.jsPythonJava

curl --location 'https://api.mstock.trade/openapi/typea/instruments/historical/NSE/11536/60minute?from=2024-08-02+09%3A15%3A00&to=2024-08-04+09%3A20%3A00' \
--header 'X-Mirae-Version: 1' \
--header 'Authorization: token api_key:access_token'

import axios from 'axios';

const response = await axios.get('https://api.mstock.trade/openapi/typea/instruments/historical/NSE/11536/60minute', {
params: {
    'from': '2024-08-02 09:15:00',
    'to': '2024-08-04 09:20:00'
},
headers: {
    'X-Mirae-Version': '1',
    'Authorization': 'token access_token'
}
});

import http.client

conn = http.client.HTTPSConnection('api.mstock.trade')
headers = {
    'X-Mirae-Version': '1',
    'Authorization': 'token access_token',
}
conn.request(
    'GET',
    'openapi/typea/instruments/historical/NSE/11536/60minute?from=2024-08-02+09%3A15%3A00&to=2024-08-04+09%3A20%3A00',
    headers=headers
)
response = conn.getresponse()

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
    .followRedirects(HttpClient.Redirect.NORMAL)
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mstock.trade/openapi/typea/instruments/historical/NSE/11536/60minute?from=2024-08-02+09%3A15%3A00&to=2024-08-04+09%3A20%3A00"))
    .GET()
    .setHeader("X-Mirae-Version", "1")
    .setHeader("Authorization", "token access_token")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Query Parameter -

Field	Type	Description
fromdate	string	2024-01-06
todate	string	2025-01-07

Request Body - This endpoint does not require a request body or additional parameters in the query string for the retrieval of orders.

Request Response -

The response of the request will be based on authentication outcome.

• Success (HTTP Status 200): On successful order update, the server returns a JSON object containing the order ID and status.

{
    "status": "success",
    "data": {
        "candles": [
            [
                "2024-01-01T09:15:00+05",
                3790,
                3832,
                3773.35,
                3803,
                825219
            ],
            [
                "2024-01-02T09:15:00+05",
                3811.1,
                3811.1,
                3767.25,
                3781.15,
                1343722
            ]
        ]
    }
}

• Failure (HTTP Status 401): If the order fails due to invalid parameters, authentication issues, or other errors, the server will return an error message with below json format.

{
    "status": "error",
    "message": "Invalid request. Please try again.",
    "error_type": "TokenException",
    "data": null
}

• Failure (HTTP Status 400): If the API Key is Invalid or expired.

{
    "status": "error",
    "message": "API is suspended/expired for use. Please check your API subscription and try again.",
    "error_type": "APIKeyException",
    "data": null
}