跳转至

历史数据

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())

获取周线数据

# 获取周线数据
df = get_hist_data(symbol="600000", interval="week", start_date="2023-01-01", end_date="2024-01-01")
print(df.head())