Historical Market Cap历史市值查询
该接口按自定义起止日期区间或条数上限，返回指定上市公司在过往各历史交易日的每日总市值时间序列。它综合了历史每日股价与对应时期的真实流通总股本（含增发、回购与可转债转股影响），是构建历史规模因子（Size Factor）与无偏估值回测的权威底座。
https://quote-fmp.com/stable/historical-market-capitalization?symbol=AAPL数据更新周期
2-4 Hours
接口说明
- 规避“用当前股本乘历史股价”的估算失真：许多初级回测脚本习惯用当前最新总股本乘以历史前复权股价来估算历史市值，但这完全忽略了公司在过去十年间频繁发生的股票回购注销（如苹果持续大额回购）或定增扩股、股权激励稀释。该接口直接提供基于当年真实股本核算的历史每日市值。
- 规模因子构建与大小盘风格轮动回测：在多因子量化模型中，历史总市值对数（Log Market Cap）既是核心的规模因子，也是对其他基本面因子做市值中性化（Size Neutralization）正交回归的基准自变量，该接口为此提供了逐日连续的历史序列。
- 历史任意时点动态估值分位数精准还原：将本接口返回的历史每日真实总市值，与按财报真实披露日对齐的历史滚动净利润、净负债数据相结合，即可在回测中精确重构出任意历史交易日真实的动态市盈率与 EV/EBITDA 分位数。
- 上下游关联接口：Company Historical Employee Count（历史员工人数） · Company Share Float & Liquidity（流通股与流动性） · Company Profile Data（公司概况） · Stock Quote（股票报价）
请求参数
4 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
from | date | 可选 | 2026-04-16 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-07-16 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码从 /stable/historical-market-capitalization 同步历史市值查询（必填 symbol），一次拿齐 marketCap（总市值）、symbol（证券代码）、date（日期）（样本值 marketCap=4879177245542）。
resp = requests.get(
"https://quote-fmp.com/stable/historical-market-capitalization",
params={"symbol": "AAPL", "limit": 100, "from": "2026-04-16", "to": "2026-07-16", "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 历史市值查询（symbol=AAPL） | symbol=AAPL | 请求 /stable/historical-market-capitalization?symbol=AAPL，产出该标的的 marketCap、symbol、date（样本 4879177245542）等 3 列明细。 |
| 按年度日期边界拉取 AAPL 历史市值查询历史序列 | symbol=AAPL&from=2024-01-01&to=2024-12-31 | 在 /stable/historical-market-capitalization 中组合 symbol=AAPL 与日期范围，过滤出 2024 全年的 marketCap、symbol、date 明细记录。 |
| 跨市场检索 0700.HK 的历史市值查询数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/historical-market-capitalization，实现历史市值查询在港股市场的同口径采集（含 marketCap、symbol、date）。 |
针对 /stable/historical-market-capitalization（历史市值查询，必填 symbol），返回首行的 marketCap 为 4879177245542、symbol 为 AAPL；入库前请先拦截 200 [] 空响应。
持久化 /stable/historical-market-capitalization（历史市值查询）的 3 个字段时，自然键取 (symbol, date)；数值列 marketCap（样本 4879177245542）切勿用整型截断小数精度。
返回数据
3 个字段本接口示例响应共包含 3 个字段（数值型 1 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-07-30" | 日期 |
marketCap | number | 4879177245542 | 总市值 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"date": "2026-07-30",
"marketCap": 4879177245542
}
]常见问题解答（FAQ）
2 个问题在「Market Cap」下，历史市值查询（/stable/historical-market-capitalization）与 公司市值（/stable/market-capitalization）如何分工？
历史市值查询（/stable/historical-market-capitalization，必填 symbol）重在输出 marketCap（总市值）与 symbol 等 3 列；而 Company Market Cap（公司市值）返回 3 列，两者按查询维度互补。
在批量同步历史市值查询时，/stable/historical-market-capitalization 的查询窗口与参数组合该如何安排？
推荐做法：在 /stable/historical-market-capitalization 中传入 from/to 日期区间分批拉取；当 /stable/historical-market-capitalization 正常返回含 marketCap 的 JSON/CSV 后，即可直接合入本地策略宽表。
同模块相关接口对比
Market Cap本接口路径 /stable/historical-market-capitalization，必填参数 symbol。 同一模块「Market Cap」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。