基金

基金模块提供基金资料、重仓股、净值、收益、持有人结构与行情数据查询。 基金资料、重仓股、净值、收益和持有人接口使用 (fund_type, thscode) 定位；行情接口只接收 thscode，当前仅支持 ETF。thscode 必须保留市场后缀。

功能分类

分类	路径前缀	说明
基金基本资料	/api/fund/profile	查询基金名称、成立日期、管理人与基金经理等基本资料。
基金重仓股	/api/fund/portfolio	查询基金定期披露的重仓股票。
基金净值与收益	/api/fund/performance	查询基金净值序列与区间收益。
基金持有人结构	/api/fund/holders	查询机构、个人投资者与持有人结构。
基金行情数据	/api/fund/market	查询场内基金行情快照与场内基金历史日线行情。

通用约定

• Base URL：https://fuyao.aicubes.cn。
• 必需请求头：X-api-key，缺失、无效或无权访问时返回认证/权限错误码。
• fund_type：otc（场外基金）/ exchange（ETF、LOF）/ reits；仅非行情接口需要传入。
• thscode：完整同花顺代码，例如 025480.OF、510300.SH、161725.SZ。
• 时间戳均为毫秒级 Unix 时间戳；收益率、占比与涨跌幅均为百分数原值，例如 8.88 表示 8.88%。

错误与约束

code	含义	基金场景
1001	缺少必填参数	非行情接口缺少 fund_type，或缺少 thscode、start、end。
1002	参数格式错误	历史行情 thscode 含逗号。
1003	参数值越界	枚举非法、start > end 或查询窗口超过 5 年。
1004	参数冲突	fund_type 多选，或基金类型与 thscode 所在分区不一致。
3001	标的不存在	找不到该基金。
3002	数据未就绪	标的存在，但暂无可用业务数据。
3004	标的类型不支持该能力	该基金类型不支持所请求的能力。