Market Sector Performance Snapshot板块表现快照
该接口按板块平均涨跌幅呈现市场各板块的表现,分析不同行业在市场中的实时表现,适用于全市场板块轮动监控、行业景气度估值对比与日内强势龙头筛选。
https://quote-fmp.com/stable/sector-performance-snapshot?date=2024-02-01数据更新周期
1 Hour
接口说明
- 板块表现数据:获取各板块的表现数据,包括每个板块的平均涨跌幅,传入
date后可拉取sector(板块)、exchange(交易所代码)与averageChange(平均涨跌幅) 等指标,为基本面与量价研究提供标准输入。 - 按交易所分析:分析 NASDAQ、NYSE 等特定交易所的板块表现,通过提取
sector(板块)与exchange(交易所代码) 等字段,可在 Pandas 中快速构建多因子暴露矩阵。 - 每日快照:板块表现每日更新,实时跟踪趋势与市场动态,若需补充上下文维度,可搭配同模块的「板块历史表现」交叉比对核心指标。
- 上下游关联接口:Biggest Stock Losers(跌幅榜) · Top Traded Stocks(成交活跃榜) · Available Sectors(可用板块清单) · Available Industries(可用细分行业清单)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
date | string | 必填 | 2024-02-01 | 单一日期,格式 YYYY-MM-DD,用于查询某一天的行情或快照。 |
exchange | string | 可选 | NASDAQ | 目标交易所代码或名称,如 NASDAQ、NYSE、AMEX。 |
sector | string | 可选 | Energy | 板块(sector),如 Technology、Healthcare,用于筛选股票。 |
调用代码示例
Python 关键代码板块表现快照(/stable/sector-performance-snapshot,必填 date)返回 sector(板块)、exchange(交易所代码)、averageChange(平均涨跌幅) 等 4 列(样本 sector=Basic Materials)。
resp = requests.get(
"https://quote-fmp.com/stable/sector-performance-snapshot",
params={"date": "2024-02-01", "exchange": "NASDAQ", "sector": "Energy", "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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 指定纳斯达克(NASDAQ)拉取板块表现快照 | date=2024-02-01&exchange=NASDAQ | 向 /stable/sector-performance-snapshot 传 exchange=NASDAQ,获取纳斯达克市场的 sector、exchange、averageChange(样本 sector=Basic Materials)。 |
| 切换纽交所(NYSE)对比板块表现快照 | date=2024-02-01&exchange=NYSE | 改传 exchange=NYSE 调用 /stable/sector-performance-snapshot,拉取纽交所主板对应的 sector、exchange、averageChange。 |
请求 /stable/sector-performance-snapshot 获取板块表现快照需传入必填 date;返回数组涵盖 sector(Basic Materials)与 exchange(NASDAQ),做时间序列差分前请先核对排序方向。
在 /stable/sector-performance-snapshot 的返回结构中,sector(Basic Materials)与 averageChange(-0.31481377464310634)构成核心载荷,本地表以 (date, exchange, sector) 保证幂等入库。
返回数据
4 个字段本接口示例响应共包含 4 个字段(数值型 1 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2024-02-01" | 日期 |
sector | string | "Basic Materials" | 板块 |
exchange | string | "NASDAQ" | 交易所代码 |
averageChange | number | -0.31481377464310634 | 平均涨跌幅 |
查看响应数据示例(原始 JSON)
[
{
"date": "2024-02-01",
"sector": "Basic Materials",
"exchange": "NASDAQ",
"averageChange": -0.31481377464310634
}
]常见问题解答(FAQ)
2 个问题/stable/sector-performance-snapshot 端点(板块表现快照)的参数设计与同模块的 细分行业表现快照 有什么区别?
工程上常将两者配合:用 板块表现快照(/stable/sector-performance-snapshot,必填 date)拉取 sector 与 exchange 等 4 列,同时用 Industry Performance Snapshot(细分行业表现快照)补充 4 列关联信息。
使用 /stable/sector-performance-snapshot 采集板块表现快照构建因子库,推荐的请求切片方式是什么?
采集 /stable/sector-performance-snapshot 的核心技巧是传入精确匹配的 date 参数调用 /stable/sector-performance-snapshot;这能确保 板块表现快照 的 sector 与 exchange 连续完整且无截断遗漏。
同模块相关接口对比
Market Performance本接口路径 /stable/sector-performance-snapshot,必填参数 date。 同一模块「Market Performance」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 细分行业表现快照Industry Performance Snapshot | /stable/industry-performance-snapshot | 每日汇总各细分行业在主要交易所的平均涨跌幅,如广告代理、医疗设备、科技服务等 |
| 板块历史表现Historical Market Sector Performance | /stable/historical-sector-performance | 能源、科技、医疗健康等市场板块的历史涨跌数据,覆盖主要交易所 |
| 细分行业历史表现Historical Industry Performance | /stable/historical-industry-performance | 生物科技、科技、金融服务等各细分行业的历史涨跌数据,覆盖主要交易所 |