Order Entry

Allows clients to place new orders in the trading system. Requires comprehensive details such as client identification, order specifications (product, quantity, price, type), exchange and market parameters, and validity period.

Endpoint

Base URL

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

Header Parameters

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

Field	Value	Description
source	M	The source of the transaction.
txn_type	B	The type of transaction, where "B" typically stands for Buy and "S" stands for SELL.
exchange	NSE	The exchange where the transaction on takes place, it can be NSE/BSE.
segment	E	The market segment, where "E" might stand for "Equity".
product	I	The product type.
security_id	14366	The unique identifier for the security being traded.
quantity	1	The number of units to be traded.
price	0.00	The price at which the transaction is to be executed. "0.00" indicates a market order.
validity	DAY	The validity of the order, indicating it is valid for the day.
order_type	MKT	The type of order, where "MKT" stands for a market order.
disc_quantity	0	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	false	Indicates whether the order is off-market.
remarks	502929	Additional remarks or reference number for the transaction.
mkt_type	NL	Default value is NL
settlor	X	The settlor's identifier, possibly indicating the person or entity settling the transaction.
group_id	1	The group identifier for the transaction.

Request

curl

cURL

curl --location 'https://connects.torusdigital.com/api/v1/order/entry' \
--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.00",
    "off_mkt_flag": "false",
    "remarks": "502929",
    "mkt_type": "NL",
    "settlor": "X",
    "group_id": "1"
  }
}'

Java

Java-Unirest

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

Go

Go-Native

package main

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

func main() {
  url := "https://connects.torusdigital.com/api/v1/order/entry"
  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.00",
      "off_mkt_flag": "false",
      "remarks": "502929",
      "mkt_type": "NL",
      "settlor": "X",
      "group_id": "1"
    }
  }`)

  client := &http.Client{}
  req, err := http.NewRequest(method, url, payload)
  if err != nil {
    fmt.Println(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(err)
    return
  }
  defer res.Body.Close()

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

JavaScript

JavaScript-jQuery

var settings = {
  "url": "https://connects.torusdigital.com/api/v1/order/entry",
  "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.00",
      "off_mkt_flag": "false",
      "remarks": "502929",
      "mkt_type": "NL",
      "settlor": "X",
      "group_id": "1"
    }
  }),
};

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

Response

200

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

Name	Description
status	The status of the response.
message	The message associated with the response.
data	An object containing the details of the order.
order_no	Order specific identification number