samco-bridge-node

v3.1.0

Published

a month ago

SAMCO Bridge Node.js SDK for Trade API integration

0High
0Medium
0Low

stocknote api stocknote nodejs sdk samco api trading samco algo trading stock markets samco Nodejs sdk samco trading stocknote api sdk nse bse

StockNoteBridge - Node.js Bridge for Stocknote API

Official Node.js Bridge for accessing Stocknote API

This documentation covers details of the Node.js bridge / SDK provided by SAMCO, for accessing the SAMCO Trade API.

Overview

Node.js SDK is created for users to easily access our Stocknote API platform from Node.js/TypeScript based applications.
Node.js SDK will be exposed as a downloadable npm package
Install the npm package in your project and access the trade APIs using the inbuilt classes in Node.js SDK
Different classes and methods are exposed in the SDK for handling different Trade API
As an initial step, users need to use the Login method for connecting to APIs and in the response object you will get user session identifier. Using the session identifier, users can access other API's
With StockNote API being a REST based interface and it uses JSON request and response messages, Node.js SDK provides request and response interfaces as native TypeScript types
For specific details on parameters passed on the request, and details about API response, please refer our Trade API documentation.

Note

All API response displayed in this documentation are JSON representation of response objects

Prerequisites

Node.js 18 and above
TypeScript 5.0+ (optional, for TypeScript users)

Prerequisites (One-Time Setup)

The following steps must be completed before using the APIs:

Register Static IP
Register your static IP using the
IP Registration or
IP Update API.
Generate OTP
Generate a One-Time Password (OTP) using the
Generate OTP API.
Generate Secret API Key
Use the OTP from the previous step to generate your Secret API Key using the
Generate Secret API Key API.

Authentication (Required for Login)

Generate Access Token
Call the Generate Access Token API using:
- uid
- secretApiKey (from Generate Secret API Key)
Notes:
- The Secret API Key does not expire and can be reused.
- You can generate multiple access tokens using the same Secret API Key.
- This token is valid for one day.
- It expires before 8:00 AM the next day.
- A new access token must be generated after expiry.
- This access token is required for the Login API.

Steps

Install the npm package

npm install samco-bridge-node

Import and use in your project

import { UserLoginApi, QuoteApi, EXCHANGE_NSE } from "samco-bridge-node";

Or using require:

const { UserLoginApi, QuoteApi, EXCHANGE_NSE } = require("samco-bridge-node");

To change the base URL (default is http://localhost:80):

import { setBaseUrl } from "samco-bridge-node";
setBaseUrl("https://beta-tradeapi.samco.in");

List of supported API

Login
GenerateOtp
GenerateSecretAPIKey
GenerateAccessToken
IpRegistration
IPUpdate
PersonalIndex
SearchEquityDerivative
Quote
IndexQuote
MultiQuote
SpanMargin
OptionChain
FutureChain
UserLimits
PlaceOrder
PlaceOrderBO
PlaceOrderCO
ModifyOrder
OrderBook
TriggerOrders
OrderStatus
CancelOrder
CancelOrderCO
CancelOrderBO
AddGTT
ModifyGTT
DeleteGTT
AddOco
ModifyOco
DeleteOco
ListGttOco
TradeBook
Positions
PositionConversion
PositionSquareOff
Holdings
IntraDayCandleData
IndexIntraDayCandleData
HistoricalCandleData
IndexHistoricalCandleData
Logout

Login Api:

Node.js Bridge allows user authentication using UserLoginApi. A valid StockNote Trading Account and subscription to StockNote API Services is a pre-requisite for successful authentication.

Parameters:

userId, password, yob, accessToken

Login Sample Request:

const userLoginApi = new UserLoginApi();
const loginResponse = await userLoginApi.login({
  userId: "YOUR_USER_ID",
  password: "YOUR_PASSWORD",
  yob: "YOUR_YOB",
  accessToken: "YOUR_ACCESS_TOKEN",
});
const xSessionToken = userLoginApi.getSessionToken()!;

Sample Login Response:

{
    "serverTime": "26/05/20 13:50:32",
    "msgId": "c662bbd1-0b24-4e86-a3d9-8c89d7529f2c",
    "sessionToken": "e0875f4aa3660b72ec636b0553acc7a9",
    "accountID": "client_id",
    "accountName": "client_name",
    "exchangeList": [
        "BSE",
        "MCX",
        "CDS",
        "NSE"
    ],
    "orderTypeList": [
        "L",
        "SL"
    ],
    "productList": [
        "CNC",
        "CO",
        "MIS"
    ]
}

Using the session token users can call other API's through Node.js SDK

GenerateOtp:

The Generate OTP API is used to start the process of getting a secret API key. When this API is called, a One-Time Password (OTP) is sent to the user's registered mobile number and email ID. This OTP is required for the next step of API key generation.

Sample Generate Otp Request:

const otpApi = new GenerateOtpApi();
const otpResponse = await otpApi.generateOTP({ uid: "XX1234" });

Sample Generate Otp Response:

{
    "serverTime": "17/12/25 09:40:58",
    "msgId": "1e439d95-5e57-4810-b57e-df94e74776ea",
    "status": "Success",
    "statusMessage": "OTP sent to your mobile and email."
}

GenerateSecretAPIKey:

The Secret Key Generator API is used to generate a secret API key using a valid user ID and the OTP received from the Generate OTP API. Once the request is successful, the secret API key is sent to the user's registered email ID. Do not share your secret API key with anyone. The secret API key does not have an expiry. You can use the same secret API key to generate the access token. To generate a new secret API key, you must start again with the OTP generation flow.

Sample Generate Secret APIKey Request:

const secretKeyApi = new SecretKeyGenerateApi();
const secretKeyResponse = await secretKeyApi.secretKey({
  uid: "XX1234",
  otp: "XXXX",
});

Sample Generate Secret APIKey Response:

{
    "serverTime": "17/12/25 10:02:41",
    "msgId": "73d115fd-ed3a-47f2-ae04-f40083c3bccf",
    "status": "Success",
    "statusMessage": "The secret API key has been sent to your email."
}

GenerateAccessToken:

The Token API is used to generate an access token using a valid user ID and the secret API key received from the Secret Key Generator API on your registered email ID. The access token is valid for one day. It expires before 8:00 AM the next day. If the access token expires, you can generate a new access token using the same secret API key.

Sample Generate AccessToken Request:

const accessTokenApi = new AccessTokenApi();
const accessTokenResponse = await accessTokenApi.accessToken({
  uid: "XX1234",
  secretApiKey: "XXXXXXXXXXXXXXXXX",
});

Sample Generate AccessToken Response:

{
    "serverTime": "17/12/25 10:15:08",
    "msgId": "66b290f4-343e-4e08-85e5-67f708feb5f0",
    "status": "Success",
    "accessToken": "XXXXXXXXXXXXXiSUg_Ps6A942Lif"
}

IpRegistration:

The Ip Register API is used to register the primary and secondary static IP addresses for a client. Once IPs are registered, the client can access the APIs only from these IP addresses. The IP address must be a valid IPv4 address. If a user tries to access the API from any other IP address, the request will be rejected with an error.

Sample Ip Registration Request:

const ipApi = new IpRegisterApi();
const ipResponse = await ipApi.ipRegister({
  clientId: "XX1234",
  primaryIp: "XXX.XX.XX.XXX",
  secondaryIp: "XXX.XX.XX.XXX",
  password: "XXX@123",
});

Sample Ip Registration Response:

{
    "serverTime": "29/01/26 10:46:06",
    "msgId": "d5f083f3-1b04-4b97-9385-1e578fdfeb7a",
    "status": "Success",
    "statusMessage": "Client IPs registered successfully",
    "data": {
        "user_id": "DV99999",
        "primary_ip": "XXX.XX.XX.XXX",
        "secondary_ip": "XXX.XX.XX.XXX",
        "ip_updated_at": "2026-01-29T05:16:07.000Z"
    }
}

IPUpdate:

The IP Update API is used to update the primary and/or secondary static IP addresses for a client. Once the IPs are updated, the client can access the APIs only from the newly registered IP addresses. A user is allowed to update the IP addresses only once per calendar week.

Sample Ip Update Request:

const ipUpdateApi = new IpUpdateApi();
const ipUpdateResponse = await ipUpdateApi.ipUpdate({
  clientId: "XX1234",
  primaryIp: "XXX.XX.XX.XXX",
  secondaryIp: "XXX.XX.XX.XXX",
  password: "XX@123",
});

Sample Ip Update Response:

{
    "serverTime": "29/01/26 10:46:06",
    "msgId": "d5f083f3-1b04-4b97-9385-1e578fdfeb7a",
    "status": "Success",
    "statusMessage": "Client IPs updated successfully",
    "data": {
        "user_id": "DV99999",
        "primary_ip": "XXX.XX.XX.XXX",
        "secondary_ip": "XXX.XX.XX.XXX",
        "ip_updated_at": "2026-01-29T05:16:07.000Z"
    }
}

PersonalIndex:

The Index Data API shows the user's personal index. It shows the overall profit and loss of all the trades done by the user.

Sample Personal Index Request:

const indexDataApi = new IndexDataApi();
const indexResponse = await indexDataApi.getIndexData(xSessionToken);

Sample Personal Index Response:

{
    "serverTime": "03/06/24 18:46:17",
    "msgId": "0cb0cf30-4b27-494e-9048-6313671cf00a",
    "status": "Success",
    "statusMessage": "Index Data retrieved successfully",
    "indexData": {
        "indexName": "MOHAMMAD Index",
        "networth": "269.53",
        "indexData": {
            "index": "1.72",
            "indexChange": "0.05",
            "indexChangePercentage": "3.01",
            "latestTime": "2024-06-03 17:01:00",
            "networthChange": "7.88",
            "networthChangePercentage": "3.01",
            "fundReceipt": "0.00"
        }
    }
}

Search Equity & Derivative:

This API is used to search equity, derivatives and commodity scrips based on user provided search symbol and exchange name.

Parameters:

xSessionToken, exchange, searchSymbolName

Sample Search Request:

const searchApi = new SearchEquityDerivativeApi();
const searchResponse = await searchApi.searchEquityDerivative(xSessionToken, "GOLD", "MFO");

Sample Search Response:

{
    "msgId": "7356eb6b-ab17-4b2c-84e7-46c9280e15d4",
    "status": "Success",
    "statusMessage": "Request Successful",
    "commodityValues": [
        {
            "tradingSymbol": "GOLD20FEBFUT",
            "instrumentName": "FUTCOM",
            "quantityInLots": "9304",
            "exchange": "MFO"
        }
    ]
}

Quote:

This API can be used to get market depth details for a specific equity scrip including but not limited to values like last trade price, previous close price, change value, change percentage, bids/asks, upper and lower circuit limits etc. This helps user with market picture of an equity scrip using which he will be able to place an order.

Parameters:

xSessionToken, exchange, symbolName

Sample Quote request:

const quoteApi = new QuoteApi();
const quote = await quoteApi.getQuote(xSessionToken, "SBIN", EXCHANGE_NSE);

Sample Quote Response:

{
    "serverTime": "26/05/20 14:09:56",
    "msgId": "70414ca5-230e-467b-81cb-62af0a5f2b95",
    "status": "Success",
    "statusMessage": "Quote details retrieved successfully",
    "symbolName": "SBIN",
    "tradingSymbol": "SBIN-EQ",
    "exchange": "NSE",
    "companyName": "STATE BANK OF INDIA",
    "lastTradedTime": "26/05/2020 14:09:55",
    "lastTradedPrice": "151.00",
    "previousClose": "150.85",
    "changeValue": "0.15",
    "changePercentage": "0.10",
    "lastTradedQuantity": "16",
    "lowerCircuitLimit": "135.80",
    "upperCircuitLimit": "165.90",
    "averagePrice": "151.96",
    "openValue": "152.40",
    "highValue": "153.20",
    "lowValue": "150.55",
    "closeValue": "150.85",
    "totalBuyQuantity": "3140492",
    "totalSellQuantity": "9899407",
    "totalTradedValue": "592.47019 (Crs)",
    "totalTradedVolume": "38988562",
    "yearlyHighPrice": "373.80",
    "yearlyLowPrice": "149.45",
    "bestBids": [
        {
            "number": "1",
            "quantity": "9105",
            "price": "150.95"
        }
    ],
    "listingId": "3045_NSE"
}

IndexQuote:

Getting Index Quote details for a specific Indicies. This helps user with market picture of an specific Index Details.

Parameters:

xSessionToken, indexName

Sample Quote request:

const quoteApi = new QuoteApi();
const indexQuote = await quoteApi.getIndexQuote(xSessionToken, "NIFTY 50");

Sample Quote Response:

{
    "serverTime": "03/06/24 18:19:04",
    "msgId": "8c5dbe1f-cb01-4fd8-a5e9-49202bd4a121",
    "status": "Success",
    "statusMessage": "Index Quote details retrieved successfully",
    "indexDetails": [
        {
            "indexName": "Nifty 50",
            "listingId": "-21",
            "lastTradedTime": "2024-06-03 15:32:05.0",
            "spotPrice": 23263.9,
            "changePercentage": 3.25,
            "averagePrice": 0.0,
            "openValue": 23337.9,
            "highValue": 23338.7,
            "lowValue": 23062.3,
            "closeValue": 23263.9,
            "totalBuyQuantity": 0,
            "totalSellQuantity": 0,
            "totalTradedValue": 0,
            "totalTradedVolume": 0,
            "change": 733.2
        }
    ]
}

MultiQuote:

Parameters:

xSessionToken, BSE, NSE, NFO, BFO, INDEX, CDS, MFO, MCX

Sample multi Quote request:

const multiQuoteApi = new MultiQuoteApi();
const response = await multiQuoteApi.postMultiQuote(xSessionToken, {
  NSE: ["BAJAJ-AUTO"],
  BSE: ["INFY"],
});

Sample Quote Response:

{
    "serverTime": "03/06/24 18:49:07",
    "msgId": "6dcbebfd-4d91-4b42-85c1-c8d094f705da",
    "status": "Success",
    "statusMessage": "Multiquotes data retrieved successfully",
    "multiQuotes": [
        {
            "exchange": "BSE",
            "symbolName": "INFY",
            "tradingSymbol": "INFY",
            "companyName": "INFOSYS LTD.",
            "lastTradePrice": "1405.90",
            "change": "-0.35",
            "changePercent": "-0.02"
        }
    ]
}

SpanMargin:

Parameters:

xSessionToken, exchange, tradingSymbol, qty

Sample SpanMargin request:

const spanMarginApi = new SpanMarginApi();
const spanResponse = await spanMarginApi.postSpanMarginData(xSessionToken, {
  request: [
    { exchange: "NFO", tradingSymbol: "NIFTY06JUN2423200PE", qty: "25" },
    { exchange: "NFO", tradingSymbol: "NIFTY24JUNFUT", qty: "25" },
  ],
});

Sample SpanMargin Response:

{
    "serverTime": "03/06/24 19:31:08",
    "msgId": "9988d21e-c5d6-4e18-a024-5cdc21004dda",
    "status": "Success",
    "statusMessage": "Span margin calculated",
    "spanDetails": {
        "totalRequirement": "13666.21",
        "spanRequirement": "1941.21",
        "exposureMargin": "11725.00",
        "spreadBenefit": "00.00"
    }
}

OptionChain:

To search OptionChain for equity, derivatives and commodity scrips based on user provided search symbol and exchange name.

Parameters:

xSessionToken, searchSymbolName, exchange, expiryDate, strikePrice, optionType

Sample OptionChain Request:

const optionApi = new OptionApi();
const optionChainResponse = await optionApi.getOptionContracts(
  xSessionToken, "INFY", EXCHANGE_NSE, "2020-06-25", "950", "CE"
);

Sample OptionChain Response:

{
    "serverTime": "01/06/20 18:49:55",
    "msgId": "5e1e2e47-6565-457e-9d10-4e2b7d09d15b",
    "status": "Success",
    "statusMessage": "OptionChain details retrived successfully. ",
    "optionChainDetails": [
        {
            "tradingSymbol": "INFY20JUN950CE",
            "exchange": "NFO",
            "symbol": "74352_NFO",
            "strikePrice": "950.00",
            "expiryDate": "2020-06-25",
            "instrument": "OPTSTK",
            "optionType": "CE",
            "underLyingSymbol": "INFY",
            "spotPrice": "699.55",
            "lastTradedPrice": "0.00",
            "openInterest": "0",
            "openInterestChange": "0",
            "volume": "0"
        }
    ]
}

FutureChain:

To search FutureChain for equity, derivatives and commodity scrips based on user provided search symbol and exchange name.

Parameters:

xSessionToken, searchSymbolName, exchange, expiryDate

Sample FutureChain Request:

const futureApi = new FutureApi();
const futureChainResponse = await futureApi.getFutureContracts(
  xSessionToken, "ITC", EXCHANGE_NFO, "2024-06-27"
);

Sample FutureChain Response:

{
    "serverTime": "03/06/24 18:16:22",
    "msgId": "8f9113de-bc27-4d14-be92-71426e024c32",
    "status": "Success",
    "statusMessage": "Future chain details retrived successfully. ",
    "futureChainDetails": [
        {
            "tradingSymbol": "ITC24JUNFUT",
            "exchange": "NFO",
            "symbol": "52178_NFO",
            "expiryDate": "2024-06-27",
            "instrument": "FUTSTK",
            "underLyingSymbol": "ITC",
            "spotPrice": 430.35,
            "lastTradedPrice": "426.75",
            "openInterest": 107800000,
            "openInterestInLot": 67375,
            "openInterestChange": 1196800,
            "openInterestChangeInLot": 748,
            "oichangePer": "1.12",
            "volume": 24145600,
            "bestBids": [
                { "number": 1, "quantity": "1600", "price": "426.7000" }
            ],
            "bestAsks": [
                { "number": 1, "quantity": "1600", "price": "426.7500" }
            ]
        }
    ]
}

UserLimits:

Gets the user cash balances, available margin for trading in equity and commodity segments.

Parameters:

xSessionToken

Sample UserLimit Request:

const userLimitsApi = new UserLimitsApi();
const limits = await userLimitsApi.getLimits(xSessionToken);

Sample UserLimit Response:

{
    "serverTime": "29/05/20 15:34:05",
    "msgId": "7792c01b-618d-46b5-86d2-1a1c647c72d0",
    "equityLimit": {
        "grossAvailableMargin": "50000000000",
        "payInToday": "0",
        "notionalCash": "0",
        "marginUsed": "92",
        "netAvailableMargin": "49999999908"
    },
    "commodityLimit": {
        "grossAvailableMargin": "0",
        "payInToday": "0",
        "notionalCash": "0",
        "marginUsed": "0",
        "netAvailableMargin": "0"
    }
}

PlaceOrder:

To place an equity/derivative order with the exchange i.e the place order request typically registers the order with OMS and when it happens successfully, a success response is returned. Successful placement of an order via the API does not imply its successful execution. So when an order is successfully placed the PlaceOrder API returns an OrderNumber in response, and the actual order status can be checked separately using the OrderStatus API call. This is for Placing CNC, MIS and NRML Orders.

Parameters:

xSessionToken, symbolName, exchange, transactionType, orderType, price, quantity, disclosedQuantity, orderValidity, productType, afterMarketOrderFlag

Sample PlaceOrder Request:

const ordersApi = new OrdersApi();
const placeOrder = await ordersApi.placeOrder(xSessionToken, {
  symbolName: "RELIANCE",
  exchange: EXCHANGE_BSE,
  transactionType: TRANSACTION_TYPE_BUY,
  orderType: ORDER_TYPE_LIMIT,
  quantity: "2",
  disclosedQuantity: "",
  price: "1369",
  orderValidity: VALIDITY_DAY,
  productType: PRODUCT_MIS,
  afterMarketOrderFlag: "NO",
});

Sample PlaceOrder Response:

{
    "serverTime": "29/05/20 12:43:06",
    "msgId": "f1330206-cb2f-42eb-9925-b7d825c07bdd",
    "orderNumber": "200529000000059",
    "status": "Success",
    "statusMessage": "MIS Order request placed successfully",
    "exchangeOrderStatus": "PENDING",
    "orderDetails": {
        "pendingQuantity": "2",
        "avgExecutionPrice": "0.00",
        "orderPlacedBy": "--",
        "tradingSymbol": "RELIANCE",
        "triggerPrice": "0.00",
        "exchange": "BSE",
        "totalQuantity": "2",
        "transactionType": "BUY",
        "productType": "MIS",
        "orderType": "L",
        "quantity": "2",
        "filledQuantity": "0",
        "orderPrice": "1600.0",
        "filledPrice": "0.00",
        "exchangeOrderNo": "1590728958294000024",
        "orderValidity": "DAY",
        "orderTime": "29/05/2020 12:43:04"
    }
}

PlaceOrderBO:

To place an equity/derivative BO order with the exchange i.e the place order BO request typically registers the order with OMS and when it happens successfully, a success response is returned. Successful placement of an order via the API does not imply its successful execution. So when an order is successfully placed the placeOrderBO returns an orderNumber in response, and the actual order status can be checked separately using the orderStatus API call.

Parameters:

xSessionToken, exchange, symbolName, transactionType, orderType, quantity, disclosedQuantity, price, priceType, valueType, orderValidity, productType, squareOffValue, stopLossValue, trailingStopLoss

Sample PlaceOrderBO Request:

const ordersApi = new OrdersApi();
const placeOrderBO = await ordersApi.placeOrderBO(xSessionToken, {
  symbolName: "TCS",
  exchange: EXCHANGE_BSE,
  transactionType: TRANSACTION_TYPE_BUY,
  orderType: ORDER_TYPE_LIMIT,
  quantity: "10",
  disclosedQuantity: "1",
  price: "2000",
  priceType: "LTP",
  valueType: "Absolute",
  orderValidity: VALIDITY_DAY,
  productType: PRODUCT_BO,
  squareOffValue: "100",
  stopLossValue: "50",
  trailingStopLoss: "30",
});

Sample PlaceOrderBO Response:

{
    "serverTime": "01/06/20 14:58:38",
    "msgId": "de2d8caf-b76d-4a24-bb6c-fa654ed355bb",
    "orderNumber": "200601000000133",
    "status": "Success",
    "statusMessage": "Bracket Order request placed successfully",
    "exchangeOrderStatus": "EXECUTED",
    "orderDetails": {
        "pendingQuantity": "0",
        "avgExecutionPrice": "669.00",
        "orderPlacedBy": "--",
        "tradingSymbol": "INFY-EQ",
        "triggerPrice": "0.00",
        "exchange": "NSE",
        "totalQuantity": "10",
        "transactionType": "BUY",
        "productType": "BO",
        "orderType": "L",
        "quantity": "10",
        "filledQuantity": "10",
        "orderPrice": "669.0",
        "filledPrice": "669.00",
        "exchangeOrderNo": "1100000000030886",
        "orderValidity": "DAY",
        "orderTime": "01/06/2020 14:58:36"
    }
}

PlaceOrderCO:

To place an equity/derivative CO order with the exchange i.e the place order CO request typically registers the order with OMS and when it happens successfully, a success response is returned. Successful placement of an order via the API does not imply its successful execution. So when an order is successfully placed the placeOrderCO returns an orderNumber in response, and the actual order status can be checked separately using the orderStatus API call.

Parameters:

xSessionToken, symbolName, exchange, transactionType, orderType, price, quantity, disclosedQuantity, orderValidity, productType, triggerPrice

Sample PlaceOrderCO Request:

const ordersApi = new OrdersApi();
const placeOrderCO = await ordersApi.placeOrderCO(xSessionToken, {
  symbolName: "RELIANCE",
  exchange: EXCHANGE_NSE,
  transactionType: TRANSACTION_TYPE_BUY,
  orderType: ORDER_TYPE_LIMIT,
  quantity: "15",
  price: "2000",
  disclosedQuantity: "",
  orderValidity: VALIDITY_DAY,
  productType: PRODUCT_CO,
  triggerPrice: "1300",
});

Sample PlaceOrderCO Response:

{
    "serverTime": "01/06/20 14:36:34",
    "msgId": "b0d3192d-824f-4493-90cf-4657e827742e",
    "orderNumber": "200601000000129",
    "status": "Success",
    "statusMessage": "CO Order request placed successfully",
    "exchangeOrderStatus": "EXECUTED",
    "orderDetails": {
        "pendingQuantity": "0",
        "avgExecutionPrice": "669.00",
        "orderPlacedBy": "--",
        "tradingSymbol": "INFY-EQ",
        "triggerPrice": "650.00",
        "exchange": "NSE",
        "totalQuantity": "15",
        "transactionType": "BUY",
        "productType": "CO",
        "orderType": "L",
        "quantity": "15",
        "filledQuantity": "15",
        "orderPrice": "689.05",
        "filledPrice": "669.00",
        "exchangeOrderNo": "1100000000030191",
        "orderValidity": "DAY",
        "orderTime": "01/06/2020 14:36:32"
    }
}

Modify Order:

User would be able to modify some attributes of an order as long as it is with open/pending status in system. For modification order identifier is mandatory. With order identifier you need to send the optional parameter(s) which needs to be modified. In case the optional parameters aren't sent, the default will be considered from the original order. Modifiable attributes include quantity, Order Type (L,MKT, SL,SL-M). This API cannot be used for modifying attributes of an executed/rejected/cancelled order. Only the attribute that needs to be modified should be sent in the request alongwith the Order Identifier.

Parameters:

xSessionToken, orderNumber, orderType, quantity, disclosedQuantity, orderValidity, price, triggerPrice, parentOrderId

Sample ModifyOrder Request:

const ordersApi = new OrdersApi();
const modifyOrder = await ordersApi.modifyOrder(xSessionToken, "200529000000059", {
  quantity: "20",
});

Sample ModifyOrder Response:

{
    "serverTime": "29/05/20 14:12:42",
    "msgId": "773d0380-6f07-4269-93e5-a6d4b2b8c5d3",
    "orderNumber": "200529000000059",
    "status": "Success",
    "statusMessage": "Order 200529000000059 modified successfully",
    "exchangeOrderStatus": "PENDING",
    "orderDetails": {
        "pendingQuantity": "20",
        "avgExecutionPrice": "0.00",
        "orderPlacedBy": "DA35672",
        "tradingSymbol": "RELIANCE",
        "triggerPrice": "0.00",
        "exchange": "BSE",
        "totalQuantity": "20",
        "transactionType": "BUY",
        "productType": "MIS",
        "orderType": "L",
        "quantity": "20",
        "filledQuantity": "0",
        "orderPrice": "1600.0",
        "filledPrice": "0.00",
        "exchangeOrderNo": "1590728958294000024",
        "orderValidity": "DAY",
        "orderTime": "29/05/2020 14:12:39"
    }
}

OrderBook:

Orderbook retrieves and displays details of all orders placed by the user on a specific day. This API returns all states of the orders, namely, open, pending, rejected and executed ones.

Parameters:

xSessionToken

Sample OrderBook Request:

const ordersApi = new OrdersApi();
const orderBook = await ordersApi.getOrderBook(xSessionToken);

Sample OrderBook Response:

{
    "serverTime": "29/05/20 15:43:49",
    "msgId": "d2b6770c-348b-4bd0-91fa-feb5b3d10d8d",
    "status": "Success",
    "orderBookDetails": [
        {
            "orderNumber": "200529000000200",
            "exchange": "NSE",
            "tradingSymbol": "RELIANCE",
            "transactionType": "SELL",
            "productCode": "CO",
            "orderType": "SL-M",
            "orderPrice": "1290.00",
            "triggerPrice": "1290.00",
            "orderValidity": "DAY",
            "orderStatus": "Trigger Pending",
            "filledQuantity": "0",
            "fillPrice": "0.00",
            "averagePrice": "0.00",
            "rejectionReason": "--",
            "exchangeOrderNumber": "1100000000085407"
        }
    ]
}

TriggerOrders:

This API is used to get the trigger order numbers in case of BO and CO orders so that their attribute values can be modified. For BO orders, it will give the order identifiers for Stop loss leg and target leg. For CO orders, it will return order identifier of stop loss leg only. Using the order identifier, the user would be able to modify the order attributes using the modifyOrder API.

Parameters:

xSessionToken, orderNumber

Sample TriggerOrders Request:

const ordersApi = new OrdersApi();
const triggerOrders = await ordersApi.getTriggerOrderNumbers(xSessionToken, "200514000000041");

Sample TriggerOrders Response:

{
    "serverTime": "01/06/20 14:06:46",
    "msgId": "2172fc5c-a72b-4c79-bb43-398bebf85af4",
    "status": "Success",
    "statusMessage": "SubOrder details retrieved successfully.",
    "triggerOrders": [
        {
            "targetOrderNo": "200601000000027",
            "orderStatus": "Open",
            "orderPrice": "760.10",
            "triggerPrice": "0.00",
            "mainOrderNo": "200601000000026"
        },
        {
            "stopLossOrderNo": "200601000000028",
            "orderStatus": "Cancelled",
            "orderPrice": "650.00",
            "triggerPrice": "650.00",
            "mainOrderNo": "200601000000026"
        }
    ]
}

Order Status:

Get status of an order placed previously. This API returns all states of the orders, but not limited to open, pending, and partially filled ones.

Parameters:

xSessionToken, orderNumber

Sample OrderStatus Request:

const ordersApi = new OrdersApi();
const orderStatus = await ordersApi.getOrderStatus(xSessionToken, "200618000000010");

Sample OrderStatus Response:

{
    "serverTime": "29/05/20 13:31:37",
    "msgId": "a92ce76f-5970-44c5-a1b8-1038537b28c6",
    "orderNumber": "200529000000059",
    "orderStatus": "PENDING",
    "orderDetails": {
        "pendingQuantity": "2",
        "avgExecutionPrice": "0.00",
        "orderPlacedBy": "--",
        "tradingSymbol": "RELIANCE",
        "triggerPrice": "0.00",
        "exchange": "BSE",
        "totalQuantity": "2",
        "transactionType": "BUY",
        "productType": "MIS",
        "orderType": "L",
        "quantity": "2",
        "filledQuantity": "0",
        "orderPrice": "1600.0",
        "filledPrice": "0.00",
        "exchangeOrderNo": "1590728958294000024",
        "orderValidity": "DAY",
        "orderTime": "29/05/2020 12:43:04"
    }
}

Cancel Order:

An order which is open or pending in system can be cancelled. In other words, cancellation cannot be initiated for already Executed, Rejected orders. This is for CNC, MIS and NRML Orders.

Parameters:

xSessionToken, orderNumber

Sample CancelOrder Request:

const ordersApi = new OrdersApi();
const cancelResponse = await ordersApi.cancelOrder(xSessionToken, "200529000000059");

Sample CancelOrder Response:

{
    "serverTime": "29/05/20 14:50:36",
    "msgId": "25d6d99b-3224-4a77-b129-a5d0bd38349b",
    "status": "Success",
    "orderNumber": "200529000000059",
    "statusMessage": "Order cancelled successfully"
}

CancelOrderCO:

For Cancellation/exit of CO orders pass main leg Order number. If main leg is in Open/Pending state that order will be cancelled. If the main leg is executed and the sublegs are created and in open/Trigger pending state, the order will be exited. If the main leg is executed and if Stop loss is hit, API will return error message "SubOrder is in Executed status. Cannot exit/cancel such orders.

Parameters:

xSessionToken, orderNumber

Sample CancelOrderCO Request:

const ordersApi = new OrdersApi();
const cancelResponse = await ordersApi.cancelOrderCO(xSessionToken, "200618000000075");

Sample CancelOrderCO Response:

{
    "serverTime": "01/06/20 16:06:25",
    "msgId": "3b7ed673-9a5b-4014-afdf-158c8490beba",
    "status": "Success",
    "orderNumber": "200601000000129",
    "statusMessage": "Cover Order 200601000000129exited successfully"
}

CancelOrderBO:

For Cancellation/exit of BO orders pass main leg Order number. If main leg is in Open/Pending state that order will be cancelled. If the main leg is executed and the sublegs are created and in open/Trigger pending state, the order will be exited. If the main leg is executed and if either of Stop loss or target is hit, API will return error message "SubOrder is in Executed status. Cannot exit/cancel such orders.

Parameters:

xSessionToken, orderNumber

Sample CancelOrderBO Request:

const ordersApi = new OrdersApi();
const cancelResponse = await ordersApi.cancelOrderBO(xSessionToken, "200619000000003");

Sample CancelOrderBO Response:

{
    "serverTime": "01/06/20 16:11:24",
    "msgId": "c02e4a34-cb58-4822-8988-3736b22831e5",
    "status": "Success",
    "orderNumber": "200601000000134",
    "statusMessage": "Bracket Order exited successfully"
}

AddGTT:

GTT (Good Till Triggered) is a feature that allows users to place buy or sell orders of any stock at market or limit price. These orders are executed (triggered) once the market price of the stock reaches your desired price i.e the price you mentioned in the GTT Order. Read More....

Parameters:

xSessionToken, symbolName, transactionType, quantity, productType, orderType, triggerPrice, limitPrice

Sample Add GTT Request:

const gttApi = new GTTApi();
const gttCreateResponse = await gttApi.postGTTRequest(xSessionToken, {
  exchange: EXCHANGE_NSE,
  symbolName: "IDEA",
  transactionType: TRANSACTION_TYPE_BUY,
  orderType: ORDER_TYPE_LIMIT,
  quantity: "10",
  productType: PRODUCT_NRML,
  triggerPrice: "14",
  limitPrice: "14.50",
});

Sample Add GTT Response:

{
    "serverTime": "31/05/24 15:21:50",
    "msgId": "06fb18e6-6790-4700-8f26-258f1e31fd76",
    "status": "Success",
    "statusMessage": "GTT CREATED",
    "gttSummaryId": "944090",
    "orderDetails": {
        "productType": "NRML",
        "orderType": "L",
        "triggerPrice": "14",
        "transactionType": "BUY",
        "triggerId": "1344160",
        "symbol": "14366_NSE",
        "symbolName": "IDEA",
        "createdAt": "2024-05-31 15:21:50"
    }
}

ModifyGTT:

Modifying a GTT (Good Till Triggered) order allows investors to adjust the parameters of their existing GTT orders. This can include changing the trigger price, altering the quantity of the order, productType, limitPrice or modifying the order type.

Parameters:

xSessionToken, exchange, symbolName, transactionType, quantity, productType, orderType, triggerPrice, limitPrice, gttSummaryId

Sample Modify GTT Request:

const gttApi = new GTTApi();
const gttModifyResponse = await gttApi.putGTTRequest(xSessionToken, {
  exchange: EXCHANGE_NSE,
  symbolName: "IDEA",
  transactionType: TRANSACTION_TYPE_BUY,
  quantity: "5",
  productType: PRODUCT_NRML,
  orderType: ORDER_TYPE_LIMIT,
  triggerPrice: "14.8",
  limitPrice: "14.8",
  gttSummaryId: 944090,
});

Sample Modify GTT Response:

{
    "serverTime": "31/05/24 15:23:29",
    "msgId": "26eba130-ce8c-4c4e-b661-a1c90292bf11",
    "status": "Success",
    "statusMessage": "GTT MODIFIED",
    "gttSummaryId": "944115",
    "orderDetails": {
        "productType": "NRML",
        "orderType": "L",
        "triggerPrice": "14.8",
        "transactionType": "BUY",
        "limitPrice": "14.8",
        "symbol": "14366_NSE",
        "symbolName": "IDEA",
        "quantity": "5"
    }
}

DeleteGTT:

Deleting a GTT order cancels it before execution, removing it from the exchange's order book and preventing future execution. Once GTT is triggered, deletion is not possible.

Parameters:

xSessionToken, gttSummaryId

Sample Delete GTT Request:

const gttApi = new GTTApi();
const gttDeleteResponse = await gttApi.deleteGTTRequest(xSessionToken, { gttSummaryId: 944115 });

Sample Delete GTT Response:

{
    "serverTime": "31/05/24 15:25:07",
    "msgId": "f8d8d409-affa-4251-9756-923c09e21294",
    "status": "Success",
    "statusMessage": "GTT Deleted successfully",
    "gttSummaryId": "944115",
    "orderDetails": {
        "userId": "RXX12XX"
    }
}

AddOCO:

Parameters:

xSessionToken, symbolName, transactionType, quantity, productType, orderType, targetTriggerPrice, targetLimitPrice, stoplossTriggerPrice, stoplossLimitPrice

Sample Add OCO Request:

const gttOcoApi = new GTTOCOApi();
const gttocoResponse = await gttOcoApi.postGTTOCORequest(xSessionToken, {
  exchange: "NSE",
  symbolName: "IDEA",
  transactionType: "SELL",
  quantity: "1",
  productType: "CNC",
  orderType: "L",
  targetTriggerPrice: "17",
  targetLimitPrice: "16",
  stoplossTriggerPrice: "13",
  stoplossLimitPrice: "12",
});

Sample Add OCO Response:

{
    "serverTime": "31/05/24 17:35:52",
    "msgId": "eda2be26-8f8e-4319-9afc-2d256fafd2bb",
    "status": "Success",
    "statusMessage": "GTT CREATED",
    "gttSummaryId": "944425",
    "orderDetails": {
        "transactionType": "SELL",
        "symbol": "14366_NSE",
        "symbolName": "IDEA",
        "productType": "CNC",
        "orderType": "L",
        "target": {
            "quantity": "1",
            "triggerPrice": "17",
            "limitPrice": "16",
            "type": "TARGET",
            "triggerId": "1344615"
        },
        "stopLoss": {
            "quantity": "1",
            "triggerPrice": "13",
            "limitPrice": "12",
            "type": "STOPLOSS",
            "triggerId": "1344620"
        }
    }
}

ModifyOCO:

Parameters:

xSessionToken, exchange, symbolName, transactionType, quantity, productType, orderType, targetTriggerPrice, targetLimitPrice, stoplossTriggerPrice, stoplossLimitPrice, gttSummaryId

Sample Modify OCO Request:

const gttOcoApi = new GTTOCOApi();
const gttModifyResponse = await gttOcoApi.putGTTOCORequest(xSessionToken, {
  exchange: "NSE",
  symbolName: "IDEA",
  transactionType: "SELL",
  quantity: "2",
  productType: "NRML",
  orderType: "L",
  targetTriggerPrice: "18",
  targetLimitPrice: "17",
  stoplossTriggerPrice: "14",
  stoplossLimitPrice: "13",
  gttSummaryId: "944425",
});

Sample Modify OCO Response:

{
    "serverTime": "31/05/24 17:43:23",
    "msgId": "2589a516-d3cd-4408-863c-99d5ba6de971",
    "status": "Success",
    "statusMessage": "GTT MODIFIED",
    "gttSummaryId": "944430",
    "orderDetails": {
        "transactionType": "SELL",
        "orderType": "L",
        "symbol": "14366_NSE",
        "symbolName": "IDEA",
        "productType": "NRML",
        "target": {
            "limitPrice": "17",
            "triggerId": "1344625",
            "triggerPrice": "18",
            "type": "TARGET",
            "quantity": "2"
        },
        "stopLoss": {
            "limitPrice": "13",
            "triggerId": "1344630",
            "triggerPrice": "14",
            "type": "STOPLOSS",
            "quantity": "2"
        }
    }
}

DeleteOCO:

Deleting an OCO (One-Cancels-the-Other) order involves canceling both legs of the order simultaneously. In an OCO order, when one part of the order is executed, the other part is automatically canceled. However, if the investor decides to delete the entire OCO order before either part is executed, they can do so using the delete OCO API.

Parameters:

xSessionToken, gttSummaryId

Sample Delete OCO Request:

const gttOcoApi = new GTTOCOApi();
const gttDeleteResponse = await gttOcoApi.deleteGTTOCORequest(xSessionToken, { gttSummaryId: 944430 });

Sample Delete OCO Response:

{
    "serverTime": "31/05/24 19:05:44",
    "msgId": "ddeb9d0e-aff8-4e50-8e8f-6d2189056dfd",
    "status": "Success",
    "statusMessage": "GTT Deleted successfully",
    "gttSummaryId": "944430",
    "orderDetails": {
        "clientId": "RX31XXX"
    }
}

ListGttOco:

Using the list OCO, we can retrieve the list of active GTT OCO, triggered GTT OCO, and expired GTT OCO.

Parameters:

xSessionToken, listType

Sample ListGttOco Request:

const gttApi = new GTTApi();
const gttListResponse = await gttApi.getGTTListRequest(xSessionToken, "active");

Sample ListGttOco Response:

{
    "serverTime": "31/05/24 15:24:23",
    "msgId": "b9637ccf-579a-4cd7-ac7b-4fa8ba11ee6e",
    "status": "Success",
    "statusMessage": "List of GTT / OCO orders received.",
    "orderDetails": [
        {
            "summary": {
                "id": 944115,
                "userId": "RXX12XX",
                "symbol": "14366_NSE",
                "symbolName": "IDEA",
                "orderType": "L",
                "productType": "NRML",
                "gttType": "SINGLE",
                "validTill": "FOREVER",
                "createdAt": "2024-05-31 15:23:30",
                "deletedAt": "",
                "gttSummaryId": "944115",
                "isExpired": false
            },
            "triggers": {}
        }
    ]
}

TradeBook:

Details of all successfully executed orders placed by the user.

Parameters:

xSessionToken

Sample TradeBook Request:

const tradeBookApi = new TradeBookApi();
const tradeBook = await tradeBookApi.getTradeBook(xSessionToken);

Sample TradeBook Response:

{
    "serverTime": "29/05/20 15:43:49",
    "msgId": "d2b6770c-348b-4bd0-91fa-feb5b3d10d8d",
    "status": "Success",
    "orderBookDetails": [
        {
            "orderNumber": "200529000000200",
            "exchange": "NSE",
            "tradingSymbol": "RELIANCE",
            "transactionType": "SELL",
            "productCode": "CO",
            "orderType": "SL-M",
            "orderPrice": "1290.00",
            "orderValidity": "DAY",
            "orderStatus": "Complete",
            "filledQuantity": "0",
            "fillPrice": "0.00",
            "averagePrice": "0.00"
        }
    ]
}

Positions:

Get position details of the user (The details of equity, derivative, commodity, currency borrowed or owned by the user).

Parameters:

xSessionToken, positionType

Sample Positions Request:

const positionsApi = new PositionsApi();
const positions = await positionsApi.getPositions(xSessionToken, POSITION_TYPE_DAY);

Sample Positions Response:

{
    "serverTime": "01/06/20 15:13:06",
    "msgId": "9e143fb4-f9cb-4ea7-bd6d-bad6008816db",
    "positionDetails": [
        {
            "averagePrice": "669.00",
            "exchange": "NSE",
            "markToMarketPrice": "0.00",
            "lastTradedPrice": "669.00",
            "previousClose": "705.45",
            "productCode": "BO",
            "tradingSymbol": "INFY-EQ",
            "calculatedNetQuantity": "10.0",
            "averageBuyPrice": "669.00",
            "averageSellPrice": "0.00",
            "boardLotQuantity": "1",
            "boughtPrice": "6690.00",
            "buyQuantity": "10",
            "netQuantity": "10",
            "netValue": "-6690.00",
            "positionType": "DAY",
            "sellQuantity": "0",
            "positionConversions": ["CNC", "NRML"],
            "soldValue": "0.00",
            "transactionType": "BUY",
            "realizedGainAndLoss": "0.00",
            "unrealizedGainAndLoss": "0.00",
            "companyName": "INFOSYS LIMITED"
        }
    ]
}

PositionConversion:

Convert an existing position of a margin product to a different margin product type. All or a subset of an existing position quantity can be converted to a different product type. The available margin product types are MARGIN_INTRADAY_SQUAREOFF(MIS), CASHNCARRY(CNC), NORMAL(NRML).

Parameters:

xSessionToken, exchange, symbolName, transactionType, positionType, quantityToConvert, fromProductType, toProductType, netQuantity

Sample PositionConversion Request:

const positionsApi = new PositionsApi();
const conversionResponse = await positionsApi.convertPosition(xSessionToken, {
  symbolName: "RELIANCE",
  exchange: EXCHANGE_BSE,
  transactionType: TRANSACTION_TYPE_BUY,
  positionType: POSITION_TYPE_DAY,
  quantityToConvert: "2",
  fromProductType: PRODUCT_MIS,
  toProductType: PRODUCT_CNC,
  netQuantity: "2",
});

Sample PositionConversion Response:

{
    "serverTime": "01/06/20 15:06:42",
    "msgId": "ba32c75f-ee4b-4af6-a580-f17ad36fefd4",
    "status": "Success",
    "statusMsg": "Position Conversion from MIS to CNC successful"
}

PositionSquareOff:

The PositionsApi class helps the user to Square Off existing position. Mostly used in day trading, in which user buy or sell a particular quantity of a stock and later in the day reverse the transaction to earn a profit.

Parameters:

xSessionToken, symbolName, exchange, transactionType, productType, netQuantity

Sample PositionSquareoff Request:

const positionsApi = new PositionsApi();
const squareOffResponse = await positionsApi.squareOffPosition(xSessionToken, {
  positionSquareOffRequestList: [
    {
      exchange: EXCHANGE_BSE,
      symbolName: "TCS",
      productType: PRODUCT_MIS,
      netQuantity: "1",
      transactionType: TRANSACTION_TYPE_BUY,
    },
  ],
});

Sample PositionSquareOff Response:

{
    "serverTime": "25/06/20 20:04:30",
    "msgId": "fcb519b8-dd74-422a-8a65-1dc0a0caedb7",
    "positionSquareOffResponseList": [
        {
            "status": "Success",
            "statusMessage": "Position square off successful -TCS-EQ NetQty:1"
        }
    ]
}

Holdings:

Get the details of the Stocks which client is holding. Here, you will be able to get the Client holdings which are bought under 'CNC' product type and are not sold yet.

Parameters:

xSessionToken

Sample Holdings Request:

const holdingsApi = new HoldingsApi();
const holding = await holdingsApi.getHolding(xSessionToken);

Sample Holdings Response:

{
    "serverTime": "25/06/20 13:46:16",
    "msgId": "d58af813-8ed2-400d-b769-9d89f873376d",
    "status": "Success",
    "statusMessage": "User Holding details retrieved successfully",
    "holdingSummary": {
        "gainingTodayCount": "1",
        "losingTodayCount": "2",
        "totalGainAndLossAmount": "-17.15",
        "portfolioValue": "13.40"
    },
    "holdingDetails": [
        {
            "averagePrice": "22.50",
            "exchange": "BSE",
            "lastTradedPrice": "0.00",
            "previousClose": "23.00",
            "productCode": "CNC",
            "symbolDescription": "ASHOK ALCO-CHEM LTD.",
            "tradingSymbol": "ASHOKALC",
            "totalGainAndLoss": "-22.50",
            "holdingsQuantity": "1",
            "collateralQuantity": "-1",
            "holdingsValue": "0.00",
            "sellableQuantity": "0"
        }
    ]
}

IntraDayCandleData:

Gets the Intraday candle data such as Open, high, low, close and volume within specific time period per min for a specific symbol.

Parameters:

xSessionToken, exchange, symbolName, fromDate, toDate

Sample IntraDayCandleData Request:

const intraDayCandleDataApi = new IntraDayCandleDataApi();
const intraDayResponse = await intraDayCandleDataApi.getIntradayCandleData(
  xSessionToken, "INFY", "2020-04-27 11:50:00", EXCHANGE_BSE, "2020-04-27 12:29:00"
);

Sample IntraDayCandleData Response:

{
    "serverTime": "31/05/20 20:46:52",
    "msgId": "ff875ecd-5f42-47f6-a81e-37e6920acefc",
    "intradayCandleData": [
        {
            "dateTime": "2020-04-27 11:50:00.0",
            "open": "632.3",
            "high": "632.3",
            "low": "632.3",
            "close": "632.3",
            "volume": "1"
        }
    ]
}

IndexIntraDayCandleData:

Gets the Index intraday candle data such as Open, high, low, close and volume within specific time period per min for a specific index.

Parameters:

xSessionToken, indexName, fromDate, toDate

Sample IndexIntraDayCandleData Request:

const intraDayCandleDataApi = new IntraDayCandleDataApi();
const indexIntraDayResponse = await intraDayCandleDataApi.getIndexIntradayCandleData(
  xSessionToken, "NIFTY 200", "2019-08-26 09:07:00", "2019-08-26 09:16:00"
);

Sample IndexIntraDayCandleData Response:

{
    "serverTime": "02/06/20 18:19:42",
    "msgId": "6e6ad246-9808-4bfc-8cf3-724f4f745113",
    "status": "Success",
    "statusMessage": "Index IntraDay Candle data retrieved successfully ",
    "indexIntraDayCandleData": [
        {
            "dateTime": "2019-08-26 09:07:00.0",
            "open": "5664.2",
            "high": "5664.2",
            "low": "5664.2",
            "close": "5664.2",
            "volume": "0"
        }
    ]
}

HistoricalCandleData:

Gets the historical candle data such as Open, high, low, close, last traded price and volume within specific dates for a specific symbol. From date is mandatory. End date is optional and defaults to Today.

Parameters:

xSessionToken, exchange, symbolName, fromDate, toDate

Sample HistoricalCandleData Request:

const historicalCandleDataApi = new HistoricalCandleDataApi();
const historicalResponse = await historicalCandleDataApi.getHistoricalCandleData(
  xSessionToken, "INFY", "2019-01-01", EXCHANGE_BSE, "2020-02-01"
);

Sample HistoricalCandleData Response:

{
    "serverTime": "31/05/20 20:18:07",
    "msgId": "07701e56-fb82-4315-bad0-449da8482549",
    "historicalCandleData": [
        {
            "date": "2019-01-01",
            "open": "661.0",
            "high": "667.0",
            "low": "654.3",
            "close": "664.65",
            "ltp": "664.65",
            "volume": "221951"
        }
    ]
}

IndexHistoricalCandleData:

Gets the Index historical candle data such as Open, high, low, close, last traded price and volume within specific dates for a specific index. From date is mandatory. End date is optional and defaults to Today.

Parameters:

xSessionToken, indexName, fromDate, toDate

Sample IndexHistoricalCandleData Request:

const historicalCandleDataApi = new HistoricalCandleDataApi();
const indexHistoricalResponse = await historicalCandleDataApi.getIndexCandleData(
  xSessionToken, "NIFTY 200", "2015-03-04", "2017-03-05"
);

Sample IndexHistoricalCandleData Response:

{
    "serverTime": "31/05/20 20:31:02",
    "msgId": "cf232a72-e7d3-42a3-a834-9e8cbd65aa20",
    "status": "Success",
    "statusMessage": "Index HistoricalCandle data retrieved successfully ",
    "indexCandleData": [
        {
            "date": "2015-03-04",
            "open": "4702.2",
            "high": "4706.3",
            "low": "4594.3",
            "close": "4607.4",
            "ltp": "4607.4",
            "volume": "0"
        }
    ]
}

Logout:

Logging out user from the application

Parameters:

xSessionToken

Sample Logout Request:

const logoutApi = new UserLogoutApi();
const logoutResponse = await logoutApi.logout(xSessionToken);

Sample Logout Response:

{
    "serverTime": "31/05/20 21:27:52",
    "msgId": "41627994-5c96-411c-b15c-dbda00029269",
    "status": "Success",
    "statusMessage": "User has successfully logged out"
}

Constant List:

This section contains the list of possible constant values that can be passed for input attributes like exchanges, product types etc.

Product types:

PRODUCT_MIS 
PRODUCT_CNC
PRODUCT_NRML
PRODUCT_CO
PRODUCT_BO

Example:- { productType: PRODUCT_MIS }

Exchanges:

EXCHANGE_NSE
EXCHANGE_BSE
EXCHANGE_NFO
EXCHANGE_CDS
EXCHANGE_MCX

Example:- { exchange: EXCHANGE_BSE }

Transaction types:

TRANSACTION_TYPE_BUY
TRANSACTION_TYPE_SELL

Example:- { transactionType: TRANSACTION_TYPE_BUY }

Order types:

ORDER_TYPE_LIMIT 
ORDER_TYPE_MARKET
ORDER_TYPE_SL 
ORDER_TYPE_SLM

Example:- { orderType: ORDER_TYPE_LIMIT }

Validity types:

VALIDITY_DAY 
VALIDITY_IOC 

Example:- { orderValidity: VALIDITY_DAY }

Position types:

POSITION_TYPE_DAY
POSITION_TYPE_NET

Example:- { positionType: POSITION_TYPE_DAY }

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

StockNoteBridge - Node.js Bridge for Stocknote API

Overview

Note

Prerequisites

Prerequisites (One-Time Setup)

Authentication (Required for Login)

Steps

List of supported API

Login Api:

Parameters:

Login Sample Request:

Sample Login Response:

Using the session token users can call other API's through Node.js SDK

GenerateOtp:

Sample Generate Otp Request:

Sample Generate Otp Response:

GenerateSecretAPIKey:

Sample Generate Secret APIKey Request:

Sample Generate Secret APIKey Response:

GenerateAccessToken:

Sample Generate AccessToken Request:

Sample Generate AccessToken Response:

IpRegistration:

Sample Ip Registration Request:

Sample Ip Registration Response:

IPUpdate:

Sample Ip Update Request:

Sample Ip Update Response:

PersonalIndex:

Sample Personal Index Request:

Sample Personal Index Response:

Search Equity & Derivative:

Parameters:

Sample Search Request:

Sample Search Response:

Quote:

Parameters:

Sample Quote request:

Sample Quote Response:

IndexQuote:

Parameters:

Sample Quote request:

Sample Quote Response:

MultiQuote:

Parameters:

Sample multi Quote request:

Sample Quote Response:

SpanMargin:

Parameters:

Sample SpanMargin request:

Sample SpanMargin Response:

OptionChain:

Parameters:

Sample OptionChain Request:

Sample OptionChain Response:

FutureChain:

Parameters:

Sample FutureChain Request:

Sample FutureChain Response:

UserLimits:

Parameters:

Sample UserLimit Request:

Sample UserLimit Response:

PlaceOrder:

Parameters:

Sample PlaceOrder Request:

Sample PlaceOrder Response:

PlaceOrderBO:

Parameters:

Sample PlaceOrderBO Request:

Sample PlaceOrderBO Response:

PlaceOrderCO:

Parameters:

Sample PlaceOrderCO Request: