Top Holdings

Retrieve the top holdings and their allocations for a specific mutual fund across multiple periods.

GET/3.0/funds/top-holdings

Description

This endpoint returns the top holdings of a mutual fund with their percentage allocations over multiple periods. It provides historical data showing how the fund's portfolio composition has changed over time.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
fund_id	string	Yes	The 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.841Z",
    "modified": "2026-06-09T08:24:36.394Z",
    "frequency": "quarterly",
    "periods": [
      {
        "label": "May 2026",
        "date": "2026-05-30"
      },
      {
        "label": "Apr 2026",
        "date": "2026-04-29"
      },
      {
        "label": "Mar 2026",
        "date": "2026-03-30"
      }
    ],
    "rows": [
      {
        "label": "BAFL",
        "values": [
          9.4,
          9.6,
          10.8
        ]
      },
      {
        "label": "POL",
        "values": [
          10.6,
          11.2,
          11.2
        ]
      }
    ]
  }
}

Response Fields

Field	Type	Description
fund_id	string	Fund identifier
created	string	Data creation timestamp (ISO 8601 format)
modified	string	Last modification timestamp (ISO 8601 format)
frequency	string	Reporting frequency (e.g., "quarterly")
periods	array	Array of time periods with holdings data - View
rows	array	Array of holding records - View

Period Fields (periods[])

Field	Type	Description
label	string	Human-readable period label (e.g., "Jul 2022")
date	string	Period end date (YYYY-MM-DD)

Row Fields (rows[])

Field	Type	Description
label	string	Security name/symbol (e.g., "MARI", "UBL")
values	array	Array of allocation values for each period (percentage or 0 if not held)

Error Responses

For detailed Common Error responses, see the Error Handling.

No Fund ID Provided (200)

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

Examples

Get Fund Top Holdings Data

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

Use Cases

• Portfolio Composition Analysis: Understand the fund's top holdings and their weightings
• Historical Tracking: Monitor changes in fund allocations over multiple periods
• Investment Research: Compare holding strategies across different mutual funds
• Risk Analysis: Identify key positions and concentration risks
• Rebalancing Decisions: Track how portfolio weights have changed over time