历史数据¶
get_hist_data() 函数用于获取股票历史行情数据,支持多种时间粒度和复权方式。
函数签名¶
def get_hist_data(
symbol: str,
interval: str = "day",
interval_multiplier: int = 1,
start_date: str = "1970-01-01",
end_date: str = "2030-12-31",
adjust: str = "none",
source: str = "eastmoney_direct"
) -> pd.DataFrame
参数说明¶
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol |
str | 是 | - | 股票代码 (如: "600000") |
interval |
str | 否 | "day" | 时间粒度 ("minute", "hour", "day", "week", "month", "year") |
interval_multiplier |
int | 否 | 1 | 时间间隔倍数 |
start_date |
str | 否 | "1970-01-01" | 开始日期 (YYYY-MM-DD) |
end_date |
str | 否 | "2030-12-31" | 结束日期 (YYYY-MM-DD) |
adjust |
str | 否 | "none" | 复权类型 ("none", "qfq", "hfq") |
source |
str | 否 | "eastmoney_direct" | 数据源 ("eastmoney", "eastmoney_direct", "sina", "ths") |
时间间隔说明
如果 interval 为 'minute' 或 'hour',interval_multiplier 表示分钟数或
小时数,如 5 表示 5 分钟线 / 5 小时线。
数据源特性
eastmoney_direct数据源支持港股,如 "00700" 表示腾讯控股eastmoney_direct数据源的小时和分钟级数据只支持当前交易日ths数据源的成交量由上游的“股”换算为“手”,与其它数据源一致- 不同数据源的数据覆盖范围可能有所差异
同花顺 (ths) 数据源说明
- 日线历史较长(可回溯到 2001 年),但上游按年份分片返回,取全量历史需要多次请求
- 分钟线只保留最近约 140 根,且上游的粗周期序列重建较慢,可能落后于最新成交
- 上游没有 15 分钟线,该周期由 5 分钟线重采样得到
- 上证综指在同花顺以
1A0001表示;传sh000001会自动映射为该代码 - 同花顺的日线/周线/月线/年线以“区间结束日”标记,与其它数据源的标记方式不同
股票代码与交易所
sina 与 eastmoney 数据源会按规则为裸 6 位代码补全交易所前缀
(600/688/900 等为 sh,000/001/002/300 等为 sz,4/8 开头为 bj)。
指数需要显式传入带前缀的代码,例如上证综指传 sh000001;
eastmoney_direct 还支持直接传入港股代码(如 00700)。
返回值¶
返回 pandas.DataFrame,包含以下列:
| 列名 | 类型 | 描述 |
|---|---|---|
timestamp |
datetime | 时间戳 |
open |
float | 开盘价 |
high |
float | 最高价 |
low |
float | 最低价 |
close |
float | 收盘价 |
volume |
int | 成交量 |
复权类型说明¶
| 复权类型 | 标识符 | 说明 |
|---|---|---|
| 不复权 | none |
原始价格,不进行任何调整 |
| 前复权 | qfq |
以当前价格为基准向前调整历史价格 |
| 后复权 | hfq |
以历史价格为基准向后调整当前价格 |
使用示例¶
基础用法¶
from akshare_one import get_hist_data
# 获取浦发银行日线数据
df = get_hist_data(symbol="600000")
print(df.head())
获取前复权数据¶
# 获取前复权日线数据
df = get_hist_data(
symbol="600000", interval="day", adjust="qfq", start_date="2024-01-01", end_date="2024-03-31"
)
print(f"数据条数: {len(df)}")
print(df.head())
获取分钟级数据¶
# 获取5分钟线数据(仅当前交易日)
df = get_hist_data(
symbol="600000", interval="minute", interval_multiplier=5, source="eastmoney_direct"
)
print(df.tail())
获取港股数据¶
# 获取腾讯控股港股数据
df = get_hist_data(
symbol="00700", interval="day", source="eastmoney_direct", start_date="2024-01-01"
)
print(df.head())
使用同花顺数据源¶
# 同花顺的日线历史可以回溯到 2001 年
df = get_hist_data(symbol="600519", interval="day", source="ths", start_date="2020-01-01")
print(df.head())