基金财务数据

以下接口均必须传入 fund_type 与完整 thscode，返回统一 { timestamp, item[] } 数据容器，timestamp 为接口响应时间戳。

通用约定

• Base URL：https://fuyao.aicubes.cn。
• 必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
• 本页接口返回统一 ApiResponse 信封；时间戳均为毫秒级 Unix 时间戳，时区按 Asia/Shanghai。
• fund_type 取 otc、exchange 或 reits；thscode 必须保留市场后缀并与基金类型匹配。未披露字段保持 null，不补零。

通用请求参数

参数	类型	必需	默认值	说明
fund_type	string	是	—	otc（场外基金）/ exchange（ETF、LOF）/ reits（公募 REITs）。
thscode	string	是	—	完整基金 thscode，必须保留市场后缀。

基金财务指标

GET /api/fund/financials/indicators

MCP Tool：get_fund_financials_indicators

请求参数

参数	类型	必需	默认值	说明
fund_type	string	是	—	otc（场外基金）/ exchange（ETF、LOF）/ reits（公募 REITs）。
thscode	string	是	—	完整基金 thscode，必须保留市场后缀。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/financials/indicators?fund_type=exchange&thscode=510300.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "8e6d6e85c99447a2ae89e87b98aa9e7e",
  "data": {
    "timestamp": 1786690800000,
    "item": [
      {
        "start_date_ms": 1751328000000,
        "end_date_ms": 1759190400000,
        "publish_date_ms": 1760054400000,
        "distribution_profit": 1250000000.5,
        "current_profit": 1180000000.2,
        "share_nav": 4.753,
        "nav_rate": 3.21
      }
    ]
  }
}

返回字段

data.timestamp 为接口响应时间戳；data.item[] 字段：

字段	类型	说明
start_date_ms / end_date_ms / publish_date_ms	long	报告期起止时间与发布日期。
distribution_profit / current_profit / current_income	number	可分配利润、本期利润与本期收入。
distribution_share_profit	number	每份可分配利润。
average_nav_profit_margin / average_share_current_profit	number	平均净值利润率与平均每份本期利润。
share_nav / sum_share_nav	number	单位净值与累计单位净值。
asset_nav	number	基金资产净值。
sum_nav_rate / nav_rate	number	累计净值增长率与净值增长率。

基金利润表

GET /api/fund/financials/income-statements

MCP Tool：get_fund_financials_income_statements

请求参数

参数	类型	必需	默认值	说明
fund_type	string	是	—	otc（场外基金）/ exchange（ETF、LOF）/ reits（公募 REITs）。
thscode	string	是	—	完整基金 thscode，必须保留市场后缀。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/financials/income-statements?fund_type=exchange&thscode=510300.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "5bbd57b24cdd41c9b30f50ca5a57df6c",
  "data": {
    "timestamp": 1786690800000,
    "item": [
      {
        "start_date_ms": 1751328000000,
        "end_date_ms": 1759190400000,
        "publish_date_ms": 1760054400000,
        "total_income": 1680000000.2,
        "total_fee": 320000000.4,
        "total_profit": 1360000000.8,
        "net_profit": 1360000000.8
      }
    ]
  }
}

返回字段

data.timestamp 为接口响应时间戳；data.item[] 字段：

字段	类型	说明
start_date_ms / end_date_ms / publish_date_ms	long	报告期起止时间与发布日期。
income / total_income	number	收入与收入合计。
investment_income	number	投资收益。
stock_investment_income / bond_investment_income / fund_investment_income	number	股票、债券与基金投资收益。
dividend_income / interest_income	number	股利与利息收入。
fair_value_income / exchange_income / other_income	number	公允价值、汇兑及其他收入。
fee / total_fee	number	费用与费用合计。
manager_reward / custodian_fee / transaction_cost / tax_surcharge	number	管理人报酬、托管费、交易成本与税费。
total_profit / net_profit	number	利润总额与净利润。

基金资产负债表

GET /api/fund/financials/balance-sheets

MCP Tool：get_fund_financials_balance_sheets

请求参数

参数	类型	必需	默认值	说明
fund_type	string	是	—	otc（场外基金）/ exchange（ETF、LOF）/ reits（公募 REITs）。
thscode	string	是	—	完整基金 thscode，必须保留市场后缀。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/financials/balance-sheets?fund_type=exchange&thscode=510300.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "aaf01838ef4e44eda1a89a8a750f6fb1",
  "data": {
    "timestamp": 1786690800000,
    "item": [
      {
        "start_date_ms": 1751328000000,
        "end_date_ms": 1759190400000,
        "publish_date_ms": 1760054400000,
        "total_assets": 168000000000.0,
        "total_liability": 1200000000.0,
        "owner_total_equity": 166800000000.0,
        "liability_and_owner_equity": 168000000000.0
      }
    ]
  }
}

返回字段

data.timestamp 为接口响应时间戳；data.item[] 字段：

字段	类型	说明
start_date_ms / end_date_ms / publish_date_ms	long	报告期起止时间与发布日期。
total_assets	number	资产总计。
bank_deposit	number	银行存款。
fund_investment / stock_investment / bond_investment	number	基金、股票与债券投资。
transactional_financial_assets / other_assets	number	交易性金融资产与其他资产。
total_liability / other_liability	number	负债合计与其他负债。
owner_total_equity / undistributed_profit	number	所有者权益与未分配利润。
liability_and_owner_equity	number	负债和所有者权益总计。

通用鉴权与错误码参见基金 API 总览。