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

The unique company code identifier.

Request

cURL

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

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-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-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.

PreviousMonthly/Yearly Returns NextBalance Sheet

Last updated 1 year ago