ETF 概况

本页定义目标 API，实际数据查询服务尚未实现。示例仅用于表达请求和响应格式。

数据产品标识：etf.overview 证券对象标识示例：510300.SH

接口名称

获取ETF 概况

接口说明

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

请求参数

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

返回字段

字段名	中文名称	类型	是否可空	字段说明
security_code	ETF 代码	string	否	ETF 在指定交易场所使用的证券代码。
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	是	交易市场类型

字段补充属性

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

请求示例

{
  "dataset_id": "etf.overview",
  "select": [
    "security_code",
    "security_name",
    "exchange",
    "listing_status",
    "listing_date",
    "manager_name",
    "tracking_index_code",
    "tracking_index_name"
  ],
  "where": [
    {
      "field": "security_code",
      "op": "eq",
      "value": "510300.SH"
    },
    {
      "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
  }
}

响应示例

{
  "dataset_id": "etf.overview",
  "fields": [
    "security_code",
    "security_name",
    "exchange",
    "listing_status",
    "listing_date",
    "manager_name",
    "tracking_index_code",
    "tracking_index_name"
  ],
  "data": [
    {
      "security_code": "000001.SZ",
      "security_name": "string",
      "exchange": "string",
      "listing_status": "string",
      "listing_date": "2026-08-10",
      "manager_name": "string",
      "tracking_index_code": "string",
      "tracking_index_name": "string"
    }
  ],
  "page": {
    "next_cursor": null,
    "complete": true
  }
}