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

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

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

Parameter

Value

Mandatory

Remarks

txn_type

B/S

Transaction Type

exchange

NSE

The exchange where the transacti takes place it can be NSE/BSE

segment

The market segment where E might stands for "Equity"

product

The Product Type is Intraday

security_id

14366

The unique identifier for the security being trade.

quantity

Non-zero integer value

price

0.00

Float value, cannot be zero when ORDER_TYPE is LMT/SL

validity

DAY

The validity of the order indicate it is valid for the day

order_type

MKT

The type of order, where "MKT" stands for a market order.

disc_quantity

The disclosed quantity of the order.

trigger_price

0.00

The price at which a stop order is triggered. "0.00" indicates no stop price.

off_mkt_flag

true

true for aftermarket order, false for normal order

remarks

502929

Additional remarks or reference number for the transaction.

mkt_type

Default value is NL

good_till_days_date

2019-03-29 (yyyy-MM-dd)

Mandatory when validity is GTD

encash_flag

Mandatory when using different AMO schedules

order_no

1234567890

Order number

serial_no

Serial number

group_id

Group Id

192.168.0.101

IP address of client device

uu_id

12345678

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

App ID of client device

Request

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-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-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))
}

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

{
    "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.

Parameter

Description

Status

“success”

Message

“Some Message”

Data

An object containing the details of the order.

order_no

Order specific identification number.

PreviousOrder Entry NextOrder Cancel

Last updated 5 months ago