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