Asset Allocation

Retrieve asset allocation data for a specific mutual fund.

GET/3.0/funds/allocation

Description

This endpoint provides detailed asset allocation breakdown for a specific mutual fund, showing how the fund's investments are distributed across different asset classes (equity, debt, cash, etc.) over time periods. This information helps investors understand the fund's investment strategy and risk profile.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
fund_id	string	Yes	The unique identifier of the mutual fund.	FUND123

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": {
    "fund_id": "FUND123",
    "created": "2024-01-01T10:00:00Z",
    "modified": "2024-01-15T14:30:00Z",
    "frequency": "quarterly",
    "periods": [
      {
        "id": "Q1-2024",
        "label": "Q1 2024",
        "date": "2024-03-31"
      },
      {
        "id": "Q4-2023",
        "label": "Q4 2023",
        "date": "2023-12-31"
      }
    ],
    "rows": [
      {
        "key": "equity",
        "percent": true,
        "label": "Equity",
        "unit": "%",
        "heading": false,
        "values": [65.5, 68.2]
      },
      {
        "key": "debt",
        "percent": true,
        "label": "Debt",
        "unit": "%",
        "heading": false,
        "values": [25.3, 22.8]
      },
      {
        "key": "cash",
        "percent": true,
        "label": "Cash & Equivalents",
        "unit": "%",
        "heading": false,
        "values": [9.2, 9.0]
      }
    ]
  }
}

Response Fields

Field	Type	Description
fund_id	string	Unique identifier of the fund
created	string	Record creation timestamp (ISO 8601 format)
modified	string	Last modification timestamp (ISO 8601 format)
frequency	string	Update frequency (e.g., "quarterly", "monthly")
periods	object	Array of time periods with allocation data - View
rows	object	Array of allocation data rows - View

Period Fields (periods[])

Field	Type	Description
id	string	Unique period identifier
label	string	Human-readable period label
date	string	Period end date (YYYY-MM-DD)

Row Fields (rows[])

Field	Type	Description
key	string	Asset class identifier
percent	boolean	Whether values are percentages
label	string	Human-readable asset class name
unit	string	Unit of measurement
heading	boolean	Whether this is a heading row
values	array	Array of values corresponding to periods

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Parameter (200)

{
  "status": "error",
  "message": "No `fund_id` specified"
}

Examples

Get Fund Allocation Data

curl -X GET "https://csapis.com/3.0/funds/allocation?fund_id=FUND123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Portfolio Analysis: Understand how fund managers allocate assets across different classes
• Risk Assessment: Evaluate fund risk based on asset allocation mix
• Investment Strategy: Compare allocation strategies across different funds
• Performance Attribution: Analyze how asset allocation contributes to fund performance
• Regulatory Compliance: Meet reporting requirements for asset allocation disclosure