Mutual Fund Trend Data

API Overview

This API provides financial data query services based on fund codes. Upon entering a fund code, it returns the fund's type (e.g., hybrid, stock, bond), gain/loss data across various time dimensions (last week, month, quarter, half-year, year), and a list of historical fund trends including specific dates and net asset values. This data is suitable for applications requiring fund performance display.

Use Cases

• Financial News Apps: Display recent performance and historical net asset value curves on fund detail pages.
• Investment Advisor Analysis Tools: Quickly compare yield changes of different funds over specific periods.
• Personal Accounting/Wealth Management Software: Help users track periodic gains and losses of their held funds.
• Data Visualization Dashboards: Serve as a backend data source to render long-term fund trend charts.

Request and Response Details

• Request Method: POST
• Core Parameters: fundCode (string, required), the unique code of the target fund.
• Response Data:
• fundType: Fund classification identifier (BLEND Hybrid, STOCK Equity, INDEX Index, BOND Bond, CURRENCY Money Market).
• lastWeek/lastMonth/lastQuarter/lastHalfYear/lastYear: Gain/loss values for each period (Note: The returned value is a decimal; it needs to be multiplied by 100% to convert to a percentage for display).
• fundAndIndexYieldVoPair: Contains the fund name and a fundTrends array, where each object in the array includes reportDate (timestamp) and value (unit net asset value), used for drawing trend charts.

Integration Suggestions

1. Value Processing: The gain/loss returned by the API is in decimal format (e.g., -0.3620); please ensure it is converted to percentage format (-36.20%) for frontend display.
2. Timestamp Conversion: reportDate and serverTime are both millisecond-level timestamps; they need to be converted to a standard date format during parsing.
3. Caching Strategy: Fund net asset values are typically updated on trading days, and data remains unchanged during non-trading hours. It is recommended to set an appropriate cache time (e.g., 24 hours) for requests with the same fundCode to reduce API call costs and improve response speed.
4. Error Handling: Please check the returned code field; 200 indicates success. Other status codes require combining with the msg field for error prompts.