Order Modify

API for order modification allows users to alter an open or pending order by providing the order and any optional parameters needing adjustment if there is no opI to place an order to the exchange.

Endpoint

Base URL

https://connects.torusdigital.com/api/v1/order/modify

Header Parameters

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Request Parameter

Parameter	Value	Mandatory	Remarks
txn_type	B/S	Y	Transaction Type
exchange	NSE	Y	The exchange where the transacti takes place it can be NSE/BSE
segment	E	Y	The market segment where E might stands for "Equity"
product	I	Y	The Product Type is Intraday
security_id	14366	Y	The unique identifier for the security being trade.
quantity	1	Y	Non-zero integer value
price	0.00	Y	Float value, cannot be zero when ORDER_TYPE is LMT/SL
validity	DAY	Y	The validity of the order indicate it is valid for the day
order_type	MKT	Y	The type of order, where "MKT" stands for a market order.
disc_quantity	0	N	The disclosed quantity of the order.
trigger_price	0.00	N	The price at which a stop order is triggered. "0.00" indicates no stop price.
off_mkt_flag	true	Y	true for aftermarket order, false for normal order
remarks	502929	N	Additional remarks or reference number for the transaction.
mkt_type	NL	Y	Default value is NL
good_till_days_date	2019-03-29 (yyyy-MM-dd)	N	Mandatory when validity is GTD
encash_flag	1	N	Mandatory when using different AMO schedules
order_no	1234567890	Y	Order number
serial_no	1	Y	Serial number
group_id	1	Y	Group Id
ip	192.168.0.101	Y	IP address of client device
uu_id	12345678	Y	This random ID is to be generated and persisted on a device when a user installs or initializes the app (Mobile or EXE) for the first time
app_id	12345678	Y	App ID of client device

Request

curl

cURL

curl --location 'https://connects.torusdigital.com/api/v1/order/modify' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "source": "M",
    "data": {
        "txn_type": "B",
        "exchange": "NSE",
        "segment": "E",
        "product": "I",
        "security_id": "14366",
        "quantity": "1",
        "price": "0.00",
        "validity": "DAY",
        "order_type": "MKT",
        "disc_quantity": "0",
        "trigger_price": "0",
        "off_mkt_flag": "false",
        "remarks": "ordModify",
        "mkt_type": "NL",
        "settlor": "X",
        "group_id": "1",
        "order_no": "1171240610104",
        "serial_no": "1",
        "ip": "192.168.0.101",
        "uu_id": "12345678",
        "app_id": "12345678"
    }
}'

Java

Java-Unirest

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connect.torusfinancemarket.com/api/v1/order/modify")
    .header("Authorization", "Bearer {{token}}")
    .header("Content-Type", "application/json")
    .body("{\r\n" +
            "    \"source\": \"M\",\r\n" +
            "    \"data\": {\r\n" +
            "        \"txn_type\": \"B\",\r\n" +
            "        \"exchange\": \"NSE\",\r\n" +
            "        \"segment\": \"E\",\r\n" +
            "        \"product\": \"I\",\r\n" +
            "        \"security_id\": \"14366\",\r\n" +
            "        \"quantity\": \"1\",\r\n" +
            "        \"price\": \"0.00\",\r\n" +
            "        \"validity\": \"DAY\",\r\n" +
            "        \"order_type\": \"MKT\",\r\n" +
            "        \"disc_quantity\": \"0\",\r\n" +
            "        \"trigger_price\": \"0\",\r\n" +
            "        \"off_mkt_flag\": \"false\",\r\n" +
            "        \"remarks\": \"ordModify\",\r\n" +
            "        \"mkt_type\": \"NL\",\r\n" +
            "        \"settlor\": \"X\",\r\n" +
            "        \"group_id\": \"1\",\r\n" +
            "        \"order_no\": \"1171240610104\",\r\n" +
            "        \"serial_no\": \"1\",\r\n" +
            "        \"ip\": \"192.168.0.101\",\r\n" +
            "        \"uu_id\": \"12345678\",\r\n" +
            "        \"app_id\": \"12345678\"\r\n" +
            "    }\r\n" +
            "}")
    .asString();

Go

Go-native

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"strings"
)

func main() {
	url := "https://connect.torusfinancemarket.com/api/v1/order/modify"
	method := "POST"

	payload := strings.NewReader(`
{
	"source": "M",
	"data": {
		"txn_type": "B",
		"exchange": "NSE",
		"segment": "E",
		"product": "I",
		"security_id": "14366",
		"quantity": "1",
		"price": "0.00",
		"validity": "DAY",
		"order_type": "MKT",
		"disc_quantity": "0",
		"trigger_price": "0",
		"off_mkt_flag": "false",
		"remarks": "ordModify",
		"mkt_type": "NL",
		"settlor": "X",
		"group_id": "1",
		"order_no": "1171240610104",
		"serial_no": "1",
		"ip": "192.168.0.101",
		"uu_id": "12345678",
		"app_id": "12345678"
	}
}`)

	client := &http.Client{}
	req, err := http.NewRequest(method, url, payload)
	if err != nil {
		fmt.Println("Error creating request:", err)
		return
	}

	req.Header.Add("Authorization", "Bearer {{token}}")
	req.Header.Add("Content-Type", "application/json")

	res, err := client.Do(req)
	if err != nil {
		fmt.Println("Error making request:", err)
		return
	}
	defer res.Body.Close()

	body, err := ioutil.ReadAll(res.Body)
	if err != nil {
		fmt.Println("Error reading response:", err)
		return
	}

	fmt.Println("Response:", string(body))
}

JavaScript

var settings = {
  "url": "https://connect.torusfinancemarket.com/api/v1/order/modify",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {{token}}",
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({
    "source": "M",
    "data": {
      "txn_type": "B",
      "exchange": "NSE",
      "segment": "E",
      "product": "I",
      "security_id": "14366",
      "quantity": "1",
      "price": "0.00",
      "validity": "DAY",
      "order_type": "MKT",
      "disc_quantity": "0",
      "trigger_price": "0",
      "off_mkt_flag": "false",
      "remarks": "ordModify",
      "mkt_type": "NL",
      "settlor": "X",
      "group_id": "1",
      "order_no": "1171240610104",
      "serial_no": "1",
      "ip": "192.168.0.101",
      "uu_id": "12345678",
      "app_id": "12345678"
    }
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Response

200

{
    "status": "success",
    "message": "Order modification request submitted successfully. Your Order Ref No. 1122031117658",
    "data": [
        {
            "order_no": "1122031117658"
        }
    ]
}

Response Parameter

Parameter	Description
Status	“success”
Message	“Some Message”
Data	An object containing the details of the order.
order_no	Order specific identification number.