Batch Market Cap批量市值数据
该接口支持在单次请求中传入多个股票代码（逗号分隔），一次性批量返回这一篮子上市公司的最新交易日总市值快照。通过将原本需要数十次循环调用的单票查询合并为单次网络往返，大幅提升了投资组合权重重算、同业市值对比与观察池刷新的工程吞吐效率。
https://quote-fmp.com/stable/market-capitalization-batch?symbols=AAPL,MSFT,GOOG数据更新周期
Real-Time · 实时更新
接口说明
- 投资组合市值加权权重日终重算：在管理自建指数、行业 ETF 模拟盘或多因子持仓组合时，每日收盘后需按各成分股最新总市值重新计算市值加权比例。将组合内数十只股票代码拼入一次批量请求，即可秒级拿齐全部最新市值。
- 大幅节省请求配额与网络往返延迟：相比对观察池中的百余只股票逐一发起单票市值或公司概况查询，采用批量市值接口可将 HTTP 请求次数压缩一至两个数量级，避免触发网关每分钟请求速率限制（RPM），保障定时任务稳定高效运行。
- 行业可比公司估值看板批量刷新：在构建自定义的细分赛道龙头对比看板（如“美股七巨头”或“全球十大半导体公司”实时对比表）时，前端或中台服务仅需一次调用即可同步刷新整张表格的最新市值数据。
- 跨模块关联接口：Company Share Float & Liquidity（流通股与流动性） · All Shares Float（全市场流通股数据） · Stock Screener（条件选股） · Company Profile Data（公司概况）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbols | string | 必填 | AAPL,MSFT,GOOG | 一个或多个证券代码，多个代码用逗号分隔（支持逗号拼接多只标的代码并发查询，单次建议控制在 50～100 只以内） |
调用代码示例
Python 关键代码采集 批量市值数据（/stable/market-capitalization-batch）需传必填 symbols，重点读取 marketCap（总市值）、symbol（证券代码）、date（日期）（样本 marketCap=4874072686740）。
resp = requests.get(
"https://quote-fmp.com/stable/market-capitalization-batch",
params={"symbols": "AAPL,MSFT,GOOG", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 marketCap（总市值）
df["marketCap"] = pd.to_numeric(df["marketCap"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 科技龙头组合（AAPL,MSFT,NVDA）并发查询批量市值数据 | symbols=AAPL,MSFT,NVDA | 在 symbols 中逗号拼接多股代码请求 /stable/market-capitalization-batch，一次返回 marketCap、symbol、date（如 marketCap=4874072686740）。 |
| 跨行业权重股（JPM,BRK-B,XOM）批量拉取批量市值数据 | symbols=JPM,BRK-B,XOM | 单次请求并发刷新金融与能源龙头的 marketCap、symbol、date 等 3 个字段。 |
| 港股组合（0700.HK,9988.HK）跨市场批量批量市值数据 | symbols=0700.HK,9988.HK | 组合携带 .HK 后缀的证券代码，从 /stable/market-capitalization-batch 批量提取 marketCap、symbol、date。 |
对接 /stable/market-capitalization-batch（批量市值数据，必填 symbols）时，重点字段 marketCap（4874072686740）与 symbol（AAPL）反映当期截面状态，跨期比较前须对齐时间粒度。
清洗批量市值数据响应时，先按 (symbol, date) 剔除重复行，再提取 marketCap（总市值，样本 4874072686740）构造量化指标。
返回数据
3 个字段本接口示例响应共包含 3 个字段（数值型 1 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-30" | 日期 |
marketCap | number | 4874072686740 | 总市值 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"date": "2026-07-30",
"marketCap": 4874072686740
}
]常见问题解答（FAQ）
2 个问题请求 /stable/market-capitalization-batch 获取批量市值数据时有哪些必填项？它与 公司市值 的边界在哪？
批量市值数据（/stable/market-capitalization-batch）采用必填 symbols查询，返回首条样本如 marketCap=4874072686740（共 3 列）；同模块相邻的 Company Market Cap（公司市值）则包含 3 列。
初次建库回填批量市值数据与日常增量拉取 /stable/market-capitalization-batch，在传参方式上有何技巧？
在量化管道中，应将目标股票池按 50～100 只分批拼入 symbols 调用 /stable/market-capitalization-batch；若并发拉取多组任务，请结合网关 RPM 配额控制并发协程数，稳健采集 marketCap。
同模块相关接口对比
Market Cap本接口路径 /stable/market-capitalization-batch，必填参数 symbols。 同一模块「Market Cap」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。