历史份额规模

文档 v1.0.67 · 发布快照 1.0.78下载 meoz Skill最新文档

根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。

正式接口 · meoz 接口目录

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

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

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

接口名称 etf_share_size

请求方法 POST /api

  • https://sz.meoz.cn:6688
  • https://sh.meoz.cn:6688

返回字段

字段 名称 类型 描述 单位
tradedate 交易日期 string 日期格式:YYYYMMDD。
symbol ETF 代码 string 6 位 ETF 代码。
name ETF 简称 string|null 交易所公布的 ETF 证券简称。
code 完整 ETF 代码 string 包含交易所后缀的 ETF 代码。
total_share 总份额(万份) number 交易所公布的当日 ETF 总份额。
total_size 基金规模(元) number|null 总份额 × 10000 × 单位净值;单位净值缺失时返回 null。
nav 单位净值(元/份) number|null 基金当日单位净值;数据源尚未发布时返回 null,不使用前值填充。
close 收盘价(元/份) number|null 当日未复权收盘价;行情缺失时返回 null,不参与基金规模计算。
exchange 交易所 string SSE=上交所,SZSE=深交所。

请求

{"content":{"application/json":{"example":{"apikey":"","apiname":"etf_share_size","fields":"tradedate,symbol,name,code,total_share,total_size,nav,close,exchange","params":{"limit":6000,"offset":0,"symbols":"510330","tradedate":"20260821"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"etf_share_size","description":"接口名称","enum":["etf_share_size"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"tradedate,symbol,name,code,total_share,total_size,nav,close,exchange","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `tradedate` | `string` | 交易日期 | `20260821` | 日期格式:YYYYMMDD。 |\n| `symbol` | `string` | ETF 代码 | `510330` | 6 位 ETF 代码。 |\n| `name` | `string\\|null` | ETF 简称 | `沪深300ETF华夏` | 交易所公布的 ETF 证券简称。 |\n| `code` | `string` | 完整 ETF 代码 | `510330.SH` | 包含交易所后缀的 ETF 代码。 |\n| `total_share` | `number` | 总份额(万份) | `4741854.98` | 交易所公布的当日 ETF 总份额。 |\n| `total_size` | `number\\|null` | 基金规模(元) | `228789800000` | 总份额 × 10000 × 单位净值;单位净值缺失时返回 null。 |\n| `nav` | `number\\|null` | 单位净值(元/份) | `4.8249` | 基金当日单位净值;数据源尚未发布时返回 null,不使用前值填充。 |\n| `close` | `number\\|null` | 收盘价(元/份) | `4.826` | 当日未复权收盘价;行情缺失时返回 null,不参与基金规模计算。 |\n| `exchange` | `string` | 交易所 | `SSE` | SSE=上交所,SZSE=深交所。 |"},"params":{"default":{"limit":6000,"offset":0,"symbols":"510330","tradedate":"20260821"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string\\|array` | 可选 | `510330,159915` | 一个或多个 ETF 代码,支持单个代码、英文逗号分隔字符串或数组;可使用 6 位代码或带交易所后缀的完整代码。 |\n| `tradedate` | `string` | 可选 | `20260724` | 查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate/recentdays 同时传。不传日期时默认最新完整数据日。 |\n| `startdate` | `string` | 可选 | `20260701` | 查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 |\n| `enddate` | `string` | 可选 | `20260724` | 查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 |\n| `recentdays` | `integer` | 可选 | `5` | 最近 N 个已完成 ETF 份额数据日,最小值为 1;不能与 tradedate/startdate/enddate 同时传。 |\n| `limit` | `integer` | 可选 | `6000` | 单次最大返回记录数,默认及最大均为 6000。 |\n| `offset` | `integer` | 可选 | `0` | 分页偏移量,默认 0。 |\n| `exchange` | `string` | 可选 | `SSE` | 交易所;SSE=上交所,SZSE=深交所。 |","properties":{"enddate":{"description":"查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。","example":"20260724","pattern":"^\\d{8}$","type":"string"},"exchange":{"description":"交易所;SSE=上交所,SZSE=深交所。","enum":["SSE","SZSE"],"example":"SSE","type":"string"},"limit":{"default":6000,"description":"单次最大返回记录数,默认及最大均为 6000。","example":6000,"maximum":6000,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"分页偏移量,默认 0。","example":0,"minimum":0,"type":"integer"},"recentdays":{"description":"最近 N 个已完成 ETF 份额数据日,最小值为 1;不能与 tradedate/startdate/enddate 同时传。","example":5,"maximum":10000,"minimum":1,"type":"integer"},"startdate":{"description":"查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。","example":"20260701","pattern":"^\\d{8}$","type":"string"},"symbols":{"description":"一个或多个 ETF 代码,支持单个代码、英文逗号分隔字符串或数组;可使用 6 位代码或带交易所后缀的完整代码。","example":"510330,159915","oneOf":[{"description":"单个或多个英文逗号分隔的 ETF 代码","type":"string"},{"description":"ETF 代码数组","items":{"type":"string"},"type":"array"}]},"tradedate":{"description":"查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate/recentdays 同时传。不传日期时默认最新完整数据日。","example":"20260724","pattern":"^\\d{8}$","type":"string"}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `etf_share_size` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}

响应

{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"ETF 历史份额规模分页返回数据","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["tradedate","symbol","name","code","total_share","total_size","nav","close","exchange"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条记录,列顺序与 fields 一一对应","example":[["20260821","510330","沪深300ETF华夏","510330.SH",4741854.98,228789800000,4.8249,4.826,"SSE"]],"items":{"items":{},"type":"array"},"type":"array"},"limit":{"description":"本次请求的最大返回记录数","example":6000,"type":"integer"},"offset":{"description":"本次请求的分页偏移量","example":0,"type":"integer"},"total":{"description":"返回的记录总数","example":1,"type":"integer"}},"required":["fields","items","total","limit","offset"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}