基础信息

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

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

正式接口 · meoz 接口目录

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

接口名称 etf_basic

请求方法 POST /api

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

返回字段

字段 名称 类型 描述 单位
code 完整 ETF 代码 string 包含交易所后缀的 ETF 代码。
symbol ETF 代码 string 6 位 ETF 代码。
name ETF 简称 string|null ETF 证券简称。
management 基金管理人 string|null 基金管理机构。
custodian 基金托管人 string|null 基金资产托管机构。
fund_type 投资类型 string|null 基金主要投资资产类型。
found_date 成立日期 string|null 日期格式:YYYYMMDD。
due_date 到期日期 string|null 日期格式:YYYYMMDD;无固定到期日时返回 null。
list_date 上市日期 string|null 日期格式:YYYYMMDD。
issue_date 发行日期 string|null 日期格式:YYYYMMDD。
delist_date 退市日期 string|null 日期格式:YYYYMMDD;未退市时返回 null。
issue_amount 发行份额(亿份) number|null 基金首次发行份额。
m_fee 管理费率(%) number|null 基金合同约定的年管理费率。
c_fee 托管费率(%) number|null 基金合同约定的年托管费率。
duration_year 存续期限(年) number|null 基金约定的存续期限;不定期基金可能返回 null。
p_value 基金面值(元) number|null 基金份额初始面值。
min_amount 募集最低金额(万元) number|null 基金募集或申购的起点金额。
exp_return 预期收益率(%) number|null 数据源提供的预期收益率;无该项时返回 null。
benchmark 业绩比较基准 string|null 基金合同约定的业绩比较基准。
status 存续状态 string|null 基金当前上市或存续状态。
invest_type 投资风格 string|null 基金的投资运作风格。
type 基金类型 string|null 数据源中的基金组织或运作类型。
trustee 受托人 string|null 数据源记录的受托机构;无该项时返回 null。
purc_startdate 申购起始日期 string|null 日期格式:YYYYMMDD。
redm_startdate 赎回起始日期 string|null 日期格式:YYYYMMDD。
market 场内外标识 string|null E=场内基金,O=场外基金。

请求

{"content":{"application/json":{"example":{"apikey":"","apiname":"etf_basic","fields":"symbol,name,fund_type,management,custodian,list_date,delist_date,status,market","params":{"include_delisted":false,"symbols":"510300"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"etf_basic","description":"接口名称","enum":["etf_basic"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"symbol,name,fund_type,management,custodian,list_date,delist_date,status,market","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `code` | `string` | 完整 ETF 代码 | `510300.SH` | 包含交易所后缀的 ETF 代码。 |\n| `symbol` | `string` | ETF 代码 | `510300` | 6 位 ETF 代码。 |\n| `name` | `string\\|null` | ETF 简称 | `沪深300ETF` | ETF 证券简称。 |\n| `management` | `string\\|null` | 基金管理人 | `华泰柏瑞基金` | 基金管理机构。 |\n| `custodian` | `string\\|null` | 基金托管人 | `中国工商银行` | 基金资产托管机构。 |\n| `fund_type` | `string\\|null` | 投资类型 | `股票型` | 基金主要投资资产类型。 |\n| `found_date` | `string\\|null` | 成立日期 | `20120504` | 日期格式:YYYYMMDD。 |\n| `due_date` | `string\\|null` | 到期日期 | `null` | 日期格式:YYYYMMDD;无固定到期日时返回 null。 |\n| `list_date` | `string\\|null` | 上市日期 | `20120528` | 日期格式:YYYYMMDD。 |\n| `issue_date` | `string\\|null` | 发行日期 | `20120423` | 日期格式:YYYYMMDD。 |\n| `delist_date` | `string\\|null` | 退市日期 | `null` | 日期格式:YYYYMMDD;未退市时返回 null。 |\n| `issue_amount` | `number\\|null` | 发行份额(亿份) | `54.35` | 基金首次发行份额。 |\n| `m_fee` | `number\\|null` | 管理费率(%) | `0.5` | 基金合同约定的年管理费率。 |\n| `c_fee` | `number\\|null` | 托管费率(%) | `0.1` | 基金合同约定的年托管费率。 |\n| `duration_year` | `number\\|null` | 存续期限(年) | `null` | 基金约定的存续期限;不定期基金可能返回 null。 |\n| `p_value` | `number\\|null` | 基金面值(元) | `1` | 基金份额初始面值。 |\n| `min_amount` | `number\\|null` | 募集最低金额(万元) | `0.1` | 基金募集或申购的起点金额。 |\n| `exp_return` | `number\\|null` | 预期收益率(%) | `null` | 数据源提供的预期收益率;无该项时返回 null。 |\n| `benchmark` | `string\\|null` | 业绩比较基准 | `沪深300指数` | 基金合同约定的业绩比较基准。 |\n| `status` | `string\\|null` | 存续状态 | `L` | 基金当前上市或存续状态。 |\n| `invest_type` | `string\\|null` | 投资风格 | `被动指数型` | 基金的投资运作风格。 |\n| `type` | `string\\|null` | 基金类型 | `契约型开放式` | 数据源中的基金组织或运作类型。 |\n| `trustee` | `string\\|null` | 受托人 | `null` | 数据源记录的受托机构;无该项时返回 null。 |\n| `purc_startdate` | `string\\|null` | 申购起始日期 | `20120528` | 日期格式:YYYYMMDD。 |\n| `redm_startdate` | `string\\|null` | 赎回起始日期 | `20120528` | 日期格式:YYYYMMDD。 |\n| `market` | `string\\|null` | 场内外标识 | `E` | E=场内基金,O=场外基金。 |"},"params":{"default":{"include_delisted":false,"symbols":"510300"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string\\|array` | 可选 | `510300` | ETF 代码,支持单个代码、多个英文逗号分隔代码或数组;不传则默认全部未退市 ETF。 |\n| `keyword` | `string` | 可选 | `上证50` | 关键词,按 ETF 代码、名称、管理人、托管人或投资类型检索。 |\n| `market` | `string` | 可选 | `E` | 市场代码,默认基础数据使用场内基金市场。 |\n| `list_date` | `string` | 可选 | `20050223` | 上市日期,格式:YYYYMMDD。 |\n| `include_delisted` | `boolean` | 可选 | `false` | 是否包含已退市 ETF。默认 false。 |","properties":{"include_delisted":{"default":false,"description":"是否包含已退市 ETF。默认 false。","example":false,"type":"boolean"},"keyword":{"description":"关键词,按 ETF 代码、名称、管理人、托管人或投资类型检索。","example":"上证50","type":"string"},"list_date":{"description":"上市日期,格式:YYYYMMDD。","example":"20050223","pattern":"^\\d{8}$","type":"string"},"market":{"description":"市场代码,默认基础数据使用场内基金市场。","example":"E","type":"string"},"symbols":{"description":"ETF 代码,支持单个代码、多个英文逗号分隔代码或数组;不传则默认全部未退市 ETF。","example":"510300","oneOf":[{"description":"单个代码或多个英文逗号分隔代码","type":"string"},{"description":"ETF 代码数组","items":{"type":"string"},"type":"array"}]}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `etf_basic` | 接口名称 |\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":["symbol","name","fund_type","management","custodian","list_date","delist_date","status","market"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条记录,列顺序与 fields 一一对应","example":[["510300","沪深300ETF","股票型","华泰柏瑞基金","中国工商银行","20120528",null,"L","E"]],"items":{"items":{},"type":"array"},"type":"array"}},"required":["fields","items"],"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"}}}}}