Industry Performance Summary细分行业表现汇总

该接口按特定时期汇总各行业的整体表现,帮助识别强势与弱势板块、比较行业间的财务健康度,为板块配置提供宏观参考,可直接用于机构重仓股穿透、聪明钱调仓方向追踪与机构抱团集中度分析。

GEThttps://quote-fmp.com/stable/institutional-ownership/industry-summary?year=2023&quarter=3

数据更新周期

5 Minutes

接口说明

  • 板块分析:洞察各行业的表现,识别强势板块和落后板块,传入 year 后可交付 industryTitle(行业分类名称)、industryValue(行业数值) 等结构化信息,降低多资产投研系统的数据接入复杂度。
  • 行业健康度比较:比较不同行业的财务健康程度,评估哪些板块可能有更好的投资机会,通过提取 industryTitle(行业分类名称)与 industryValue(行业数值) 等字段,可在 Pandas 中快速构建多因子暴露矩阵。
  • 宏观市场洞察:利用行业级表现数据,对大市趋势与经济变化做出有依据的判断,在多因子回测管道里,常联合「机构持仓汇总」一起采集以丰富特征维度。
  • 关联数据线接口:Filings Extract With Analytics By Holder(持股机构申报分析) · Holder Performance Summary(机构持股人业绩汇总) · Company Profile Data(公司概况) · SEC Filings By CIK(按 CIK 查 SEC 申报)

请求参数

2 个参数
参数类型要求示例说明
yearstring必填2023目标财报/数据的年份,如 2023。
quarterstring必填3目标季度,1、2、3、4 分别对应 Q1~Q4。

调用代码示例

Python 关键代码

执行 /stable/institutional-ownership/industry-summary 查询细分行业表现汇总(必填 year, quarter),直接产出 industryTitle(行业分类名称)、industryValue(行业数值)、date(日期) 等 3 项字段。

Python(核心参数与字段清洗逻辑)
resp = requests.get(
    "https://quote-fmp.com/stable/institutional-ownership/industry-summary",
    params={"year": "2023", "quarter": "3", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 industryValue(行业数值)
df["industryValue"] = pd.to_numeric(df["industryValue"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

参数使用和避坑

2 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:

投研场景Query 参数组合示例返回数据特征与用途
拉取 2024 财年细分行业表现汇总统计截面year=2024&quarter=Q4指定 year=2024 调用 /stable/institutional-ownership/industry-summary,获取该年度的 industryTitle、industryValue、date(样本 industryTitle=ABRASIVE, ASBESTOS & MIS…)。
回溯 2023 财年细分行业表现汇总历史变动year=2023&quarter=Q1将 year 切换为 2023 请求 /stable/institutional-ownership/industry-summary,纵向比对 industryTitle、industryValue、date 的跨年变化。
时序与查询边界/stable/institutional-ownership/industry-summary 横截面合并:industryTitle 与 industryValue 截面同频

细分行业表现汇总(路径 /stable/institutional-ownership/industry-summary,必填 year, quarter)输出 industryTitle(行业分类名称)及 industryValue(行业数值);在做多标的横截面合并时,请确保各标的在同一时间截面上对齐。

落库主键与口径细分行业表现汇总入库指南:(industryTitle, date) 唯一约束与 industryValue 数值口径

在为细分行业表现汇总(/stable/institutional-ownership/industry-summary)设计表结构时,以 (industryTitle, date) 唯一锁定记录,并对 industryValue(行业数值) 保留完整浮点精度。

返回数据

3 个字段

本接口示例响应共包含 3 个字段(数值型 1 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。

字段类型示例值说明
industryTitlestring"ABRASIVE, ASBESTOS & MISC NONM…"行业分类名称
industryValuenumber11088059691行业数值
datestring"2023-09-30"日期
查看响应数据示例(原始 JSON)
[
{
"industryTitle": "ABRASIVE, ASBESTOS & MISC NONMETALLIC MINERAL PRODS",
"industryValue": 11088059691,
"date": "2023-09-30"
}
]

常见问题解答(FAQ)

2 个问题
在「Symbol」分类下,细分行业表现汇总(3 个字段)与 机构持仓汇总 的核心差异点是什么?

细分行业表现汇总 与 Positions Summary(机构持仓汇总) 分别映射 /stable/institutional-ownership/industry-summary(必填 year, quarter,含 industryTitle 等 3 列)与 /stable/institutional-ownership/symbol-positions-summary(必填 symbol, year, quarter,含 36 列),可按研究粒度灵活选用。

实盘任务调用 /stable/institutional-ownership/industry-summary 拉取细分行业表现汇总时,如何规范化控制查询边界与重试节奏?

您只需按 year 过滤条件请求 /stable/institutional-ownership/industry-summary 并做非空校验;配合空数组 [] 短路判断,即可构建零人工干预的 细分行业表现汇总(industryTitle)自动化同步任务。

同模块相关接口对比

Symbol

本接口路径 /stable/institutional-ownership/industry-summary,必填参数 year、quarter。 同一模块「Symbol」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。

接口路径核心差异与适用场景
机构持仓汇总Positions Summary/stable/institutional-ownership/symbol-positions-summary按股票代码与季度汇总全部 13F 申报机构的持仓全景

Form13F(机构持仓 13F)全部接口目录 →

需要稳定访问 细分行业表现汇总 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月