Python 获取 A 股日线数据:三行代码从安装到 DataFrame
三行代码获取 A 股日线数据:pip install top369 → pro_api(Key) → day_kline 返回 pandas DataFrame。覆盖 API Key 获取、复权与日期参数、代码格式、常见报错排查(401/403/429/503),附常见问题解答。
用 Python 获取 A 股日线数据,最快路径只要三行代码:pip install top369 → gp.pro_api(Key) → pro.day_kline(...),直接返回 pandas DataFrame。本文覆盖从注册拿 Key、跑通第一段代码,到复权与日期参数、常见报错排查的完整流程。写于 2026 年 11 月,示例可整体复制运行。
怎么拿到 API Key?
答案:注册即得,免费档长期免费、每天 500 次调用,无需等待人工审批。
打开 369数据 → 注册(邮箱密码或微信扫码)→ 登录后在 API Keys 页新建一把 Key(sk- 开头)。Key 明文只在创建时展示一次,请立即保存。免费额度足够把本文所有示例跑一遍。
三行代码怎么写?
答案:安装官方 SDK → 建 client → 调 day_kline,返回值就是标准 pandas DataFrame。
pip install top369
import top369 as gp
pro = gp.pro_api("sk-你的Key")
df = pro.day_kline(code="sz000001", start_date="2024-01-01")
print(df.tail())
跑通后 df 一行一个交易日,列为开高低收、成交量等行情字段,可直接 df.plot()、df.to_csv() 或接进你的策略代码。全部端点与参数见 API 文档。
复权、日期、代码格式怎么调?
答案:adjust 参数选复权口径,start_date/end_date 控制区间,代码用交易所前缀 + 六位数字。
- 复权口径:
adjust="qfq"前复权、"hfq"后复权,不传为不复权。做回测建议前复权起步,跨长周期做收益归因用后复权;复权因子可单独获取:pro.adjust_factor(code="sz000001"),因子与行情同源,口径不脱节。 - 日期区间:
start_date="2024-01-01"起始,加end_date="2024-12-31"截止。日线为全历史,从你需要的起点拉即可,不必从零拉全量。 - 代码格式:交易所前缀 + 六位数字——深市
sz000001、沪市sh600519、北交所bj前缀,ETF/可转债/指数同规则;全部代码用列表接口查询。
常见报错怎么排查?
答案:错误都是结构化 JSON(error/status/hint),按 hint 修即可;最常见的是 Key 与档位两类。
- 401:Key 无效或已禁用——检查是否复制完整、Key 是否还在启用状态(多把 Key 共享配额,禁用其中一把不影响其余)。
- 403:档位不足——该端点需要更高订阅档位,免费档可用的数据面以文档标注为准。
- 429:触发频次限制——免费档有每日调用与频次上限,脚本里加个重试间隔即可。
- 503:数据未就绪——如当日归档尚未完成,稍后再取。
完整错误码表见 文档错误码页。
下一步:去哪里看全部接口?
本文只用了日线一个端点。全部数据面(分钟K线、财务、板块、龙虎榜等)见 API 文档;量化回测场景的数据口径与工作流见 量化数据接口;还没确定选哪家平台的,先读 《A股数据 API 怎么选?6 个维度 + 自查清单》——按六个维度实测后再决定。
常见问题
免费 Key 能拉多少数据?
免费档每天 500 次调用,日线全历史可用,足够完成学习与小规模验证;更大用量按档位订阅,计费口径公开可查。
能拉分钟线吗?
能。1/5/15/30/60 分钟K线均有接口,用法与日线一致(换端点与频率参数);分钟数据的历史起点以文档标注为准,1 分钟线尤其要先确认范围再拉取。
股票代码为什么带 sz/sh 前缀?
交易所前缀是通用做法,能无歧义定位标的:深市 sz、沪市 sh、北交所 bj,ETF/可转债/指数同规则。SDK 与 REST 接口都接受这种格式。
日线数据什么时候更新?
收盘后归档,每日 16:00 完成当日更新。多数研究场景不依赖盘中推送,按日归档的口径足够覆盖回测与策略研究。
关于 369数据(www.369.top):本文示例基于官方 Python SDK top369——沪深北三市与港美股、期权数据共用一把 Key,收盘后归档每日 16:00 更新,注册即得长期免费档。数据面总览见 A股数据API,AI 工具接入见 MCP 接入。