Holding Details

The Holding Update PayOut API endpoint processes a request to update payout details for a specified holding by ISIN ID, and it returns the updated holding quantities and status. This ensures accurate tracking of holding quantities post-update.

Endpoint

Base URL

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

Header Parameters

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

Request Parameter

Parameter	Value	Mandatory	Description
source	A	Y	Source of the request (e.g., "A")
ISIN_id	ISIN356566777	Y	ISIN CODE

Request

curl

cURL

curl --location 'https://connects.torusdigital.com/api/v1/holdings/details' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "source": "A",
    "data": {
        "ISIN_id": "INE669E01016"
    }
}'

Java

Java-Unirest

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/holdings/details")
  .header("Authorization", "Bearer {{token}}")
  .header("Content-Type", "application/json")
  .body("{\n" +
        "    \"source\": \"A\",\n" +
        "    \"data\": {\n" +
        "        \"ISIN_id\": \"INE669E01016\"\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/details"
	method := "POST"

	payload := strings.NewReader(`{
    "source": "A",
    "data": {
        "ISIN_id": "INE669E01016"
    }
  }`)

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

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

Response

200

{
    "status": "success",
    "message": "Success",
    "data": [
        {
            "Nse_Script_Code": "NA",
            "Sum_Of_Holding_Qty": "0",
            "BSE_Series": "NA",
            "NSE_Symbol": "NA",
            "BSE_Script_Code": "NA",
            "COST_PRICE": "NA",
            "Utilized_Qty": "0",
            "Remaining_Qty": "0",
            "BSE_Symbol": "NA",
            "NSE_Series": "NA"
        }
    ]
}

Response Parameter

Field	Explanation
Nse_Script_Code	The script code of the holding on the National Stock Exchange (NSE). NA indicates not applicable or not available.
Sum_Of_Holding_Qty	Total quantity of the holding.
BSE_Series	The series of the holding on the Bombay Stock Exchange (BSE). NA indicates not applicable or not available.
NSE_Symbol	The symbol of the holding on the National Stock Exchange (NSE). NA indicates not applicable or not available.
BSE_Script_Code	The script code of the holding on the Bombay Stock Exchange (BSE). NA indicates not applicable or not available.
COST_PRICE	The cost price of the holding. NA indicates not applicable or not available.
Utilized_Qty	Quantity of the holding that has been utilized.
Remaining_Qty	Remaining quantity of the holding.
BSE_Symbol	The symbol of the holding on the Bombay Stock Exchange (BSE). NA indicates not applicable or not available.
NSE_Series	The series of the holding on the National Stock Exchange (NSE). NA indicates not applicable or not available.