Share Holding Pattern

This API retrieves the shareholding pattern for a given company, identified by its company code (cocode). It returns detailed information about the distribution of shares among different shareholder categories, including Domestic Institutional Investors & Mutual Funds (DIIMF), Foreign Institutional Investors (FII), insurance companies, mutual funds, promoters, and others, along with the total number of shares and record count for each period.

Note: cocode can be obtained from the Search Stock or Company Basic Detail API.

Endpoint

https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}

Request Parameter

Name	Mandatory	Description
cocode	Y	The unique company code identifier.

Request

curl

cURL

curl -X 'GET' \
  'https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}' \
  -H 'accept: application/json'

Java

Java-Unirest

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}")
  .header("Content-Type", "application/json")
  .asString();

Go

Go-Native

package main

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

func main() {
	url := "https://connects.torusdigital.com/api/v1/share-holding-pattern/{cocode}"
	method := "GET"

	client := &http.Client{}
	req, err := http.NewRequest(method, url, nil)

	if err != nil {
		fmt.Println(err)
		return
	}
	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/share-holding-pattern/{cocode}",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
};

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

Response

[
  {
    "DIIMFPer": 15.8476,
    "FIIPer": 21.2191,
    "insurancePer": 8.1716,
    "mutualFundsPer": 7.6474,
    "othersPer": 13.825500000000005,
    "promotersPer": 49.1078,
    "totalShares": 6766229014,
    "yearlyRecordCount": 202406
  },
  {
    "DIIMFPer": 15.5999,
    "FIIPer": 21.5285,
    "insurancePer": 8.2659,
    "mutualFundsPer": 7.3248,
    "othersPer": 13.762899999999993,
    "promotersPer": 49.1087,
    "totalShares": 6766109014,
    "yearlyRecordCount": 202403
  },
  {
    "DIIMFPer": 15.223400000000002,
    "FIIPer": 21.6136,
    "insurancePer": 8.3533,
    "mutualFundsPer": 6.8052,
    "othersPer": 14.054300000000008,
    "promotersPer": 49.1087,
    "totalShares": 6766109014,
    "yearlyRecordCount": 202312
  },
  {
    "DIIMFPer": 14.6889,
    "FIIPer": 22.0786,
    "insurancePer": 8.2178,
    "mutualFundsPer": 6.4056,
    "othersPer": 14.123800000000006,
    "promotersPer": 49.1087,
    "totalShares": 6766109014,
    "yearlyRecordCount": 202309
  }
]

Response Parameter

Parameters	Description
DIIMFPer	Percentage of shares held by Domestic Institutional Investors and Mutual Funds.
FIIPer	Percentage of shares held by Foreign Institutional Investors (FII).
insurancePer	Percentage of shares held by insurance companies.
mutualFundsPer	Percentage of shares held by mutual funds.
othersPer	Percentage of shares held by other shareholders.
promotersPer	Percentage of shares held by company promoters.
totalShares	Total number of shares outstanding.
yearlyRecordCount	Unique record identifier for the year, showing the time period of the data record.