Sector Returns

Retrieve the opening market cap of all sectors across various time periods.

GET/3.0/sectors/returns

Description

This endpoint returns an array of the opening market cap of all sectors for various time periods.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any query parameters.

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": [
        {
            "code": "0819",
            "ret": {
                "mc1m": 15030004571.34,
                "mc1w": 16378511193.560001,
                "mc1y": 13145913608,
                "mc3m": 14096084263,
                "mc6m": 17558023528,
                "mcfytd": 11491307679,
                "mcytd": 17777780444
            }
        },
        {
            "code": "0825",
            "ret": {
                "mc1m": 194063492661.34,
                "mc1w": 186228766565.38,
                "mc1y": 148687637062,
                "mc3m": 169999058595,
                "mc6m": 164609413254,
                "mcfytd": 153243956411,
                "mcytd": 169277160978
            }
        }
    ]
}

Response Fields

Field	Type	Description
code	string	Sector code identifier
ret	object	Opening market cap for various time periods - View

Market Cap Fields

Field	Type	Description
mc1w	number	Opening market cap for the 1 week period
mc1m	number	Opening market cap for the 1 month period
mc3m	number	Opening market cap for the 3 months period
mc6m	number	Opening market cap for the 6 months period
mc1y	number	Opening market cap for the 1 year period
mcytd	number	Opening market cap year-to-date
mcfytd	number	Opening market cap fiscal year-to-date

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Sector Returns for Specific Period

curl -X GET "https://csapis.com/3.0/sectors/returns" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Performance Analysis: Analyze sector performance across different time periods
• Return Comparison: Compare sector returns with market benchmark
• Stock Selection: Identify top and bottom performers within sector
• Portfolio Rebalancing: Use sector returns for portfolio allocation decisions
• Outperformance Tracking: Monitor sector performance vs market benchmark
• Historical Analysis: Track sector return trends over time