反查个股所属 ETF

公开接口

ETF 基金 · 反查个股所属 ETF

输入个股代码,反查当前交易日持有该个股的所有 ETF(申赎清单口径)。返回每只命中 ETF 的基本信息,以及该 ETF 篮子里的持仓数量(每个申赎单位的口径)。该接口为付费增值功能,免费版调用返回 403。

接口地址

GET /cn/etfs/by_stock
完整地址:https://api.databull.cn/cn/etfs/by_stock

接口说明

输入个股代码,反查**当前交易日**持有该个股的所有 ETF(申赎清单口径)。

返回每只命中 ETF 的基本信息(symbol / name / etf_exch_id),以及该 ETF 篮子里的持仓数量(component_volume,每个申赎单位的口径)与持仓交易日。

该接口为付费增值功能,**免费版调用返回 403**;越权请求不消耗当日额度。

请求参数

参数位置类型必填默认说明
symbol查询string是—个股代码(裸码,不带交易所后缀),如 600519

返回字段

字段类型说明
codenumber业务状态码,0 表示成功
data.symbolstring查询所用的个股代码(裸码)
data.namestring个股名称(取自命中 ETF 的篮子记录)
data.countnumber命中 ETF 数量
data.etfsarray命中 ETF 列表,按 ETF 代码升序
data.etfs[].symbolstringETF 代码
data.etfs[].namestringETF 名称
data.etfs[].etf_exch_idstringETF 交易所标识,如 SH / SZ
data.etfs[].component_codestring成分券代码(带交易所后缀)
data.etfs[].component_namestring成分券名称
data.etfs[].component_volumenumber该 ETF 篮子里的持仓数量
data.etfs[].trading_daystring持仓所属交易日(= 该 ETF 最新交易日)

接口示例

cURL
curl "https://api.databull.cn/cn/etfs/by_stock?symbol=600519" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_etf_holding_etfs(symbol="600519")
print(result)

响应示例

JSON
{
  "code": 0,
  "data": {
    "symbol": "600519",
    "name": "贵州茅台",
    "count": 2,
    "etfs": [
      {
        "symbol": "510300",
        "name": "沪深300ETF",
        "etf_exch_id": "SH",
        "component_code": "600519.SH",
        "component_name": "贵州茅台",
        "component_volume": 300,
        "trading_day": "2026-06-26"
      },
      {
        "symbol": "510050",
        "name": "上证50ETF",
        "etf_exch_id": "SH",
        "component_code": "600519.SH",
        "component_name": "贵州茅台",
        "component_volume": 150,
        "trading_day": "2026-06-26"
      }
    ]
  }
}

错误码

状态码触发条件
400个股代码格式非法
403当前套餐不含个股ETF持仓查询功能(免费版),需升级付费套餐
403特色功能需付费套餐,升级套餐后可用

说明

  • 该接口为付费增值功能:免费版调用返回 403,越权请求不消耗当日额度。
  • 个股代码支持裸码(如 600519)或带后缀(如 600519.SH);裸码按 A 股规则自动匹配交易所。
  • 只统计「最新交易日」口径,与 ETF 主表的 trading_day 对齐——不会命中历史篮子快照。
  • 空结果(该个股当前未被任何 ETF 持有)返回 200,并在信封层带 empty_reason=no_etf_holding。
  • 该接口属于特色功能「个股ETF持仓查询」,需付费套餐(专业版及以上)方可调用;免费版不含该功能。