ETF历史份额规模接口文档

查询沪深 ETF 历史总份额、单位净值、基金规模和未复权收盘价；总份额为万份，基金规模为元。

可按单只或多只 ETF 查询历史份额变化，也可按交易所分页获取全市场数据。

每日更新，并滚动修复最近 5 个交易日的延迟净值。

请求参数

• apiname（string（etf_share_size），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（object，可选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbols（string|array<string>，可选）：一个或多个 ETF 代码，支持单个代码、英文逗号分隔字符串或数组；可使用 6 位代码或带交易所后缀的完整代码。
• tradedate（string，可选）：查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate/recentdays 同时传。不传日期时默认最新完整数据日。
• startdate（string，可选）：查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。
• enddate（string，可选）：查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。
• recentdays（integer，可选）：最近 N 个已完成 ETF 份额数据日，最小值为 1；不能与 tradedate/startdate/enddate 同时传。
• limit（integer，可选）：单次最大返回记录数，默认及最大均为 6000。
• offset（integer，可选）：分页偏移量，默认 0。
• exchange（string（SSE / SZSE），可选）：交易所；SSE=上交所，SZSE=深交所。

返回字段

• tradedate（string）：日期格式：YYYYMMDD。
• symbol（string）：6 位 ETF 代码。
• name（string|null）：交易所公布的 ETF 证券简称。
• code（string）：包含交易所后缀的 ETF 代码。
• total_share（number）：交易所公布的当日 ETF 总份额。
• total_size（number|null）：总份额 × 10000 × 单位净值；单位净值缺失时返回 null。
• nav（number|null）：基金当日单位净值；数据源尚未发布时返回 null，不使用前值填充。
• close（number|null）：当日未复权收盘价；行情缺失时返回 null，不参与基金规模计算。
• exchange（string）：SSE=上交所，SZSE=深交所。