Order Details

Retrieve the latest status of a specific order through the API. Orders initiated by the user are accessible for one trading day and are automatically purged at the session's closure

Endpoint

Base URL

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

Header Parameters

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

Request Parameter

Parameter	Sample/Possible Value	Mandatory	Description
source	N	Y	Source of the request (e.g., "N")
order_no	0123456789	Y	Order Number for which details are required
segment	E	Y	Segment of that order. "E" stands for Equity

Request

curl

cURL

curl --location 'https://connects.torusdigital.com/api/v1/order/details' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "source": "N",
    "data": {
        "order_no": "1161240610102",
        "segment": "E"
    }
}'

Java

Java-Unirest

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/order/details")
  .header("Authorization", "Bearer {{token}}")
  .header("Content-Type", "application/json")
  .body("{" +
          "\n    \"source\": \"N\"," +
          "\n    \"data\": {" +
          "\n        \"order_no\": \"1161240610102\"," +
          "\n        \"segment\": \"E\"" +
          "\n    }" +
          "\n}")
  .asString();

Go

Go-Native

package main

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

func main() {
	url := "https://connects.torusdigital.com/api/v1/order/details"
	method := "POST"

	payload := strings.NewReader(`{
    "source": "N",
    "data": {
        "order_no": "1161240610102",
        "segment": "E"
    }
}`)

	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/details",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {{token}}",
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({
    "source": "N",
    "data": {
      "order_no": "1161240610102",
      "segment": "E"
    }
  }),
};

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

Response Parameter

200

{
    "data": [
        {
            "order_no": "1141240514100",
            "good_till_days_date": "2024-05-14",
            "placed_by": "CUSTOMER",
            "symbol": "IDEA",
            "mkt_pro_flag": "N",
            "mkt_pro_value": 0,
            "pan_no": "BBTPS7354E",
            "instrument": "EQUITY",
            "source": "M",
            "remaining_quantity": 2,
            "disc_quantity": 0,
            "encash_flag": "N",
            "participant_type": "B",
            "price": 0,
            "traded_quantity": 0,
            "lot_size": 1,
            "order_type": "MKT",
            "security_id": "14366",
            "source_name": "MOB_WEB",
            "strike_price": 0,
            "product": "C",
            "settlor": "90245",
            "quantity": 2,
            "order_date_time": "2024-05-14 10:50:06",
            "expiry_date": "0001-01-01",
            "reason_description": "Fund Limit Insufficient. Insuff By 9.83 & Available Amount 15.77. Order Amount Is 25.60",
            "entity_id": "TOR001",
            "exch_order_no": "0",
            "display_name": "VODAFONE IDEA LIMITED",
            "product_name": "CNC",
            "exchange_inst_name": "Other",
            "last_updated_time": "2024-05-14 10:50:06",
            "trigger_price": 0,
            "placed_by_entity_id": "TOR001",
            "txn_type": "B",
            "series": "EQ",
            "exch_order_time": "0001-01-01 00:00:00",
            "opt_type": "XX",
            "exchange": "NSE",
            "error_code": "E0001",
            "validity": "DAY",
            "serial_no": 1,
            "mkt_type": "NL",
            "isin": "INE669E01016",
            "status": "Rejected"
        }
    ],
    "message": "Success",
    "status": "success"
}

Response Parameter

Parameter	Description
entity_id	Identifier for the legal entity associated with the order.
exch_order_no	The unique number assigned by the exchange to the order.
exchange	The specific stock exchange where the order is placed (e.g., NYSE, NASDAQ).
txn_type	The type of transaction, such as 'buy' or 'sell'.
symbol	The ticker symbol representing the security being traded.
quantity	The total number of shares or contracts being ordered.
remaining_quantity	The number of shares or contracts that are yet to be traded.
traded_quantity	The number of shares or contracts that have already been traded.
product	Code representing the type of financial product being traded.
product_name	The full name of the financial product being traded.
order_date_time	The date and time when the order was initially entered into the system.
exch_order_time	The date and time when the order was received by the exchange.
last_updated_time	The most recent date and time when any details of the order were updated.
status	The current status of the order (e.g., pending, executed, cancelled).
price	The price at which the order is to be executed.
trigger_price	The specified price that triggers the execution of a stop order.
order_type	The type of order, such as 'market order' or 'limit order'.
error_message	Any error messages related to the order, if applicable.
disc_quantity	The portion of the order quantity that is disclosed to the market.
validity	The validity period of the order (e.g., 'day', 'GTC' for Good Till Cancelled).
serial_no	A unique serial number assigned to the order for tracking purposes.
source	The origin of the order (e.g., 'online', 'phone').
order_no	An internal order number used by the brokerage or trading system.
pan_no	The Permanent Account Number of the client, used for tax purposes.
participant_type	The type of participant placing the order (e.g., 'individual', 'institutional').
mkt_pro_flag	Indicates if the order is protected by market protection rules.
mkt_pro_value	The value associated with market protection rules for the order.
settlor	The entity responsible for settling the trade.
encash_flag	Indicates if the order is to be converted to cash.
mkt_type	The market type, such as 'regular' or 'after-hours'.
good_till_days_date	The specific date until which the order remains valid.
instrument	The name of the financial instrument being traded.
strike_price	The strike price for options contracts.
expiry_date	The expiry date for options or futures contracts.
opt_type	The type of option, such as 'call' or 'put'.
lot_size	The standard size of the lot in the order.
series	The series of the instrument.
isin	The International Securities Identification Number (ISIN) for the instrument.
display_name	A custom name used for displaying the symbol.
exchange_inst_name	The name of the instrument as per the exchange's listing.
error_code	A code that represents any errors encountered with the order.
placed_by	The identifier of the person who placed the order.
placed_by_entity_id	The identifier of the entity associated with the person who placed the order.