Change log

Developer API Version 1 : Friday 9th May

Key Generation

• The generated key validity has been extended to 365 Days.

Success Response

• Success response structure has been changed from previous Connect V4 and current Developer API V1.

• A new key has been added to the success response called "message" to all the API in the Developer API V1.

New Success Response (Developer API V1)

{
  "status": "success",
  "message": "API execution information",
  "data": {
        ...
    }
}  

Old Success Response (Connect V4)

{ 
  "status": "success", 
  "data": {      
  	...    
    }
}

Place Order

• In the request there is a new input variable that has been added called "customer_firm"

New Request (Developer API V1)

{
  "userId": "{{userId}}",
  "jKey": "{{jKey}}",
  "exchange": "NSE",
  "retention": "DAY",
  "customer_firm": "C",
  "product": "C",
  "priceType": "MKT",
  "tradingSymbol": "IDEA-EQ",
  "transactionType": "B",
  "price": "0",
  "trgprc": "0",
  "quantity": "1",
  "remarks": "Test"
}

Old Request (Connect V4)

{
    "userId": "{{userId}}",
    "exchange": "NSE", 
    "tradingSymbol": "ITC-EQ",
    "quantity": "250",
    "price": "413",
    "product": "C",
    "transactionType": "B",
    "priceType": "LMT",
    "retention": "DAY",
    "triggerPrice": "0",
    "remarks": "Place Order",
    "jKey": "{{jKey}}"
}

Order Margin

• There are new key variable added to the success response of order margin - "marginOnNewOrder", "availableMargin".

New Success Response (Developer API V1)

{
  "status": "success",
  "message": "Fetched order margin successfully",
  "data": {
      "availableMargin": "459.71299999999974",
      "cash": "7709",
      "marginOnNewOrder": "780468",
      "remarks": "Insufficient Balance",
      "requestTime": "16:21:04 30-04-2025"
    }
}

Old Success Response (Connect V4)

{  
  "status": "success",  
  "data": {    
    "requestTime": "14:31:41 15-02-2023", 
    "cash": "-141.37", 
    "marginused": "523.05",  
    "remarks": "Insufficient Balance"  
  }
}

Cancel Order

• There is a new key variable added to the success response of cancel order - "rejreason".

New Success Response (Developer API V1)

{
   "status": "success",
   "message": "Order cancellation details",
   "data": {
      "orderNumber": "25042100011119",
      "rejreason": "SAF:order is not open to cancel",
      "requestTime": "17:59:57 21-04-2025"
   }       
}

Old Success Response (Connect V4)

{
  "status": "success",  
  "data": {    
    "requestTime": "14:45:38 15-02-2023",  
    "orderNumber": "1234567890111"  
	}
}

Modify Order

• There are new key variables added to the request of the modify order - "retention", "mkt_protection".

New Request (Developer API V1)

{
  "userId": "{{userId}}",
  "jKey": "{{jKey}}",
  "orderNumber": "25042100011120",
  "priceType": "LMT",
  "tradingSymbol": "IDEA-EQ",
  "price": "418",
  "triggerPrice": "0",
  "quantity": "1",
  "product": "C",
  "retention": "DAY",
  "mkt_protection": "0.5"
}

Old Request (Connect V4)

{
    "userId": "{{userID}}",
    "exchange": "NSE", 
    "quantity": "250",
    "price": "413",
    "triggerPrice": "0",
    "orderNumber": "",
    "tradingSymbol": "",
    "priceType": "LMT",
    "jKey": "{{jKey}}"
}

• There is a new key variable added to the success response of modify order - "rejreason".

New Success Response (Developer API V1)

{
  "status": "success",
  "message": "Order modification details",
  "data": {
      "orderNumber": "25042100011120",
      "rejreason": "SAF:order is not open to modify",
      "requestTime": "18:07:09 21-04-2025"
   }        
}

Old Success Response (Connect V4)

{
  "status": "success",  
  "data": {    
    "requestTime": "14:45:38 15-02-2023",  
    "orderNumber": "1234567890111"  
  }
}