ETF 概况

数据集标识：etf.overview；证券对象标识示例：XSHG:510300

ETF 代码、名称、管理人、跟踪指数、上市日期和状态。

接口

用途	方法与路径
查询数据	`POST /v1/datasets/etf.overview/query`
契约与当前发布	`GET /v1/datasets/etf.overview`
准备批量快照	`POST /v1/datasets/etf.overview/preparations`

请求参数

可在请求体 where 中作为 field 使用的筛选参数，名称保持契约原名。

参数名	类型	必填	说明
`asset_id`	`string`	否	筛选一个或多个标的标识（<场所码>:<代码>）。
`security_code`	`string`	否	筛选一个或多个 ETF 代码。
`market`	`string`	否	市场代码；中文客户端默认 CN。
`start_date`	`date`	否	查询开始日期，包含该日。
`end_date`	`date`	否	查询结束日期，包含该日。

返回字段

列名保持契约原名，可直接用于 select、where 与结果行。

字段名	中文名称	类型	可空	说明
`asset_id`	标的标识	`string`	否	与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为 ISO 10383 MIC，例如 XSHE:000001。
`security_code`	ETF 代码	`string`	否	展示别名：带市场后缀的证券代码，例如 000001.SZ；由 asset_id 换算，不作业务键。
`market`	市场	`string`	否	标的挂牌场所所在的市场，ISO 3166-1 alpha-2 代码，例如 CN；由 asset_id 的场所导出。
`security_name`	ETF 简称	`string`	否	ETF 当前业务有效区间内的简称。
`exchange`	交易所	`string`	否	ETF 挂牌交易所代码。
`listing_status`	挂牌状态	`string`	否	ETF 当前待上市、已上市或已退市状态。
`listing_date`	上市日期	`date`	是	ETF 正式上市交易的业务日期。
`manager_name`	管理人名称	`string`	是	ETF 基金管理人简称。
`tracking_index_code`	跟踪指数代码	`string`	是	ETF 主要跟踪指数的代码。
`tracking_index_name`	跟踪指数名称	`string`	是	ETF 主要跟踪指数的名称。
`currency`	交易币种	`string`	否	ISO 4217 交易币种代码
`full_name`	ETF 全称	`string`	是	ETF 全称
`exchange_short_name`	交易所简称	`string`	是	交易所登记的 ETF 扩位简称。
`inception_date`	成立日期	`date`	是	成立日期
`custodian_name`	托管人	`string`	是	托管人
`management_fee_rate`	管理费率	`decimal`	是	基金年费率，以小数比例表示；0.005 表示 0.5%。
`etf_type`	ETF 类型	`string`	是	ETF 类型
`investment_type`	投资类型	`string`	是	ETF 投资通道类型，例如境内投资或 QDII。
`maturity_date`	到期日期	`date`	是	到期日期
`issuance_date`	发行日期	`date`	是	发行日期
`delisting_date`	退市日期	`date`	是	退市日期
`initial_offering_shares`	初始发行份额	`decimal`	是	初始发行份额
`custodian_fee_rate`	托管费率	`decimal`	是	基金年费率，以小数比例表示；0.005 表示 0.5%。
`term_years`	存续年限	`decimal`	是	存续年限
`par_value`	面值	`decimal`	是	面值
`minimum_subscription_amount`	最低申购金额	`decimal`	是	最低申购金额
`expected_return`	预期收益率	`decimal`	是	预期收益率
`benchmark_description`	业绩基准	`string`	是	业绩基准
`fund_status`	基金状态	`string`	是	基金状态
`investment_style`	投资风格	`string`	是	投资风格
`fund_type`	基金类型	`string`	是	基金类型
`trustee_name`	受托人	`string`	是	受托人
`subscription_start_date`	申购起始日期	`date`	是	申购起始日期
`redemption_start_date`	赎回起始日期	`date`	是	赎回起始日期
`market_type`	交易市场类型	`string`	是	交易市场类型

字段补充属性

括号中是契约描述（GET /v1/datasets/{datasetId} 的 fields）里的键名。

字段名	属性
`currency`	标准（`standard`）：ISO 4217
`management_fee_rate`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：ratio
`initial_offering_shares`	精度（`precision`）：38；小数位数（`scale`）：18
`custodian_fee_rate`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：ratio
`term_years`	精度（`precision`）：38；小数位数（`scale`）：18
`par_value`	精度（`precision`）：38；小数位数（`scale`）：18
`minimum_subscription_amount`	精度（`precision`）：38；小数位数（`scale`）：18
`expected_return`	精度（`precision`）：38；小数位数（`scale`）：18

请求示例

向 https://api.<环境域名>/v1/datasets/etf.overview/query 发送 POST 请求（服务地址的替换方式见快速开始），请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json，请求体如下：

{
  "select": [
    "asset_id",
    "security_code",
    "security_name",
    "exchange",
    "listing_status",
    "listing_date",
    "manager_name",
    "tracking_index_code",
    "tracking_index_name"
  ],
  "where": [
    {
      "field": "market",
      "op": "eq",
      "value": "CN"
    },
    {
      "field": "listing_date",
      "op": "gte",
      "value": "2026-01-01"
    },
    {
      "field": "listing_date",
      "op": "lte",
      "value": "2026-08-10"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例

实际结果随数据更新而变化；data 为空数组表示请求范围内没有可返回的记录。

{
  "datasetId": "etf.overview",
  "fields": [
    "asset_id",
    "security_code",
    "security_name",
    "exchange",
    "listing_status",
    "listing_date",
    "manager_name",
    "tracking_index_code",
    "tracking_index_name"
  ],
  "data": [],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}

接口​

请求参数​

返回字段​

字段补充属性​

请求示例​

响应示例​

接口

请求参数

返回字段

字段补充属性

请求示例

响应示例