Available Sectors可用板块清单
该接口返回平台采用的一级行业板块(Sector)标准分类清单,涵盖科技、医疗保健、金融服务、消费、能源及工业等核心经济部门。作为行业分类体系的顶层枚举字典,它直接支撑股票筛选器过滤、板块轮动监控与组合行业暴露归因。
https://quote-fmp.com/stable/available-sectors数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 股票筛选器与板块接口标准词表:在调用股票筛选器或板块表现接口时,板块参数需严格匹配系统标准英文命名。通过该接口拉取官方一级板块枚举值,可直接渲染为前端下拉筛选菜单或作为量化脚本的参数校验字典。
- 宏观景气追踪与一级板块轮动切分:全市场上市公司被统一归入十余个核心一级板块(如科技、公用事业、必需消费、能源等)。策略研究员可基于该标准分类体系汇总各板块的总市值、估值中位数与资金流向,刻画美股顺周期与防御板块的轮动节奏。
- 投资组合行业暴露与风险监控基准:在多因子选股与组合优化(Portfolio Optimization)中,利用该一级板块字典对持仓标的进行归类汇总,可精准计算组合在各大经济部门的权重偏离度,落实行业中性化约束与单一板块敞口上限控制。
- 配套投研接口:Company Profile Data(公司概况) · Company Profile Bulk(公司概况批量) · Eod Bulk(日线行情批量) · All Exchange Market Hours(交易所交易时段)
调用代码示例
Python 关键代码按示例请求 /stable/available-sectors 获取可用板块清单(仅 apikey),DataFrame 包含 sector(板块)(sector=Basic Materials)。
resp = requests.get(
"https://quote-fmp.com/stable/available-sectors",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量可用板块清单初始化本地主表 | GET /stable/available-sectors(免参数) | 直接请求 /stable/available-sectors 即返回全表,含 sector 等 1 列;建库或每日全量覆盖时无需拼接任何 Query 参数。 |
| 以 sector 为唯一键覆盖写入,避免全表重复 | GET /stable/available-sectors → upsert on sector | 全表每轮返回 sector(样本 Basic Materials)等 1 列,落库时以 sector 作唯一键覆盖;同模块无参数相近的接口,单点补数只能重拉全表。 |
| 落库后自检:sector 唯一性对账 | GET /stable/available-sectors → count(distinct sector) | 本表仅 1 列(sector 为唯一标识)。落库后比对 count(distinct sector) 与接口实际返回条数,两者一致即无重复写入。 |
在量化流水线中调用 /stable/available-sectors(可用板块清单,免业务参数),拿到的 sector(Basic Materials)需先经过非空校验再送入下游模块。
/stable/available-sectors 单行含 1 个属性(如 sector=Basic Materials);PostgreSQL 或 ClickHouse 建表推荐以 (sector) 为主键。
返回数据
1 个字段本接口示例响应共包含 1 个字段(数值型 0 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
sector | string | "Basic Materials" | 板块 |
查看响应数据示例(原始 JSON)
[
{
"sector": "Basic Materials"
}
]常见问题解答(FAQ)
2 个问题在对接「Directory」数据线时,可用板块清单与 全部股票代码清单 各自解决什么问题?
可用板块清单 通过 /stable/available-sectors(免业务参数)返回 sector(板块)等 1 列明细;同模块的 Company Symbols List(全部股票代码清单) 则通过 /stable/stock-list(无必填参数)提供配套数据。
想要完整归档可用板块清单,请求 /stable/available-sectors 时在参数调度上有什么最佳实践?
在采集 可用板块清单 时,可免过滤参数访问 /stable/available-sectors 一次性导出完整截面;若遇到休市日或未披露窗口返回 [],脚本应记录水位线并平滑跳过。
同模块相关接口对比
Directory本接口路径 /stable/available-sectors,无必填参数。 同一模块「Directory」下共 11 个接口,下表列出其余 10 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 全部股票代码清单Company Symbols List | /stable/stock-list | 平台覆盖的全球各大交易所全部股票、ETF 及可交易金融工具的完整代码总表 |
| 报表公司清单Financial Statement Symbols List | /stable/financial-statement-symbol-list | 全市场所有具备标准化财务三表数据的上市公司代码清单 |
| CIK 编号清单CIK List | /stable/cik-list | 全市场 SEC 注册实体的中央索引键(CIK)与机构/公司标准名称的分页目录 |
| 股票代码变更清单Symbol Changes List | /stable/symbol-change | 汇总全市场因公司更名、并购重组、借壳上市或拆合股而发生的股票代码变更历史台账 |
| ETF代码检索ETF Symbol Search | /stable/etf-list | 全球主要交易所挂牌的全部交易所交易基金(ETF)代码与基金名称完整目录 |
| 在市活跃交易清单Actively Trading List | /stable/actively-trading-list | 当前在全球公开交易所处于正常挂牌交易状态的全部股票与金融工具代码清单 |
| 业绩电话会纪要代码清单Earnings Transcript List | /stable/earnings-transcript-list | 全市场所有已收录业绩电话会文字纪要的上市公司代码清单及每家公司可查的历史纪要总篇数 |
| 可用交易所清单Available Exchanges | /stable/available-exchanges | 平台支持的所有全球证券交易所标准字典 |
| 可用细分行业清单Available Industries | /stable/available-industries | 平台采用的二级细分行业标准分类全量清单 |
| 可用国家清单Available Countries | /stable/available-countries | 平台有证券数据覆盖的全部国家与地区两字母标准代码清单 |