合作方数据 ETF 档案与持仓敞口 · REST 接口

ETF 行业分类。获取美国上市 ETF 的行业分类数据，包括板块映射与跨行业框架的标准化归类。

GET /etf-global/v1/profiles

上游时效说明

每日更新

上游历史范围

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

适用场景

ETF 归类与分类、板块与地区敞口分析、基金画像与对比、组合尽职调查。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`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。
`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。
`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	筛选小于或等于该值。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 5000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 composite_ticker，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].administrator`	string	该 ETF 的管理人。
`results[].advisor`	string	该 ETF 的投资顾问。
`results[].asset_class`	string	该 ETF 持有的主要资产类型，如股票、债券、大宗商品或其他证券。
`results[].aum`	number	管理资产总规模，即该 ETF 当前持有的全部资产市值。
`results[].avg_daily_trading_volume`	number	过去一个月的日均成交份数，反映流动性与投资者关注度。
`results[].bid_ask_spread`	number	日内平均买卖价差百分比，计算方式为价差除以当日采样的最低卖价。
`results[].call_volume`	number	看涨期权成交量。
`results[].category`	string	描述该 ETF 投资方向与策略的宽泛投资类别。
`results[].composite_ticker`	string	用于在交易所识别该 ETF 产品的股票代码。
`results[].coupon_exposure`	array[object]	固定收益类 ETF 的票息敞口分布。
`results[].creation_fee`	number	创设该 ETF 新份额所收取的费用。
`results[].creation_unit_size`	number	该 ETF 创设单位的规模。
`results[].currency_exposure`	array[object]	该 ETF 的货币敞口分布。
`results[].custodian`	string	该 ETF 资产的托管人。
`results[].description`	string	该 ETF 产品的官方名称与说明。
`results[].development_class`	string	该 ETF 所投资市场的经济发展分类，如发达市场、新兴市场或前沿市场。
`results[].discount_premium`	number	相对资产净值的折价或溢价。
`results[].distribution_frequency`	string	该 ETF 的分配频率。
`results[].distributor`	string	该 ETF 的销售商。
`results[].effective_date`	string	该信息准确或生效的日期。部分发行方（如 Vanguard）的数据发布存在延迟，因此生效日期可能比处理日期早数周。
`results[].fee_waivers`	number	该 ETF 适用的费用减免。
`results[].fiscal_year_end`	string	该 ETF 的财年结束日。
`results[].focus`	string	该 ETF 提供的具体投资方向或敞口，如板块、地域或投资风格。
`results[].futures_commission_merchant`	string	期货佣金商（如适用）。
`results[].geographic_exposure`	array[object]	该 ETF 的地域敞口分布。
`results[].inception_date`	string	该 ETF 首次发行并开始交易的日期。
`results[].industry_exposure`	array[object]	该 ETF 的行业敞口分布。
`results[].industry_group_exposure`	array[object]	该 ETF 的行业组敞口分布。
`results[].issuer`	string	创建并发行该 ETF 的金融机构或基金公司。
`results[].lead_market_maker`	string	该 ETF 的主做市商。
`results[].leverage_style`	string	表示该 ETF 是否使用杠杆放大收益（leveraged），或不使用杠杆（unleveraged）。
`results[].levered_amount`	number	该 ETF 采用的杠杆倍数，正数表示杠杆敞口，负数表示反向敞口。
`results[].listing_exchange`	string	该 ETF 上市的主要交易所。
`results[].management_classification`	string	界定该 ETF 按 SEC 规则属于主动型（由管理人做投资决策）还是被动型（跟踪指数）。
`results[].management_fee`	number	基金管理人为管理该 ETF 组合与运营所收取的年度费用。
`results[].maturity_exposure`	array[object]	固定收益类 ETF 的到期期限敞口分布。
`results[].net_expenses`	number	减免后的净费用。
`results[].num_holdings`	number	该 ETF 的持仓数量。
`results[].options_available`	integer	该 ETF 是否有期权可交易。
`results[].options_volume`	number	该 ETF 的期权成交量。
`results[].other_expenses`	number	该 ETF 收取的其他费用。
`results[].portfolio_manager`	string	该 ETF 的基金经理。
`results[].primary_benchmark`	string	该 ETF 旨在跟踪或复制的标的指数或基准。
`results[].processed_date`	string	ETF Global 接收并处理该数据的日期。
`results[].product_type`	string	表示该产品是交易所交易票据（etn）还是 ETF（etf）。
`results[].put_call_ratio`	number	该 ETF 期权的看跌／看涨比率。
`results[].put_volume`	number	看跌期权成交量。
`results[].region`	string	该 ETF 集中投资的地理区域或全球范围。
`results[].sector_exposure`	array[object]	该 ETF 的板块敞口分布。
`results[].short_interest`	number	该 ETF 的空头持仓。
`results[].subadvisor`	string	该 ETF 的次级顾问（如适用）。
`results[].subindustry_exposure`	array[object]	该 ETF 的细分行业敞口分布。
`results[].tax_classification`	string	该 ETF 的税务结构，决定投资者收到 1099 还是 K1 税表（RIC、Partnership 或 UIT）。
`results[].total_expenses`	number	该 ETF 的年度总费率，包含转嫁给投资者的全部费用与成本。
`results[].transfer_agent`	string	该 ETF 的过户代理。
`results[].trustee`	string	该 ETF 的受托人。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "administrator": "State Street Bank and Trust Company",
      "advisor": "SSgA Funds Management, Inc.",
      "asset_class": "Equity",
      "aum": 624531939442.66,
      "avg_daily_trading_volume": 51287737.3,
      "bid_ask_spread": 0.000042,
      "call_volume": 4797339,
      "category": "Size and Style",
      "composite_ticker": "SPY",
      "creation_fee": 3000,
      "creation_unit_size": 50000,
      "currency_exposure": {
        "usd": 1.003
      },
      "custodian": "State Street Bank and Trust Company",
      "description": "SPDR S&P 500 ETF Trust",
      "development_class": "Developed Markets",
      "discount_premium": 0.136123,
      "distribution_frequency": "Q",
      "distributor": "ALPS Distributors, Inc.",
      "effective_date": "2025-01-02",
      "fee_waivers": 0,
      "fiscal_year_end": "31-Aug",
      "focus": "Large Cap",
      "geographic_exposure": {
        "bm": 0.001,
        "ch": 0.003,
        "ie": 0.021,
        "je": 0.001,
        "lr": 0.001,
        "nl": 0.001,
        "pa": 0.001,
        "us": 0.967
      },
      "inception_date": "1993-01-22",
      "industry_exposure": {
        "aerospace_and_defense": 0.011,
        "air_freight_and_logistics": 0.004,
        "airlines": 0.002,
        "auto_components": 0,
        "automobiles": 0.024,
        "banks": 0.033,
        "beverages": 0.011,
        "biotechnology": 0.047,
        "building_products": 0.002,
        "capital_markets": 0.029,
        "cash_or_derivatives": 0.003,
        "chemicals": 0.007,
        "commercial_services_and_supplies": 0.004,
        "communications_equipment": 0.081,
        "construction_and_engineering": 0.001,
        "construction_materials": 0.001,
        "consumer_products": 0.001,
        "containers_and_packaging": 0.001,
        "distributors": 0.001,
        "diversified_consumer_services": 0.005,
        "diversified_financial_services": 0.029,
        "diversified_telecommunication_services": 0.009,
        "electrical_equipment": 0.009,
        "electronic_equipment_instruments_and_components": 0.001,
        "entertainment": 0.008,
        "equity_real_estate_investment": 0.001,
        "food_products": 0.006,
        "health_care_equipment_and_supplies": 0.031,
        "health_care_providers_and_services": 0.018,
        "health_care_technology": 0.003,
        "hotels,_restaurants_and_leisure": 0.001,
        "hotels_restaurants_and_leisure": 0.014,
        "household_durables": 0.004,
        "household_products": 0.011,
        "industrial_conglomerates": 0.005,
        "insurance": 0.035,
        "it_services": 0.021,
        "leisure_products": 0,
        "machinery": 0.013,
        "media": 0.077,
        "metals_and_mining": 0.003,
        "oil_gas_and_consumable_fuels": 0.031,
        "real_estate_management_and_development": 0.018,
        "renewable_energy": 0.001,
        "road_and_rail": 0.003,
        "semiconductors_and_semiconductor_equipment": 0.115,
        "software": 0.101,
        "specialty_retail": 0.082,
        "technology_hardware_storage_and_peripherals": 0.001,
        "textiles_apparel_and_luxury_goods": 0.003,
        "tobacco": 0.006,
        "trading_companies_and_distributors": 0.002,
        "transportation_infrastructure": 0.006,
        "utilities": 0.022
      },
      "industry_group_exposure": {
        "automobiles_and_components": 0.024,
        "banks": 0.033,
        "capital_goods": 0.045,
        "cash_or_derivatives": 0.003,
        "commercial_and_professional_services": 0.005,
        "consumer_durables_and_apparel": 0.007,
        "consumer_services": 0.02,
        "diversified_financials": 0.058,
        "energy": 0.032,
        "food_and_staples_retailing": 0.018,
        "food_beverage_and_tobacco": 0.023,
        "health_care_equipment_and_services": 0.046,
        "household_and_personal_products": 0.011,
        "insurance": 0.035,
        "materials": 0.013,
        "media_and_entertainment": 0.084,
        "pharmaceuticals_biotechnology_and_life_sciences": 0.053,
        "real_estate": 0.02,
        "retailing": 0.065,
        "semiconductors_and_semiconductor_equipment": 0.115,
        "software_and_services": 0.12,
        "technology_hardware_and_equipment": 0.084,
        "telecommunication_services": 0.009,
        "transportation": 0.002,
        "transportation_and_logistics": 0.012,
        "utilities": 0.022
      },
      "issuer": "SSgA",
      "lead_market_maker": "None",
      "leverage_style": "unleveraged",
      "levered_amount": 0,
      "listing_exchange": "NYSE Arca, Inc.",
      "management_classification": "passive",
      "management_fee": 0.0945,
      "net_expenses": 0.0945,
      "num_holdings": 504,
      "options_available": 1,
      "options_volume": 9346839,
      "other_expenses": 0,
      "primary_benchmark": "S&P 500 Index",
      "processed_date": "2025-01-02",
      "product_type": "etf",
      "put_call_ratio": 0.948338,
      "put_volume": 4549500,
      "region": "North America",
      "sector_exposure": {
        "cash_or_derivatives": 0.003,
        "communications": 0.094,
        "consumer_discretionary": 0.113,
        "consumer_staples": 0.054,
        "energy": 0.032,
        "financials": 0.131,
        "health_care": 0.099,
        "industrials": 0.068,
        "materials": 0.013,
        "real_estate": 0.02,
        "technology": 0.321,
        "utilities": 0.022
      },
      "short_interest": 106750000,
      "subindustry_exposure": {
        "advertising": 0.001,
        "aerospace_and_defense": 0.011,
        "agricultural_and_farm_machinery": 0.002,
        "agricultural_products": 0.001,
        "air_freight_and_logistics": 0.004,
        "airlines": 0.002,
        "alternative_carriers": 0.009,
        "apparel_accessories_and_luxury": 0.003,
        "apparel_retail": 0.005,
        "application_software": 0.024,
        "asset_management_and_custody_banks": 0.006,
        "auto_parts_and_equipment": 0,
        "automobile_manufacturers": 0.024,
        "automotive_retail": 0.004,
        "biotechnology": 0.047,
        "brewers": 0,
        "building_products": 0.002,
        "cable_and_satellite": 0.004,
        "cash_or_derivatives": 0.003,
        "casinos_and_gaming": 0.001,
        "commodity_chemicals": 0.001,
        "communications_equipment": 0.081,
        "construction_and_engineering": 0.001,
        "construction_machinery_and_heavy_trucks": 0.006,
        "construction_materials": 0.001,
        "consumer_electronics": 0.001,
        "consumer_finance": 0.029,
        "data_processing_and_outsourced_services": 0.006,
        "distillers_and_vintners": 0.001,
        "distributors": 0,
        "diversified_banks": 0.033,
        "diversified_chemicals": 0.002,
        "diversified_metals_and_mining": 0.001,
        "diversified_support_services": 0.001,
        "drug_retail": 0,
        "electric_utilities": 0.013,
        "electrical_components_and_equipment": 0.009,
        "electronic_components": 0.001,
        "electronic_equipment_and_instruments": 0,
        "electronic_manufacturing_services": 0,
        "environmental_and_facilities_services": 0.003,
        "fertilizers_and_agricultural_che": 0.001,
        "financial_exchanges_and_data": 0.006,
        "food_retail": 0.002,
        "gas_utilities": 0,
        "general_merchandise_stores": 0.002,
        "health_care_distributors": 0.003,
        "health_care_equipment": 0.014,
        "health_care_facilities": 0.001,
        "health_care_services": 0.004,
        "health_care_supplies": 0.003,
        "heavy_electrical_equipment": 0.001,
        "highways_and_railtracks": 0.005,
        "home_improvement_retail": 0.012,
        "homebuilding": 0.002,
        "hotels_resorts_and_cruise_lines": 0.004,
        "household_products": 0.011,
        "hypermarkets_and_super_centers": 0.016,
        "independent_power_producers_and_energy_traders": 0.001,
        "industrial_conglomerates": 0.005,
        "industrial_machinery": 0.005,
        "insurance_brokers": 0.005,
        "integrated_oil_and_gas": 0.014,
        "interactive_media_and_services": 0.067,
        "internet_and_direct_marketing_retail": 0.043,
        "internet_services_and_infrastruc": 0.004,
        "investment_banking_and_brokerage": 0.01,
        "it_consulting_and_other_services": 0.011,
        "leisure_facilities": 0,
        "leisure_products": 0.001,
        "life_and_health_insurance": 0.003,
        "life_sciences_tools_and_services": 0.014,
        "managed_health_care": 0.013,
        "metal_and_glass_containers": 0.001,
        "movies_and_entertainment": 0.012,
        "multiutilities": 0.006,
        "oil_and_gas_equipment_and_services": 0.002,
        "oil_and_gas_exploration_and_production": 0.007,
        "oil_and_gas_refining_and_marketing": 0.003,
        "oil_and_gas_storage_and_transporta": 0.004,
        "packaged_foods_and_meats": 0.006,
        "paper_packaging": 0.001,
        "precious_metals_and_minerals": 0.001,
        "property_and_casualty_insurance": 0.027,
        "publishing_and_broadcasting": 0,
        "railroads": 0.001,
        "real_estate_services": 0.001,
        "reinsurance": 0,
        "reit": 0.019,
        "renewable_energy_equipment": 0.001,
        "research_and_consulting_services": 0.002,
        "restaurants": 0.009,
        "security_and_alarm_services": 0.004,
        "semiconductors": 0.115,
        "soft_drinks": 0.01,
        "specialty_chemicals": 0.004,
        "specialty_stores": 0.001,
        "steel": 0.001,
        "systems_software": 0.078,
        "technology_hardware_storage_and_peripherals": 0.002,
        "tobacco": 0.006,
        "trading_companies_and_distributors": 0.002,
        "trucking": 0.004,
        "water_utilities": 0
      },
      "tax_classification": "Regulated Investment Company",
      "total_expenses": 0.0945,
      "transfer_agent": "State Street Bank and Trust Company",
      "trustee": "State Street Global Advisors Trust Company"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗