Fund Performance Rankings

API Overview

This API provides detailed performance data for a single fund. By passing the fund code, it returns the fund's gain/loss, average gain/loss for its category, category ranking, and excess return relative to the CSI 300 index across various time dimensions (last week, last month, last quarter, year-to-date, last two years, last three years, last five years).

Use Cases

• Financial News Applications: Display multi-dimensional historical performance trends and rankings on fund detail pages.
• Investment Research Analysis Tools: Quantitatively analyze fund long-term stability, comparing it against category averages and benchmark indices.
• Robo-Advisor Systems: Filter high-quality fund targets based on historical rankings and returns.

Request and Response Details

• Request Method: POST
• Core Parameters: fundCode (string, required), the six-digit code of the fund to be queried.
• Response Data:
• data.lastWeek / lastMonth / lastQuarter, etc.: Actual gain/loss for the corresponding period.
• data.lastWeekRank / lastMonthRank, etc.: Ranking within the same fund category for the corresponding period.
• data.lastWeekAvg / lastMonthAvg, etc.: Average gain/loss for funds in the same category for the corresponding period.
• data.lastWeekHS300, etc.: Performance relative to the CSI 300 index for the corresponding period.
• data.foundDate: Fund inception date.

Integration Suggestions

1. Caching Strategy: Fund net asset value and ranking data are typically updated once daily; it is recommended to cache query results for the same fund code locally for at least 24 hours to reduce API call costs.
2. Error Handling: Please check the returned code field; if it's a non-200 status code, error handling is required based on the msg prompt (e.g., fund code does not exist).
3. Data Display: When displaying rankings on the frontend, it is recommended to combine with total count fields like lastWeekCount to calculate percentage rankings (e.g., 'top 10%') to enhance user experience.