REST 接口 · 文档目录

合作方数据 ETF 分类体系 · REST 接口

ETF 分类体系。获取用于归类与组织美国上市 ETF 的标准化分类体系,包括定义投资策略、资产类型与基金特征的结构化分类框架。

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

每日更新

上游历史范围

数据可追溯至 2021 年 11 月 1 日

适用场景

  • ETF 归类与分类、策略识别、按分类体系筛选、基金池组织。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
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。
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。
composite_tickerstringNo用于在交易所识别该 ETF 产品的股票代码。
composite_ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
composite_ticker.gtstringNo筛选大于该值。
composite_ticker.gtestringNo筛选大于或等于该值。
composite_ticker.ltstringNo筛选小于该值。
composite_ticker.ltestringNo筛选小于或等于该值。
limitintegerNo限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 5000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 composite_ticker,排序方向默认为 asc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].asset_classstring该 ETF 持有的主要资产类型,如股票、债券、大宗商品或其他证券。
results[].categorystring描述该 ETF 投资方向与策略的宽泛投资类别。
results[].composite_tickerstring用于在交易所识别该 ETF 产品的股票代码。
results[].countrystring该 ETF 的重点投资国家(如适用)。
results[].credit_quality_ratingstring固定收益类 ETF 的信用质量评级。
results[].descriptionstring该 ETF 产品的官方名称与说明。
results[].development_classstring该 ETF 所投资市场的经济发展分类,如发达市场、新兴市场或前沿市场。
results[].durationstring固定收益类 ETF 的久期特征。
results[].effective_datestring该信息准确或生效的日期。部分发行方(如 Vanguard)的数据发布存在延迟,因此生效日期可能比处理日期早数周。
results[].esgstring环境、社会与治理(ESG)特征。
results[].exposure_mechanismstring实现敞口所采用的方式。
results[].factorstring该 ETF 的因子敞口特征。
results[].focusstring该 ETF 提供的具体投资方向或敞口,如板块、地域或投资风格。
results[].hedge_resetstring对冲重置频率(如适用)。
results[].holdings_disclosure_frequencystring持仓的披露频率。
results[].inception_datestring该 ETF 首次发行并开始交易的日期。
results[].isinstring国际证券识别码(ISIN),用于在全球范围内唯一标识该 ETF。
results[].issuerstring创建并发行该 ETF 的金融机构或基金公司。
results[].leverage_resetstring杠杆重置频率(如适用)。
results[].leverage_stylestring表示该 ETF 是否使用杠杆放大收益(leveraged),或不使用杠杆(unleveraged)。
results[].levered_amountnumber该 ETF 采用的杠杆倍数,正数表示杠杆敞口,负数表示反向敞口。
results[].management_classificationstring界定该 ETF 按 SEC 规则属于主动型(由管理人做投资决策)还是被动型(跟踪指数)。
results[].management_stylestring表示该 ETF 为主动管理还是被动管理,以及所采用的信息透明度或复制方式。
results[].maturitystring固定收益类 ETF 的到期期限结构。
results[].objectivestring该 ETF 的主要投资目标。
results[].primary_benchmarkstring该 ETF 旨在跟踪或复制的标的指数或基准。
results[].processed_datestringETF Global 接收并处理该数据的日期。
results[].product_typestring表示该产品是交易所交易票据(etn)还是 ETF(etf)。
results[].rebalance_frequencystring该 ETF 的持仓再平衡频率。
results[].reconstitution_frequencystring指数成分的调整频率。
results[].regionstring该 ETF 集中投资的地理区域或全球范围。
results[].secondary_objectivestring次要投资目标(如适用)。
results[].selection_methodologystring选券所采用的方法。
results[].selection_universestring选券所依托的证券范围。
results[].strategic_focusstring该 ETF 的战略投资重点。
results[].targeted_focusstring该 ETF 的目标投资重点。
results[].tax_classificationstring该 ETF 的税务结构,决定投资者收到 1099 还是 K1 税表(RIC、Partnership 或 UIT)。
results[].us_codestring在美国市场标识该 ETF 的唯一代码。
results[].weighting_methodologystring持仓加权所采用的方法。
statusenum: OK本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "asset_class": "Equity",
      "category": "Size and Style",
      "composite_ticker": "SPY",
      "country": "U.S.",
      "description": "SPDR S&P 500 ETF Trust",
      "development_class": "Developed Markets",
      "effective_date": "2025-09-19",
      "exposure_mechanism": "Blended Replication",
      "factor": "Size",
      "focus": "Large Cap",
      "holdings_disclosure_frequency": "Daily",
      "inception_date": "1993-01-22",
      "isin": "US78462F1030",
      "issuer": "SSgA",
      "leverage_style": "unleveraged",
      "levered_amount": 0,
      "management_classification": "passive",
      "management_style": "Passive - Representative Sampling",
      "objective": "Index-Tracking",
      "primary_benchmark": "S&P 500 Index",
      "processed_date": "2025-09-19",
      "product_type": "etf",
      "rebalance_frequency": "Quarterly",
      "reconstitution_frequency": "Quarterly",
      "region": "North America",
      "selection_methodology": "Modified Market Cap, Fundamental Multifactor, Liquidity",
      "selection_universe": "U.S. Large Caps",
      "strategic_focus": "Factor",
      "targeted_focus": "Size",
      "tax_classification": "Regulated Investment Company",
      "us_code": "78462F103",
      "weighting_methodology": "Modified Market Capitalization-Weighted"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗