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-day, 15-day, 1-month, 3-month, 6-month, 1-year, 2-year, and 3-year returns, as well as month-to-date and year-to-date returns.

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",
      "ref_id": "AGCF",
      "ret_ty": 1,
      "ret": {
        "1d": 0.0982,
        "15d": 0.0948,
        "30d": 0.0911,
        "90d": 0.0932,
        "180d": 0.0996,
        "365d": 0.1109,
        "2y": 0.1737,
        "3y": 0.2048,
        "mtd": 0.0937,
        "ytd": 0.0954
      }
    }
  ] 
}

Response Fields

Field	Type	Description
id	string	Unique fund identifier (UUID)
ref_id	string	Reference ID / Fund symbol
ret_ty	integer	Return type (0: None, 1: Annualized, 2: Absolute)
ret	object	Returns by period - View

Returns (ret)

Period	Type	Description
1d	number	1-day return
15d	number	15-day return
30d	number	1-month return
90d	number	3-month return
180d	number	6-month return
365d	number	1-year return
2y	number	2-year return
3y	number	3-year return
mtd	number	Month-to-date return
ytd	number	Year-to-date 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