Net Positions

This API retrieves the net position for a specific account or set of accounts. It provides detailed information on current holdings, positions, and their associated values, allowing users to track and manage their investments effectively.

Endpoint

https://connects.torusdigital.com/api/v1/holdings/netposition

Header Parameters

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

Request Parameter

Parameter	Value	Mandatory	Description
source	M	Y	Source of the request (e.g., "M")
interop_flag	IP	Y	Indicates the interoperation flag status (e.g., IP).

Request

curl

cURL

curl -X 'POST' \
  'https://connects.torusdigital.com/api/v1/holdings/netposition' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {{token}}' \
  -H 'Content-Type: application/json' \
  -d '{
  "data": {
    "interop_flag": "IP"
  },
  "source": "M"
}'

Java

Java-Unirest

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/holdings/netposition")
  .header("Authorization", "Bearer {{token}}")
  .header("Content-Type", "application/json")
  .body("{\n" +
        "    \"source\": \"M\",\n" +
        "    \"data\": {\n" +
        "        \"interop_flag\": \"IP\"\n" +
        "    }\n" +
        "}")
  .asString();

Go

Go-Native

package main

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

func main() {
	url := "https://connects.torusdigital.com/api/v1/holdings/netposition"
	method := "POST"
	
	payload := strings.NewReader(`{
         "source": "M",
          "data": {
            "interop_flag": "IP"
           }
        }`)

	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/holdings/netposition",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {{token}}",
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({
    "source": "M",
    "data": {
      "interop_flag": "IP"
    }
  }),
};

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

Response

200

{
    "status": "success",
    "message": "Success",
    "data": [
        {
            "symbol": "RELIANCE",
            "net_qty": -1,
            "sell_avg": 2600,
            "buy_avg": 0,
            "gross_val": 2600,
            "instrument": "EQUITY",
            "realised_profit": 0,
            "client_id": "00001",
            "tot_buy_val_cf": 0,
            "tot_sell_qty": 1,
            "last_traded_price": 0,
            "tot_buy_qty_cf": 0,
            "segment": "E",
            "gross_qty": 1,
            "lot_size": 1,
            "security_id": "500325",
            "strike_price": 0,
            "cost_price": 0,
            "tot_sell_val": 2600,
            "product": "C",
            "tot_sell_val_cf": 0,
            "comm_multiplier": 1,
            "net_avg": -2600,
            "expiry_date": "0001-01-01",
            "mtm": 0,
            "rbi_reference_rate": 1,
            "tot_sell_qty_cf": 0,
            "tot_sell_val_day": 2600,
            "tot_buy_val": 0,
            "net_val": 2600,
            "display_name": "Reliance Industries",
            "exchange_inst_name": "ES",
            "cross_cur_flag": "N",
            "tot_buy_val_day": 0,
            "series": "A",
            "tot_sell_qty_day": 1,
            "opt_type": "NA",
            "exchange": "BSE",
            "tot_buy_qty_day": 0,
            "tot_buy_qty": 0,
            "mkt_type": "NL",
            "isin": "INE002A01018"
        }
    ],
}

Response Parameter

Parameter	Description
symbol	The stock symbol or code for the holding (e.g., "RELIANCE").
net_qty	The net quantity of the stock held (negative for short positions).
sell_avg	The average sell price of the stock.
buy_avg	The average buy price of the stock.
gross_val	The gross value of the position.
instrument	The type of instrument (e.g., "EQUITY").
realised_profit	The realized profit from the position.
client_id	The client identifier.
tot_buy_val_cf	The total buy value carried forward.
tot_sell_qty	The total sell quantity.
last_traded_price	The last traded price of the stock.
tot_buy_qty_cf	The total buy quantity carried forward.
segment	The segment of the stock (e.g., "E" for Equity).
gross_qty	The gross quantity of the stock.
lot_size	The lot size for the instrument.
security_id	The security ID of the stock (e.g., "500325" for Reliance Industries).
strike_price	The strike price for options (0 if not applicable).
cost_price	The cost price of the stock.
tot_sell_val	The total sell value of the position.
product	The product type (e.g., "C" for Cash).
tot_sell_val_cf	The total sell value carried forward.
comm_multiplier	The commission multiplier.
net_avg	The net average value of the position.
expiry_date	The expiry date for derivative contracts (default value if not applicable).
mtm	The mark-to-market value of the position.
rbi_reference_rate	The RBI reference rate.
tot_sell_qty_cf	The total sell quantity carried forward.
tot_sell_val_day	The total sell value for the day.
tot_buy_val	The total buy value of the position.
net_val	The net value of the position.
display_name	The display name of the stock (e.g., "Reliance Industries").
exchange_inst_name	The exchange and instrument name.
cross_cur_flag	The cross-currency flag status (e.g., "N").
tot_buy_val_day	The total buy value for the day.
series	The series of the stock (e.g., "A").
tot_sell_qty_day	The total sell quantity for the day.
opt_type	The option type (e.g., "NA" if not applicable).
exchange	The exchange where the stock is traded (e.g., "BSE" / NSE).
tot_buy_qty_day	The total buy quantity for the day.
tot_buy_qty	The total buy quantity of the position.
mkt_type	The market type (e.g., "NL" for normal).
isin	The ISIN (International Securities Identification Number) of the stock (e.g., "INE002A01018").