Index Constituents

Retrieve constituent companies and their components for a specific market index.

GET/3.0/market/index/constituents

Description

This endpoint returns detailed information about the constituent companies that make up a specific market index, including their actions, weightings, and other component details.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
code	string	No	Index code identifier	KSE100
page	integer	Yes	Page number for pagination. Default is 1	1

Response

Success Response (200)

{
  "status": "ok",
  "offset": 0,
  "count": 50,
  "total": 278,
  "data":[
      {
          "id": "677bd52e07cdfd390e548beb",
          "cd": "KSE100",
          "ac": 1,
          "sy": "ENGROH",
          "dt": "2025-01-06",
          "crt": "2025-01-06T13:05:50.568Z",
          "mod": "2025-01-06T13:05:50.568Z"
      },
      {
          "id": "677bd52f07cdfd390e548bec",
          "cd": "KSE100",
          "ac": 1,
          "sy": "KTML",
          "dt": "2025-01-06",
          "crt": "2025-01-06T13:05:51.128Z",
          "mod": "2025-01-06T13:05:51.128Z"
      },
    ]
}

Response Fields

Field	Type	Description
id	string	Unique identifier
cd	string	Index code
ac	integer	Action status (1=Active, 0=Inactive)
sy	string	Stock symbol
dt	string	Date of record (YYYY-MM-DD)
crt	string	Creation timestamp (ISO 8601)
mod	string	Last modification timestamp (ISO 8601)

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing page parameter (200)

{
    "status": "error",
    "message": "no_page_provided"
}

Examples

Get Index Constituents

curl -X GET "https://csapis.com/3.0/market/index/constituents?code=KSE100&page=1" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Index Composition: Get complete list of index constituent companies
• Index Tracking: Understand which stocks make up the index
• Rebalancing Information: Track index composition changes
• Investment Analysis: Analyze index components for investment decisions
• Portfolio Benchmarking: Compare portfolio with index constituents
• Risk Analysis: Understand index concentration and diversification