REST 接口 · 文档目录

合作方数据 ETF 成份股 · REST 接口

ETF 成份股。获取美国上市 ETF 的底层持仓与成份股,了解 ETF 究竟持有哪些证券,从而掌握基金构成与投资敞口。

GET /etf-global/v1/constituents
上游时效说明

每日更新

上游历史范围

数据可追溯至 2017 年 4 月 3 日

适用场景

  • ETF 组合透明度、持仓复制、敞口与风险分析、基金对比与基准比较。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
composite_tickerstringNo持有这些成分证券的 ETF 的股票代码。
composite_ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
composite_ticker.gtstringNo筛选大于该值。
composite_ticker.gtestringNo筛选大于或等于该值。
composite_ticker.ltstringNo筛选小于该值。
composite_ticker.ltestringNo筛选小于或等于该值。
constituent_tickerstringNo该 ETF 所持单只证券的股票代码。
constituent_ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
constituent_ticker.gtstringNo筛选大于该值。
constituent_ticker.gtestringNo筛选大于或等于该值。
constituent_ticker.ltstringNo筛选小于该值。
constituent_ticker.ltestringNo筛选小于或等于该值。
effective_datestringNo该信息准确或生效的日期。部分发行方(如 Vanguard)的数据发布存在延迟,因此生效日期可能比处理日期早数周。值格式须为 yyyy-mm-dd。
effective_date.gtstringNo筛选大于该值。值格式须为 yyyy-mm-dd。
effective_date.gtestringNo筛选大于或等于该值。值格式须为 yyyy-mm-dd。
effective_date.ltstringNo筛选小于该值。值格式须为 yyyy-mm-dd。
effective_date.ltestringNo筛选小于或等于该值。值格式须为 yyyy-mm-dd。
processed_datestringNoETF Global 接收并处理该数据的日期,格式须为 yyyy-mm-dd。
processed_date.gtstringNo筛选大于该值。值格式须为 yyyy-mm-dd。
processed_date.gtestringNo筛选大于或等于该值。值格式须为 yyyy-mm-dd。
processed_date.ltstringNo筛选小于该值。值格式须为 yyyy-mm-dd。
processed_date.ltestringNo筛选小于或等于该值。值格式须为 yyyy-mm-dd。
us_codestringNo成分证券在美国市场的唯一标识代码。
us_code.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
us_code.gtstringNo筛选大于该值。
us_code.gtestringNo筛选大于或等于该值。
us_code.ltstringNo筛选小于该值。
us_code.ltestringNo筛选小于或等于该值。
isinstringNo国际证券识别码(ISIN),用于标识证券的全球标准。
isin.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
isin.gtstringNo筛选大于该值。
isin.gtestringNo筛选大于或等于该值。
isin.ltstringNo筛选小于该值。
isin.ltestringNo筛选小于或等于该值。
figistringNo金融工具全球识别码(FIGI),用于唯一标识金融工具的开放标准。
figi.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
figi.gtstringNo筛选大于该值。
figi.gtestringNo筛选大于或等于该值。
figi.ltstringNo筛选小于该值。
figi.ltestringNo筛选小于或等于该值。
sedolstringNo证券交易所每日官方牌价(SEDOL)代码,主要用于英国的证券交易。
sedol.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
sedol.gtstringNo筛选大于该值。
sedol.gtestringNo筛选大于或等于该值。
sedol.ltstringNo筛选小于该值。
sedol.ltestringNo筛选小于或等于该值。
limitintegerNo限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 5000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 composite_ticker,排序方向默认为 asc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].asset_classstring资产类型的大类,例如股票、公司债、市政债等。
results[].composite_tickerstring持有这些成分证券的 ETF 的股票代码。
results[].constituent_namestring该成分持仓的公司或证券全称。
results[].constituent_rankinteger该成分在 ETF 内于指定 effective_date 的排名,依次按权重(降序)、market_value(降序)与 constituent_ticker(升序)排序。排名为 1 表示第一大持仓。
results[].constituent_tickerstring该 ETF 所持单只证券的股票代码。
results[].country_of_exchangestring该成分证券上市交易所所在的国家。
results[].currency_tradedstring该成分证券计价与交易的本地货币。
results[].effective_datestring该信息准确或生效的日期。部分发行方(如 Vanguard)的数据发布存在延迟,因此生效日期可能比处理日期早数周。
results[].exchangestring该成分证券主要交易的交易所名称。
results[].figistring金融工具全球识别码(FIGI),用于唯一标识金融工具的开放标准。
results[].isinstring国际证券识别码(ISIN),用于标识证券的全球标准。
results[].market_valuenumber该 ETF 持有的该成分仓位的总市值。
results[].processed_datestringETF Global 接收并处理该数据的日期。
results[].security_typestring按 ETF Global 分类体系给出的证券类型具体分类,例如普通股、境内、全球等。
results[].sedolstring证券交易所每日官方牌价(SEDOL)代码,主要用于英国的证券交易。
results[].shares_heldnumber该 ETF 当前持有的该成分证券股数。
results[].us_codestring成分证券在美国市场的唯一标识代码。
results[].weightnumber该成分在 ETF 组合中的权重,以小数表示(0.0789 = 7.89%)。空头仓位为负值。多数基金的权重合计约为 1;杠杆与反向基金有所不同。少数成分没有权重,因此合计可能略小于 1。
statusenum: OK本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "asset_class": "Equity",
      "composite_ticker": "SPY",
      "constituent_name": "CAESARS ENTERTAINMENT INC COMMON STOCK",
      "constituent_rank": 42,
      "constituent_ticker": "CZR",
      "country_of_exchange": "US",
      "currency_traded": "USD",
      "effective_date": "2025-09-18",
      "figi": "BBG0074Q3NK6",
      "isin": "US12769G1004",
      "market_value": 63308625.6,
      "processed_date": "2025-09-19",
      "security_type": "Common Stock",
      "sedol": "BMWWGB0",
      "shares_held": 2398054,
      "us_code": "12769G100",
      "weight": 0.0000958005
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗