369数据
首页 API文档 AI接入 在线测试 定价 资讯
控制台 登录/注册
使用教程 2026-11-18

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 接入。

← 返回资讯列表
产品
API 文档 AI Agent 接入 在线测试 定价 A股数据API 介绍 A股历史数据下载 量化数据接口 资讯文章
数据
覆盖 A股(沪深北) · 港股 · 美股 · 期权 A股每日 16:00 收盘后更新 字段与单位说明
关于
369数据 · 股票数据API服务平台 更新日志 服务条款 免责声明 隐私政策 数据整理自公开渠道,仅供量化研究使用,不构成投资建议,不作为实盘交易依据
联系我们
QQ:812299156 邮箱:mhmy@qq.com

© 2026 369数据 · 股票数据API服务平台 · 陕ICP备2024025313号-3