Historical Market Sector Performance板块历史表现
该接口提供能源、科技、医疗健康等市场板块的历史涨跌数据,覆盖主要交易所,用于追踪板块长期走势、支撑板块轮动策略与长期规划。
https://quote-fmp.com/stable/historical-sector-performance?sector=Energy数据更新周期
1 Hour
接口说明
- 板块历史表现:获取各板块一段时间内平均涨跌幅的历史数据,传入
sector后可调取sector(板块)、exchange(交易所代码)与averageChange(平均涨跌幅) 等核心数值,方便与本地历史研究库按主键对齐。 - 分交易所数据:追踪板块在 NASDAQ、NYSE 等不同交易所上的表现,依据
sector(板块)与exchange(交易所代码) 等字段的变化斜率,可及时捕捉基本面或交易面边际变化。 - 长期市场趋势:分析较长时间跨度的趋势与板块表现数据,工程落库阶段可与「板块表现快照」共用主键索引,形成完整的专题数据集。
- 跨模块关联接口:Historical Sector PE(板块历史市盈率) · Historical Industry PE(细分行业历史市盈率) · Exchange Stock Quotes(交易所全量报价) · Available Sectors(可用板块清单)
请求参数
4 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | string | 可选 | 2024-02-01 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
exchange | string | 可选 | NASDAQ | 目标交易所代码或名称,如 NASDAQ、NYSE、AMEX。 |
sector | string | 必填 | Energy | 板块(sector),如 Technology、Healthcare,用于筛选股票。 |
to | string | 可选 | 2024-03-01 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
调用代码示例
Python 关键代码板块历史表现由 /stable/historical-sector-performance 提供(必填 sector),明细涵盖 sector(板块)、exchange(交易所代码)、averageChange(平均涨跌幅) 等 4 列。
resp = requests.get(
"https://quote-fmp.com/stable/historical-sector-performance",
params={"from": "2024-02-01", "exchange": "NASDAQ", "sector": "Energy", "to": "2024-03-01", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 averageChange(平均涨跌幅)
df["averageChange"] = pd.to_numeric(df["averageChange"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 2025 一季度区间(from/to)查询板块历史表现 | sector=Energy&from=2025-01-01&to=2025-03-31 | 设定 2025Q1 起止日期调用 /stable/historical-sector-performance,返回窗口内全部 sector、exchange、averageChange 共 4 列事件记录。 |
| 回溯 2024H2 日期区间(from/to)归档板块历史表现 | sector=Energy&from=2024-07-01&to=2024-12-31 | 将日期窗口移至 2024 下半年调用 /stable/historical-sector-performance,批量回填历史截面的 sector、exchange、averageChange(样本 Energy)。 |
解析 /stable/historical-sector-performance 产出的板块历史表现(必填 sector)时,注意 sector(如 Energy)在历史早期截面可能为 null,下游计算前需做空值过滤。
本地维护板块历史表现底表(源自 /stable/historical-sector-performance)时,主键定为 (date, exchange, sector);读取 averageChange(平均涨跌幅,样本 1.3989969286740689)做横截面标准化前先剔除 NaN。
返回数据
4 个字段本接口示例响应共包含 4 个字段(数值型 1 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2024-03-01" | 日期 |
sector | string | "Energy" | 板块 |
exchange | string | "NASDAQ" | 交易所代码 |
averageChange | number | 1.3989969286740689 | 平均涨跌幅 |
查看响应数据示例(原始 JSON)
[
{
"date": "2024-03-01",
"sector": "Energy",
"exchange": "NASDAQ",
"averageChange": 1.3989969286740689
}
]常见问题解答(FAQ)
2 个问题在实际量化建模中,板块历史表现与 板块表现快照(/stable/sector-performance-snapshot)是如何互补联动的?
向 /stable/historical-sector-performance 请求板块历史表现需遵循必填 sector,返回 sector(板块,样本 Energy)等 4 项;而 Market Sector Performance Snapshot(板块表现快照)遵循必填 date并返回 4 项。
回测需要多期或多标的板块历史表现,调用 /stable/historical-sector-performance 应该如何组织请求?
您可以指定起止日期 from/to 分段同步 /stable/historical-sector-performance;在落盘 板块历史表现 的 sector 与 exchange 时,建议将原始响应分批转换为列式存储。
同模块相关接口对比
Market Performance本接口路径 /stable/historical-sector-performance,必填参数 sector。 同一模块「Market Performance」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 板块表现快照Market Sector Performance Snapshot | /stable/sector-performance-snapshot | 按板块平均涨跌幅呈现市场各板块的表现,分析不同行业在市场中的实时表现 |
| 细分行业表现快照Industry Performance Snapshot | /stable/industry-performance-snapshot | 每日汇总各细分行业在主要交易所的平均涨跌幅,如广告代理、医疗设备、科技服务等 |
| 细分行业历史表现Historical Industry Performance | /stable/historical-industry-performance | 生物科技、科技、金融服务等各细分行业的历史涨跌数据,覆盖主要交易所 |