ETF数据

ETF基础信息接口文档

查询 ETF 基础资料，用于获取 ETF 代码、名称、基金类型、管理人、托管人、上市退市日期和市场状态。

POST/apiapiname:etf_basic

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

请求参数

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

`params` 参数

参数	类型	是否必选	示例值	描述
`symbols`	string\|array<string>	可选	`510300`	ETF 代码，支持单个代码、多个英文逗号分隔代码或数组；不传则默认全部未退市 ETF。
`keyword`	string	可选	`上证50`	关键词，按 ETF 代码、名称、管理人、托管人或投资类型检索。
`market`	string	可选	`E`	市场代码，默认基础数据使用场内基金市场。
`list_date`	string	可选	`20050223`	上市日期，格式：YYYYMMDD。
`include_delisted`	boolean	可选	`false`	是否包含已退市 ETF。默认 false。

`fields` 返回字段

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

字段	类型	名称	示例值	描述
`code`	string	完整 ETF 代码	`510300.SH`	包含交易所后缀的 ETF 代码。
`symbol`	string	ETF 代码	`510300`	6 位 ETF 代码。
`name`	string\|null	ETF 简称	`沪深300ETF`	ETF 证券简称。
`management`	string\|null	基金管理人	`华泰柏瑞基金`	基金管理机构。
`custodian`	string\|null	基金托管人	`中国工商银行`	基金资产托管机构。
`fund_type`	string\|null	投资类型	`股票型`	基金主要投资资产类型。
`found_date`	string\|null	成立日期	`20120504`	日期格式：YYYYMMDD。
`due_date`	string\|null	到期日期	`—`	日期格式：YYYYMMDD；无固定到期日时返回 null。
`list_date`	string\|null	上市日期	`20120528`	日期格式：YYYYMMDD。
`issue_date`	string\|null	发行日期	`20120423`	日期格式：YYYYMMDD。
`delist_date`	string\|null	退市日期	`—`	日期格式：YYYYMMDD；未退市时返回 null。
`issue_amount`	number\|null	发行份额（亿份）	`54.35`	基金首次发行份额。
`m_fee`	number\|null	管理费率（%）	`0.5`	基金合同约定的年管理费率。
`c_fee`	number\|null	托管费率（%）	`0.1`	基金合同约定的年托管费率。
`duration_year`	number\|null	存续期限（年）	`—`	基金约定的存续期限；不定期基金可能返回 null。
`p_value`	number\|null	基金面值（元）	`1`	基金份额初始面值。
`min_amount`	number\|null	募集最低金额（万元）	`0.1`	基金募集或申购的起点金额。
`exp_return`	number\|null	预期收益率（%）	`—`	数据源提供的预期收益率；无该项时返回 null。
`benchmark`	string\|null	业绩比较基准	`沪深300指数`	基金合同约定的业绩比较基准。
`status`	string\|null	存续状态	`L`	基金当前上市或存续状态。
`invest_type`	string\|null	投资风格	`被动指数型`	基金的投资运作风格。
`type`	string\|null	基金类型	`契约型开放式`	数据源中的基金组织或运作类型。
`trustee`	string\|null	受托人	`—`	数据源记录的受托机构；无该项时返回 null。
`purc_startdate`	string\|null	申购起始日期	`20120528`	日期格式：YYYYMMDD。
`redm_startdate`	string\|null	赎回起始日期	`20120528`	日期格式：YYYYMMDD。
`market`	string\|null	场内外标识	`E`	E=场内基金，O=场外基金。

请求与响应样例

固定样例

{
  "apiname": "etf_basic",
  "apikey": "YOUR_API_KEY",
  "fields": "symbol,name,fund_type,management,custodian,list_date,delist_date,status,market",
  "params": {
    "symbols": "510300",
    "include_delisted": false
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": [
      "symbol",
      "name",
      "fund_type",
      "management",
      "custodian",
      "list_date",
      "delist_date",
      "status",
      "market"
    ],
    "items": [
      [
        "510300",
        "沪深300ETF",
        "股票型",
        "华泰柏瑞基金",
        "中国工商银行",
        "20120528",
        null,
        "L",
        "E"
      ]
    ]
  }
}

请求参数

params 参数

fields 返回字段

请求与响应样例

相关接口

`params` 参数

`fields` 返回字段