Company Market Cap公司市值
该接口返回指定上市公司在最新交易日的实时/日终总市值(Market Capitalization)快照及对应日期。作为极简、高频的单一核心指标接口,它专为快速获取最新总市值以计算动态估值倍数、核验规模门槛及刷新行情终端市值字段而设计。
https://quote-fmp.com/stable/market-capitalization?symbol=AAPL数据更新周期
Real-Time · 实时更新
接口说明
- 企业价值与动态估值倍数的实时拼图:在实时计算市销率(P/S)、市现率(P/CF)、企业价值倍数(EV/EBITDA =(总市值+总债务-现金)/EBITDA)或自由现金流收益率时,财务报表端数据按季度静态更新,唯独总市值随每日股价波动。调用该轻量级接口可快速补齐最新市值变量。
- 量化交易风控的市值门槛即时校验:在实盘策略发出下单指令前,风控模块常需核验目标标的最新总市值是否仍高于策略底线(如不低于 10 亿美元以防范小盘流动性风险)。该接口响应体极度精简,适合在交易链路中做毫秒级单点核验。
- 同模块三档市值接口的梯度配合:本模块提供三种颗粒度的市值接口——本接口负责“单只股票最新市值秒级查询”,批量市值接口负责“一篮子股票组合的当前市值批量同步”,历史市值接口负责“单只股票过往每日市值的长序列回溯”。
- 上下游关联接口:Search Mergers & Acquisitions(并购检索) · Company Executives(公司高管信息) · Company Profile Data(公司概况) · Stock Quote(股票报价)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码访问 /stable/market-capitalization 获取公司市值(必填 symbol),单条记录含 marketCap(总市值)、symbol(证券代码)、date(日期) 等 3 个字段。
resp = requests.get(
"https://quote-fmp.com/stable/market-capitalization",
params={"symbol": "AAPL", "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)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求公司市值 | symbol=AAPL | 调用 /stable/market-capitalization 拉取 AAPL 的公司市值,输出 marketCap、symbol、date 等 3 项标准化属性。 |
| 跨市场检索 0700.HK 的公司市值数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/market-capitalization,实现公司市值在港股市场的同口径采集(含 marketCap、symbol、date)。 |
访问 /stable/market-capitalization 提取公司市值(必填 symbol),单条 JSON 含 marketCap(4874072686740)、symbol(AAPL)等 3 个字段,空列表响应代表该条件下无披露记录。
从 /stable/market-capitalization 抽取 marketCap(样本 4874072686740)入库时,以 (symbol, date) 建唯一索引可安全支持断点续传。
返回数据
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 个问题如何区分「Market Cap」模块的公司市值与 批量市值数据?/stable/market-capitalization 的传参要求是什么?
两者的差异在于入口与字段集:/stable/market-capitalization(公司市值)要求必填 symbol并产出 3 列(含 marketCap=4874072686740);Batch Market Cap(批量市值数据)要求必填 symbols并产出 3 列。
拉取 /stable/market-capitalization 的公司市值数据时,如何处理历史回溯、空结果判定或代码格式?
针对 /stable/market-capitalization,推荐向 /stable/market-capitalization 传入标准 symbol(港股带 .HK、A 股带 .SS);这样既能稳定获取 marketCap(总市值),又能避免单次请求载荷过大。
同模块相关接口对比
Market Cap本接口路径 /stable/market-capitalization,必填参数 symbol。 同一模块「Market Cap」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。