Stock Quote股票报价
该接口返回个股的实时行情数据:最新价格、涨跌与成交量,数据实时更新。
GET
https://quote-fmp.com/stable/quote?symbol=AAPL数据更新周期
Real-Time · 实时更新
接口说明
- 盯住实时价格:随时掌握最新股价,为交易决策提供依据,传入
symbol后可读取name(名称)、price(最新价)与changePercentage(涨跌幅(%)) 等标准记录,帮助开发团队快速搭建数据管道。 - 分析股价动向:跟踪涨跌、成交量、日内最高最低价、年内(52 周)高低点等关键数据,对照
price(最新价)与changePercentage(涨跌幅(%)) 等历史记录,可检验策略信号在不同市场周期下的稳健性。 - 投资组合跟踪:用实时数据跟踪自己持仓个股的表现,针对深度投研场景,搭配同模块的「精简报价」能进一步拓宽样本对比维度。
- 上下游关联接口:Stock Batch Quote(股票批量报价) · Stock Batch Quote Short(股票批量精简报价) · Company Profile Data(公司概况) · Biggest Stock Gainers(涨幅榜)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码访问 /stable/quote 获取股票报价(必填 symbol),单条记录含 name(名称)、price(最新价)、changePercentage(涨跌幅(%)) 等 17 个字段。
Python(核心参数与字段清洗逻辑)
resp = requests.get(
"https://quote-fmp.com/stable/quote",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price(最新价)
df["price"] = pd.to_numeric(df["price"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求股票报价 | symbol=AAPL | 调用 /stable/quote 拉取 AAPL 的股票报价,输出 name、price、changePercentage 等 17 项标准化属性。 |
| 跨市场检索 0700.HK 的股票报价数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/quote,实现股票报价在港股市场的同口径采集(含 name、price、changePercentage)。 |
参数与空值防守提取股票报价:识别 200 [] 空响应与 name 落库
访问 /stable/quote 提取股票报价(必填 symbol),单条 JSON 含 name(Apple Inc.)等 17 个字段,空列表响应代表该条件下无匹配记录。
落库主键与口径从 /stable/quote 抽取 price:(symbol, exchange, name) 主键与空值兼容
从 /stable/quote 抽取 price(样本 331.85501)入库时,以 (symbol, exchange, name) 建唯一索引可安全支持断点续传。
返回数据
17 个字段本接口示例响应共包含 17 个字段(数值型 14 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
name | string | "Apple Inc." | 名称 |
price | number | 331.85501 | 最新价 |
changePercentage | number | -1.8732 | 涨跌幅(%) |
change | number | -6.33498 | 涨跌额 |
volume | number | 28718014 | 成交量 |
dayLow | number | 329.59 | 当日最低价 |
dayHigh | number | 334.48 | 当日最高价 |
yearHigh | number | 344.57 | 52 周最高 |
yearLow | number | 201.5 | 52 周最低 |
marketCap | number | 4874072686740 | 总市值 |
priceAvg50 | number | 308.5888 | 50 日均价 |
priceAvg200 | number | 277.21344 | 200 日均价 |
exchange | string | "NASDAQ" | 交易所代码 |
open | number | 333.13 | 开盘价 |
previousClose | number | 338.18999 | 昨收价 |
timestamp | number | 1785430812 | 时间戳 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"name": "Apple Inc.",
"price": 331.85501,
"changePercentage": -1.8732,
"change": -6.33498,
"volume": 28718014,
"dayLow": 329.59,
"dayHigh": 334.48,
"yearHigh": 344.57,
"yearLow": 201.5,
"marketCap": 4874072686740,
"priceAvg50": 308.5888,
"priceAvg200": 277.21344,
"exchange": "NASDAQ",
"open": 333.13,
"previousClose": 338.18999,
"timestamp": 1785430812
}
]常见问题解答(FAQ)
2 个问题如何区分「Single Quote」模块的股票报价与 精简报价?/stable/quote 的传参要求是什么?
两者的差异在于入口与字段集:/stable/quote(股票报价)要求必填 symbol并产出 17 列(含 name=Apple Inc.);Stock Quote Short(精简报价)要求必填 symbol并产出 4 列。
拉取 /stable/quote 的股票报价数据时,如何处理历史回溯、空结果判定或代码格式?
针对 /stable/quote,推荐向 /stable/quote 传入标准 symbol(港股带 .HK、A 股带 .SS);这样既能稳定获取 name(名称),又能避免单次请求载荷过大。
同模块相关接口对比
Single Quote本接口路径 /stable/quote,必填参数 symbol。 同一模块「Single Quote」下共 5 个接口,下表列出其余 4 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 精简报价Stock Quote Short | /stable/quote-short | 单只股票的极简实时行情快照,仅保留最新成交价、涨跌额与当日累计成交量三个核心字段 |
| 盘后逐笔成交Aftermarket Trade | /stable/aftermarket-trade | 盘后交易时段的实时成交明细,成交价、成交规模与成交时间戳等关键信息 |
| 盘后报价Aftermarket Quote | /stable/aftermarket-quote | 正常交易时段之外的股票报价,买卖价、成交量等关键数据实时更新 |
| 股价涨跌Stock Price Change | /stable/stock-price-change | 一次返回单只股票在 1D、5D、1M、3M、6M、YTD、1Y、3Y、5Y等 |
需要稳定访问 股票报价 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月