Fund Returns

Retrieve performance returns for a specific mutual fund across multiple time periods.

GET/3.0/funds/returns

Description

This endpoint returns performance data for mutual funds across multiple time periods, including 1-week, 1-month, 3-month, 6-month, and 1-year returns, as well as year-to-date and fiscal-year-to-date returns. The fiscal year runs 1 July – 30 June.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any query parameters.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "2602024a-9498-4898-ad61-eafc66dbe09a",
      "type": 1,
      "r1w": 0.0935,
      "r1m": 0.0911,
      "r3m": 0.0932,
      "r6m": 0.0996,
      "r1y": 0.1109,
      "rytd": 0.0954,
      "rfy": 0.0489
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Unique fund identifier (UUID)
type	integer	Return type (0: None, 1: Annualized, 2: Absolute)
r1w	number | null	1-week return (null when unavailable)
r1m	number | null	1-month return (null when unavailable)
r3m	number | null	3-month return (null when unavailable)
r6m	number | null	6-month return (null when unavailable)
r1y	number | null	1-year return (null when unavailable)
rytd	number | null	Year-to-date return (null when unavailable)
rfy	number | null	Fiscal-year-to-date return, fiscal year starts 1 July (null when unavailable)

A period is null when there is insufficient data to compute it — distinct from a 0 return.

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Fund Returns

curl -X GET "https://csapis.com/3.0/funds/returns" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Performance Analysis: Analyze fund returns across multiple time periods
• Return Comparison: Compare returns of different funds
• Investment Decision: Review historical returns to make investment decisions
• Performance Tracking: Monitor fund performance trends