Skip to main content

Sector Allocation

Retrieve sector-wise allocation data for a specific mutual fund's equity portfolio.

GET/3.0/funds/sector-allocation

Description

This endpoint provides detailed sector allocation breakdown for a mutual fund's equity investments, showing how the fund's equity portfolio is distributed across different economic sectors. This information helps investors understand sector concentration, diversification, and exposure to specific industries.

Request

Authentication

  • Type: Bearer Token
  • Required: Yes

Parameters

NameTypeRequiredDescriptionExample
fund_idstringYesThe unique identifier of the mutual fund (see All Funds Overview for available funds)21779d41-ac2c-44ff-9091-6dfc55cd2256

Response

Success Response (200)

{
"status": "ok",
"message": "",
"data": {
"fund_id": "21779d41-ac2c-44ff-9091-6dfc55cd2256",
"created": "2025-12-28T03:43:57.734Z",
"modified": "2026-06-09T08:24:36.289Z",
"frequency": "monthly",
"periods": [
{
"label": "May 2026",
"date": "2026-05-30"
},
{
"label": "Apr 2026",
"date": "2026-04-29"
}
],
"rows": [
{
"label": "COMMERCIAL BANKS",
"values": [30.6, 29.8]
},
{
"label": "FERTILIZER",
"values": [14.6, 13.4]
},
{
"label": "MISCELLANEOUS",
"values": [14.5, 14.9]
},
{
"label": "OIL & GAS EXPLORATION COMPANIES",
"values": [10.6, 11.2]
},
{
"label": "POWER GENERATION & DISTRIBUTION",
"values": [10, 9.6]
}
]
}
}

Response Fields

FieldTypeDescription
fund_idstringUnique identifier of the fund
createdstringRecord creation timestamp (ISO 8601 format)
modifiedstringLast modification timestamp (ISO 8601 format)
frequencystringUpdate frequency (e.g., "quarterly", "monthly")
periodsarrayArray of time periods with allocation data - View
rowsarrayArray of sector allocation data rows - View

Period Fields (periods[])

FieldTypeDescription
labelstringHuman-readable period label
datestringPeriod end date (YYYY-MM-DD)

Row Fields (rows[])

FieldTypeDescription
labelstringHuman-readable sector name
valuesarrayArray of percentage values corresponding to periods

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Parameter (200)

{
"status": "error",
"message": "no `fund_id` provided"
}

Fund Not Found (200)

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

Examples

Get Fund Sector Allocation Data

curl -X GET "https://csapis.com/3.0/funds/sector-allocation?fund_id=21779d41-ac2c-44ff-9091-6dfc55cd2256" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

  • Sector Analysis: Understand fund exposure to different economic sectors
  • Risk Assessment: Evaluate sector concentration and diversification
  • Investment Strategy: Compare sector allocation across funds
  • Market Timing: Monitor sector rotation strategies
  • Performance Attribution: Analyze sector contributions to fund performance