Index Contributors

Retrieve companies that contribute to index point changes and their individual contributions.

GET/3.0/market/index/points

Description

This endpoint returns detailed information about which companies are contributing to index point changes and by how much. Shows the impact of each stock on the index value based on their weightings and price movements.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
code	string	Yes	Index code identifier	UPP9
date	string	No	Date for historical data (YYYY-MM-DD). If not provided, current date is used	2024-04-02
is_sector	string	No	Filter by sector (true/false). Default is false	false

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": [
        {
            "symbol": "MUREB",
            "sector": "0810",
            "index": "ALLSHR",
            "from": "2023-01-02",
            "to": "2023-08-01",
            "point": -4674.995483319208,
            "weight": 0.0011356866463752713,
            "mcc": 8326752931,
            "close": 301,
            "volume": 400,
            "high": 359.99,
            "low": 261.69,
            "change": -54,
            "change_pct": -0.15211267605633802
        }
    ]
}

Response Fields

Field	Type	Description
symbol	string	Stock symbol/ticker
sector	string	Sector code identifier
index	string	Index identifier
from	string	Start date range (YYYY-MM-DD)
to	string	End date range (YYYY-MM-DD)
point	number	Contribution to index points
weight	number	Stock weight in index as decimal
mcc	number	Market capitalization in currency units
close	number	Closing stock price
volume	number	Trading volume
high	number	High price during period
low	number	Low price during period
change	number	Absolute price change
change_pct	number	Price percentage change as decimal

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Index Code (200)

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

Examples

Get Index Contributors

curl -X GET "https://csapis.com/3.0/market/index/points?code=ALLSHR" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Index Analysis: Understand which stocks drive index movements
• Portfolio Impact: See how your holdings impact index
• Market Direction: Identify key stocks driving market moves
• Stock Selection: Focus on high-weight index contributors
• Performance Attribution: Understand index composition impact
• Trading Signals: Use contributor analysis for trading decisions