Sector Returns

Calculate and retrieve returns of a sector using market cap weighted returns.

GET/3.0/sectors/returns

Description

This endpoint calculates and returns market cap weighted returns for a specific sector.

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": "TECH",
      "ret": {
        "mc1w": 3.12,
        "mcwtd": 5.45,
        "mc1m": 7.89,
        "mcmtd": 9.34,
        "mc3m": 15.67,
        "mc3mtd": 17.23,
        "mc6m": 22.45,
        "mc1y": 30.12,
        "mcytd": 4.56,
        "mcfytd": 10.78,
        "mc2y": 50.34,
        "mc3y": 75.89
      },
    },
    {
      "code": "HEALTH",
      "ret": {
        "mc1w": 1.85,
        "mcwtd": 3.67,
        "mc1m": 4.92,
        "mcmtd": 5.78,
        "mc3m": 10.34,
        "mc3mtd": 11.56,
        "mc6m": 15.89,
        "mc1y": 20.45,
        "mcytd": 2.34,
        "mcfytd": 6.12,
        "mc2y": 35.67,
        "mc3y": 55.23
      },
    },
  ]
}

Response Fields

Field	Type	Description
code	string	Sector code identifier
ret	object	Market cap weighted returns for various time periods - View

Market Cap Returns Fields

Field	Type	Description
mc1w	number	Market cap return for 1 week period (%)
mcwtd	number	Market cap return week-to-date (%)
mc1m	number	Market cap return for 1 month period (%)
mcmtd	number	Market cap return month-to-date (%)
mc3m	number	Market cap return for 3 months period (%)
mc3mtd	number	Market cap return 3 months to date (%)
mc6m	number	Market cap return for 6 months period (%)
mc1y	number	Market cap return for 1 year period (%)
mcytd	number	Market cap return year-to-date (%)
mcfytd	number	Market cap return fiscal year-to-date (%)
mc2y	number	Market cap return for 2 years period (%)
mc3y	number	Market cap return for 3 years period (%)

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