合作方数据 ETF 成份股 · REST 接口
ETF 成份股。获取美国上市 ETF 的底层持仓与成份股,了解 ETF 究竟持有哪些证券,从而掌握基金构成与投资敞口。
GET /etf-global/v1/constituents上游时效说明
每日更新
上游历史范围
数据可追溯至 2017 年 4 月 3 日
适用场景
- ETF 组合透明度、持仓复制、敞口与风险分析、基金对比与基准比较。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
composite_ticker | string | No | 持有这些成分证券的 ETF 的股票代码。 |
composite_ticker.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
composite_ticker.gt | string | No | 筛选大于该值。 |
composite_ticker.gte | string | No | 筛选大于或等于该值。 |
composite_ticker.lt | string | No | 筛选小于该值。 |
composite_ticker.lte | string | No | 筛选小于或等于该值。 |
constituent_ticker | string | No | 该 ETF 所持单只证券的股票代码。 |
constituent_ticker.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
constituent_ticker.gt | string | No | 筛选大于该值。 |
constituent_ticker.gte | string | No | 筛选大于或等于该值。 |
constituent_ticker.lt | string | No | 筛选小于该值。 |
constituent_ticker.lte | string | No | 筛选小于或等于该值。 |
effective_date | string | No | 该信息准确或生效的日期。部分发行方(如 Vanguard)的数据发布存在延迟,因此生效日期可能比处理日期早数周。值格式须为 yyyy-mm-dd。 |
effective_date.gt | string | No | 筛选大于该值。值格式须为 yyyy-mm-dd。 |
effective_date.gte | string | No | 筛选大于或等于该值。值格式须为 yyyy-mm-dd。 |
effective_date.lt | string | No | 筛选小于该值。值格式须为 yyyy-mm-dd。 |
effective_date.lte | string | No | 筛选小于或等于该值。值格式须为 yyyy-mm-dd。 |
processed_date | string | No | ETF Global 接收并处理该数据的日期,格式须为 yyyy-mm-dd。 |
processed_date.gt | string | No | 筛选大于该值。值格式须为 yyyy-mm-dd。 |
processed_date.gte | string | No | 筛选大于或等于该值。值格式须为 yyyy-mm-dd。 |
processed_date.lt | string | No | 筛选小于该值。值格式须为 yyyy-mm-dd。 |
processed_date.lte | string | No | 筛选小于或等于该值。值格式须为 yyyy-mm-dd。 |
us_code | string | No | 成分证券在美国市场的唯一标识代码。 |
us_code.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
us_code.gt | string | No | 筛选大于该值。 |
us_code.gte | string | No | 筛选大于或等于该值。 |
us_code.lt | string | No | 筛选小于该值。 |
us_code.lte | string | No | 筛选小于或等于该值。 |
isin | string | No | 国际证券识别码(ISIN),用于标识证券的全球标准。 |
isin.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
isin.gt | string | No | 筛选大于该值。 |
isin.gte | string | No | 筛选大于或等于该值。 |
isin.lt | string | No | 筛选小于该值。 |
isin.lte | string | No | 筛选小于或等于该值。 |
figi | string | No | 金融工具全球识别码(FIGI),用于唯一标识金融工具的开放标准。 |
figi.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
figi.gt | string | No | 筛选大于该值。 |
figi.gte | string | No | 筛选大于或等于该值。 |
figi.lt | string | No | 筛选小于该值。 |
figi.lte | string | No | 筛选小于或等于该值。 |
sedol | string | No | 证券交易所每日官方牌价(SEDOL)代码,主要用于英国的证券交易。 |
sedol.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
sedol.gt | string | No | 筛选大于该值。 |
sedol.gte | string | No | 筛选大于或等于该值。 |
sedol.lt | string | No | 筛选小于该值。 |
sedol.lte | string | No | 筛选小于或等于该值。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 5000。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 composite_ticker,排序方向默认为 asc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].asset_class | string | 资产类型的大类,例如股票、公司债、市政债等。 |
results[].composite_ticker | string | 持有这些成分证券的 ETF 的股票代码。 |
results[].constituent_name | string | 该成分持仓的公司或证券全称。 |
results[].constituent_rank | integer | 该成分在 ETF 内于指定 effective_date 的排名,依次按权重(降序)、market_value(降序)与 constituent_ticker(升序)排序。排名为 1 表示第一大持仓。 |
results[].constituent_ticker | string | 该 ETF 所持单只证券的股票代码。 |
results[].country_of_exchange | string | 该成分证券上市交易所所在的国家。 |
results[].currency_traded | string | 该成分证券计价与交易的本地货币。 |
results[].effective_date | string | 该信息准确或生效的日期。部分发行方(如 Vanguard)的数据发布存在延迟,因此生效日期可能比处理日期早数周。 |
results[].exchange | string | 该成分证券主要交易的交易所名称。 |
results[].figi | string | 金融工具全球识别码(FIGI),用于唯一标识金融工具的开放标准。 |
results[].isin | string | 国际证券识别码(ISIN),用于标识证券的全球标准。 |
results[].market_value | number | 该 ETF 持有的该成分仓位的总市值。 |
results[].processed_date | string | ETF Global 接收并处理该数据的日期。 |
results[].security_type | string | 按 ETF Global 分类体系给出的证券类型具体分类,例如普通股、境内、全球等。 |
results[].sedol | string | 证券交易所每日官方牌价(SEDOL)代码,主要用于英国的证券交易。 |
results[].shares_held | number | 该 ETF 当前持有的该成分证券股数。 |
results[].us_code | string | 成分证券在美国市场的唯一标识代码。 |
results[].weight | number | 该成分在 ETF 组合中的权重,以小数表示(0.0789 = 7.89%)。空头仓位为负值。多数基金的权重合计约为 1;杠杆与反向基金有所不同。少数成分没有权重,因此合计可能略小于 1。 |
status | enum: 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 文档 ↗