ETF数据

ETF历史份额规模接口文档

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

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

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

POST/apiapiname:etf_share_size

生产专线（默认）深圳http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api

请求参数

参数	类型	是否必选	示例值	描述
`apiname`	string（etf_share_size）	必选	`etf_share_size`	固定接口名称，用于选择对应的数据能力。
`apikey`	string	必选	`—`	猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
`fields`	string\|null	可选	`tradedate,symbol,name,code,total_share,total_size,nav,close,exchange`	需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
`params`	object	可选	`{"symbols":"510330","tradedate":"20260821","limit":6000,"offset":0}`	查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。

`params` 参数

参数	类型	是否必选	示例值	描述
`symbols`	string\|array<string>	可选	`510330,159915`	一个或多个 ETF 代码，支持单个代码、英文逗号分隔字符串或数组；可使用 6 位代码或带交易所后缀的完整代码。
`tradedate`	string	可选	`20260724`	查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate/recentdays 同时传。不传日期时默认最新完整数据日。
`startdate`	string	可选	`20260701`	查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。
`enddate`	string	可选	`20260724`	查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。
`recentdays`	integer	可选	`5`	最近 N 个已完成 ETF 份额数据日，最小值为 1；不能与 tradedate/startdate/enddate 同时传。
`limit`	integer	可选	`6000`	单次最大返回记录数，默认及最大均为 6000。
`offset`	integer	可选	`0`	分页偏移量，默认 0。
`exchange`	string（SSE / SZSE）	可选	`SSE`	交易所；SSE=上交所，SZSE=深交所。

`fields` 返回字段

字段顺序与接口样例保持一致

字段	类型	名称	示例值	描述
`tradedate`	string	交易日期	`20260821`	日期格式：YYYYMMDD。
`symbol`	string	ETF 代码	`510330`	6 位 ETF 代码。
`name`	string\|null	ETF 简称	`沪深300ETF华夏`	交易所公布的 ETF 证券简称。
`code`	string	完整 ETF 代码	`510330.SH`	包含交易所后缀的 ETF 代码。
`total_share`	number	总份额（万份）	`4741854.98`	交易所公布的当日 ETF 总份额。
`total_size`	number\|null	基金规模（元）	`228789800000`	总份额 × 10000 × 单位净值；单位净值缺失时返回 null。
`nav`	number\|null	单位净值（元/份）	`4.8249`	基金当日单位净值；数据源尚未发布时返回 null，不使用前值填充。
`close`	number\|null	收盘价（元/份）	`4.826`	当日未复权收盘价；行情缺失时返回 null，不参与基金规模计算。
`exchange`	string	交易所	`SSE`	SSE=上交所，SZSE=深交所。

请求与响应样例

固定样例

{
  "apiname": "etf_share_size",
  "apikey": "YOUR_API_KEY",
  "fields": "tradedate,symbol,name,code,total_share,total_size,nav,close,exchange",
  "params": {
    "symbols": "510330",
    "tradedate": "20260821",
    "limit": 6000,
    "offset": 0
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": [
      "tradedate",
      "symbol",
      "name",
      "code",
      "total_share",
      "total_size",
      "nav",
      "close",
      "exchange"
    ],
    "items": [
      [
        "20260821",
        "510330",
        "沪深300ETF华夏",
        "510330.SH",
        4741854.98,
        228789800000,
        4.8249,
        4.826,
        "SSE"
      ]
    ],
    "total": 1,
    "limit": 6000,
    "offset": 0
  }
}

请求参数

params 参数

fields 返回字段

请求与响应样例

相关接口

`params` 参数

`fields` 返回字段