30 Min Interval Stock Chart个股分时30分钟线
该接口提供指定股票以 30 分钟(半小时)为周期聚合的日内分时 K 线与成交量序列。每个美股常规交易日由 13 根半小时 K 线构成,擅长刻画早盘冲击、午盘盘整与尾盘抢筹的日内时段效应(Intraday Seasonality)及波段支撑阻力位。
https://quote-fmp.com/stable/historical-chart/30min?symbol=AAPL数据更新周期
Real-Time · 实时更新
接口说明
- 日内时段效应与微观结构分析:金融市场微观结构研究表明,美股日内波动率与成交量呈现显著的早盘首半小时与尾盘最后半小时双峰“U 型”分布。30 分钟 K 线天然契合半小时时间块划分,是统计早尾盘动量延续或反转效应的理想粒度。
- 跨日波段交易精细化择时信号:对于持仓周期在 2 至 10 个交易日的波段策略,直接按日线收盘信号交易往往滞后半天以上。采用 30 分钟 K 线计算 MACD、RSI 或通道突破信号,可在保持信号稳健性的前提下将进出场响应速度提升一个数量级。
- 识别机构盘中集中建仓与派发痕迹:相比分钟级零散成交,30 分钟级别的放量长阳或长上影线通常代表机构席位在特定半小时窗口内完成了集中调仓,适合用于构建盘中大资金异动监测指标。
- 关联数据线接口:Stock Price and Volume Data(日线完整行情) · Unadjusted Stock Price(未复权日线行情) · Relative Strength Index(RSI 相对强弱指数) · Dividends Company(公司分红派息)
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
from | date | 可选 | 2024-01-01 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
to | date | 可选 | 2024-03-01 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
nonadjusted | boolean | 可选 | false | 是否返回未复权原始价格:true 返回未复权,false 返回复权。 |
extended | boolean | 可选 | false | 是否包含盘前盘后(extended hours)数据,1 为是、0 为否。 |
调用代码示例
Python 关键代码拉取 个股分时30分钟线 只需访问 /stable/historical-chart/30min(必填 symbol),结果涵盖 open(开盘价)、low(最低价)、high(最高价)(open=331.71)。
resp = requests.get(
"https://quote-fmp.com/stable/historical-chart/30min",
params={"symbol": "AAPL", "from": "2024-01-01", "to": "2024-03-01", "nonadjusted": "false", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 open(开盘价)
df["open"] = pd.to_numeric(df["open"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 同步 AAPL 单标的个股分时30分钟线 | symbol=AAPL | 针对 AAPL 请求 /stable/historical-chart/30min,获取含 open、low、high(示例 331.71)的结构化 JSON。 |
| 传入起止日期(from/to)提取 AAPL 2024 年个股分时30分钟线 | symbol=AAPL&from=2024-01-01&to=2024-12-31 | 通过 from=2024-01-01&to=2024-12-31 请求 /stable/historical-chart/30min,按日历窗口归档 AAPL 的 open、low、high。 |
| 带 .HK 后缀查询港股标的个股分时30分钟线 | symbol=0700.HK | 针对非美股标的传入 0700.HK,从 /stable/historical-chart/30min 提取对应的 open、low、high。 |
在个股分时30分钟线(/stable/historical-chart/30min)中,首条样本的 open 为 331.71、low 为 331.71;批量采集时请按必填 symbol校验传参格式。
存储个股分时30分钟线(/stable/historical-chart/30min)数据时,联合键 (symbol, date) 能唯一标识每条截面;注意 open(开盘价,样本 331.71)采用原始计价单位。
返回数据
6 个字段本接口示例响应共包含 6 个字段(数值型 5 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-07-30 13:00:00" | 日期 |
open | number | 331.71 | 开盘价 |
low | number | 331.71 | 最低价 |
high | number | 332.82999 | 最高价 |
close | number | 332.31989 | 收盘价 |
volume | number | 980442 | 成交量 |
查看响应数据示例(原始 JSON)
[
{
"date": "2026-07-30 13:00:00",
"open": 331.71,
"low": 331.71,
"high": 332.82999,
"close": 332.31989,
"volume": 980442
}
]常见问题解答(FAQ)
2 个问题使用「Intraday」接口族时,个股分时30分钟线(必填 symbol)与 个股分时1分钟线(必填 symbol)怎么选?
按输入参数看,/stable/historical-chart/30min(个股分时30分钟线)为必填 symbol,产出 open(331.71)等 6 列;/stable/historical-chart/1min(1 Min Interval Stock Chart(个股分时1分钟线))为必填 symbol,产出 6 列。
在自动化流水线中对接个股分时30分钟线(/stable/historical-chart/30min),怎样平衡拉取深度与请求效率?
最佳实践是按日历窗口设置 from 和 to 边界调用 /stable/historical-chart/30min;解析响应中的 open(如 331.71)前,请确保对异常空值和网络超时设置退避重试。
同模块相关接口对比
Intraday本接口路径 /stable/historical-chart/30min,必填参数 symbol。 同一模块「Intraday」下共 6 个接口,下表列出其余 5 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 个股分时1分钟线1 Min Interval Stock Chart | /stable/historical-chart/1min | 指定股票以 1 分钟为颗粒度的高频日内 K 线序列 |
| 个股分时5分钟线5 Min Interval Stock Chart | /stable/historical-chart/5min | 指定股票以 5 分钟为时间窗口聚合的日内分时 K 线与成交量序列 |
| 个股分时15分钟线15 Min Interval Stock Chart | /stable/historical-chart/15min | 指定股票以 15 分钟为间隔聚合的日内分时 K 线与成交量数据 |
| 个股分时1小时线1 Hour Interval Stock Chart | /stable/historical-chart/1hour | 指定股票按 1 小时周期聚合的分时 K 线(开高低收)与成交量历史序列 |
| 个股分时4小时线4 Hour Interval Stock Chart | /stable/historical-chart/4hour | 指定股票以 4 小时为大时间块聚合的开高低收价格与成交量序列 |