Industry Performance Summary细分行业表现汇总
该接口按特定时期汇总各行业的整体表现,帮助识别强势与弱势板块、比较行业间的财务健康度,为板块配置提供宏观参考,可直接用于机构重仓股穿透、聪明钱调仓方向追踪与机构抱团集中度分析。
https://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 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
year | string | 必填 | 2023 | 目标财报/数据的年份,如 2023。 |
quarter | string | 必填 | 3 | 目标季度,1、2、3、4 分别对应 Q1~Q4。 |
调用代码示例
Python 关键代码执行 /stable/institutional-ownership/industry-summary 查询细分行业表现汇总(必填 year, quarter),直接产出 industryTitle(行业分类名称)、industryValue(行业数值)、date(日期) 等 3 项字段。
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,必填 year, quarter)输出 industryTitle(行业分类名称)及 industryValue(行业数值);在做多标的横截面合并时,请确保各标的在同一时间截面上对齐。
在为细分行业表现汇总(/stable/institutional-ownership/industry-summary)设计表结构时,以 (industryTitle, date) 唯一锁定记录,并对 industryValue(行业数值) 保留完整浮点精度。
返回数据
3 个字段本接口示例响应共包含 3 个字段(数值型 1 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
industryTitle | string | "ABRASIVE, ASBESTOS & MISC NONM…" | 行业分类名称 |
industryValue | number | 11088059691 | 行业数值 |
date | string | "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 申报机构的持仓全景 |