API 文档
注册即调 · 沪深北全市场行情与财务数据 · 响应直接进 DataFrame
快速开始
三步拿到第一份数据，全程约 5 分钟：
- 注册账号 —— 控制台自动生成 API Key，免费层每日 500 次调用，长期有效
- 安装官方 SDK：
pip install top369（偏好裸调 HTTP 或 cURL 的，在下方示例切换） - 跑通下方示例 —— SDK 自动携带认证、解包信封、转成 DataFrame，拿到的就能直接算
认证分两轨（2026-10-11 起）：SDK / REST 用请求头 X-API-Key: sk-xxxxxxxxxxxx（Key 在 控制台 生成，可禁用/启用）；网页端控制台走 Authorization: Bearer <JWT> 短时会话（登录自动签发与刷新，无需手动管理）。SDK 已内置；偏好浏览器调试的可用 Swagger UI。
推荐：信封解包 / 类型转换 / 限流异常已内置
# 安装: pip install top369
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx",
base_url="https://api.369.top")
df = pro.day_kline(code="sz000001",
start_date="2024-01-01", adjust="qfq")
print(df.tail())
裸调 HTTP，展示协议本身（仅需 requests）
import pandas as pd
import requests
API = "https://api.369.top/api"
HEADERS = {"X-API-Key": "sk-xxxxxxxxxxxx"}
def query(path: str, **params):
"""GET并解包响应信封 → DataFrame"""
r = requests.get(f"{API}{path}", headers=HEADERS,
params={k: v for k, v in params.items() if v}, timeout=30)
r.raise_for_status()
return pd.DataFrame(r.json()["data"].get("rows", []))
df = query("/stock/day", code="sz000001",
start_date="2024-01-01", adjust="qfq")
print(df.tail())
命令行 / Shell 脚本 / 任意语言均可照抄这个 URL
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/day_kline?code=sz000001&start_date=2024-01-01&adjust=qfq"
通用约定
代码规范
| 交易所 | 市场前缀 | 示例 |
|---|---|---|
| 上海证券交易所 | sh | sh600519(股票) sh000001(指数) |
| 深圳证券交易所 | sz | sz000001(股票) sz399001(指数) |
| 北京证券交易所 | bj | bj832000 |
代码参数接受四种写法: 带市场前缀(sh600519)、裸6位码(600519)、市场点号前缀(sh.600519)、tushare点号后缀(600519.SH) —— 后两种与大小写均自动归一, 响应统一返回带前缀完整码。裸6位码同码多市场时按 股票>ETF>可转债>指数 择优; 显式写了市场的写法以该市场为准, 不做择优。
单位约定
| 字段 | 类型 | 说明 |
|---|---|---|
| volume | int | 成交量, 统一以「股」计(日线/分笔原始单位为手, 平台已换算) |
| amount | float | 成交额, 单位「元」 |
| turnover | float | 换手率(%), = 成交量(股)/流通股本(股)×100 |
| direction | str | 分笔方向: '0'=买盘 '1'=卖盘 '2'=中性盘, null=缺失 |
所有接口的 volume/amount/涨跌幅单位全局统一，无需按接口记忆换算。
响应格式
所有接口统一返回信封 {code, message, data}，业务数据在 data 里（SDK 已自动解包）。
调用出错时返回 HTTP 4xx/5xx，原因见错误码。
会员档位
| 档位 | 频次上限 | 每日调用上限 | 可访问接口 |
|---|---|---|---|
| 免费版 | 30 次/分 | 500 次/天 | 股票列表 / 基本信息 / 交易日历 / 日线（股票 · ETF · 可转债 · 指数） |
| 基础版 | 60 次/分 | 5,000 次/天 | + 复权因子 / 分钟K线（5·15·30·60 分，近 1 年）/ 板块 / ST 名单 |
| 专业版 | 120 次/分 | 20,000 次/天 | + 分笔 / 财务 / 名称历史 / 特殊名单 / 沪深港通 / 分钟K线全历史 |
| 旗舰版 | 300 次/分 | 100,000 次/天 | 全部接口 + 优先工单支持 |
订阅解锁档位，调用本身不计量；会员到期自动回落免费版，不拦截不误伤。每日调用按自然日重置（北京时间 0 点）。价格与加油包见定价页。
错误码
| HTTP状态 | 含义 | 处理建议 |
|---|---|---|
| 400 | 参数错误 | 检查请求参数(见各接口参数表) |
| 401 | API Key 缺失/格式错误/无效/停用 | 控制台重新复制Key, 请求头 X-API-Key |
| 403 | 接口需要更高会员档位 / 会员已过期 | 定价页选择档位提交开通申请(403文案含所需档位), 过期则续费 |
| 404 | 资源不存在 | 检查代码/日期; 停牌与未入库日期无数据 |
| 429 | 当日配额已用尽 | 次日自动重置, 购买加油包或升级档位 |
| 500 | 服务器内部错误 | 稍后重试; 持续出现请联系平台 |
通用排障顺序：先看 HTTP 状态码 → 再看 body 里的 detail 原文 → 参数类问题对照对应接口页的参数表。429 属正常限流，按建议退避即可。
从 Tushare 迁移
已习惯 Tushare 的用户按此对照迁移，语义差异全部列明：
| Tushare 写法 | 本平台写法 | 说明 |
|---|---|---|
| pro.daily(ts_code='000001.SZ') | pro.day_kline(code="000001.SZ") | ts_code 可原样粘贴(.SZ/.SH/.BJ/.HK 后缀与大小写都认), 也接受市场前缀(sz000001)与裸6位码; 响应统一回带前缀完整码; 另有 pro.daily() 别名 |
| pro.weekly / pro.monthly / pro.yearly | pro.period_kline(code=..., freq="weekly"/"monthly"/"yearly") | 无独立HTTP端点 —— SDK 拉日线后本地聚合(先复权再聚合保证正确), 配额按日线根数计 |
| start_date='20180701' | start_date="2018-07-01" | 日期带分隔符 YYYY-MM-DD |
| volume 单位=手 | volume 单位=股(全接口统一) | 已全局换算, 无需再×100 |
| amount 单位=千元 | amount 单位=元 | |
| 积分制(按年付费) | 会员订阅制(月/年付解锁档位, 调用不计量; 积分为充值赠分可抵扣) | 每日调用按自然日重置; 免费版含日线全历史 |
| 官方 tushare 包 | 官方 top369 包 | pip install top369 |
SDK 已内置以上换算，推荐直接用 top369 包。
接口目录
每个接口独立成页，含完整入参/出参契约与调用示例：
行情K线
日K / 多周期分钟K线 / 分时 / 分笔 / 盘后五档 / 复权因子 / AH溢价 —— 价量原始序列与行情派生, 响应直接进 DataFrame
/api/a/stock/day_kline
获取日K线行情, 支持区间与前/后复权, 一次可取全部历史(最多10000根); 另支持 date 全市场单日截面
/api/a/stock/day_batch
批量日线: 一批证券(≤100码)一次HTTP往返取回, rows合并(每行含code); 复权/截尾/实时行语义与单票 /api/a/stock/day 完全一致。服务端按码数计点 —— 一次调用消耗 codes 中码数个配额点
/api/a/stock/minute_kline
获取指定证券的多周期分钟K线
/api/a/stock/minute
获取指定证券、指定日期的1分钟级分时行情
/api/a/stock/tick
获取指定证券、指定日期的逐笔成交明细
/api/a/stock/quote_snapshot
盘后五档快照: 收盘价/量额/内外盘(b_vol/s_vol)/买卖五档
/api/a/stock/adjust_factor
复权因子序列(tushare adj_factor 对位): [{date, factor}], 可据因子本地复权: close_qfq = close × factor(qfq)
/api/a/stock/ah_premium
AH股溢价表(约160对): A股/H股收盘价 + 港元汇率 + 溢价率(%)
基础参考
证券清单 / 证券信息 / 板块归属 / ST名单与名称史 / 特殊名单与沪深港通成分 —— 代码维度的基础字典, 行情查询的先决条件
/api/a/stock/info
获取证券的名称/市场/类型
/api/a/stock/list
获取全市场证券列表, 支持名称模糊或代码精确检索
/api/a/stock/blocks
股票↔板块双向查询: code=查证券所属板块 / board=按板块反查成分股
/api/a/market/trade_calendar
获取区间内全部交易日列表(升序)。用于按交易日循环、对齐回测窗口、判断某日是否开盘
/api/a/stock/st_list
获取指定日期的ST股名单(名称含ST/*ST)。历史日期自动取≤该日最近一次快照, 可还原任意历史时点的戴帽状态(回测剔除ST股用)
/api/a/stock/name_history
获取个股的名称/ST戴帽/停牌状态时间线。戴帽(ST→1)、摘帽(1→0)、更名、停牌的转折点一目了然; 快照起点之前无记录
/api/a/stock/special_list
特殊名单三模式(与 themes 的 theme/code 同构): 无参=可用名单目录(名称+成员数); list_name=指定名单全量成员(代码+名称); code=反查个股所属名单
/api/a/stock/hsgt
获取沪深港通标的名单(按市场分组)
/api/a/stock/ipo_audit
新股审核/发行全队列: 过会登记/核准终止/申购起止/募资总额/批文号/上市日
/api/a/stock/themes
主题题材→成分股映射: 题材名/成员数/事件日期
/api/a/stock/bk_leaders
板块龙头榜: 各窗口(1周/1月/3月/1年)涨跌幅龙头个股 — 列含义见返回 headers
龙虎榜
每日上榜明细 / 席位明细 / 个股上榜历史 —— 游资与机构动向
/api/a/stock/lhb
龙虎榜每日上榜明细: 异动类型(lx)/成交占比%(bzb买入前五/szb卖出前五)/专用席位(sl1陆股通/sl2机构)/净买入(jmr)
/api/a/stock/lhb_detail
个股龙虎榜席位明细: 买/卖各前5营业部 + 买卖金额 + 净额
/api/a/stock/lhb_history
个股历次上榜记录: 上榜类型/当日涨跌幅/买卖额/换手率
/api/a/stock/lhb_yyb
龙虎榜营业部买卖明细: 地区/买方/卖方营业部/买卖合计/方向/席别类型
/api/a/stock/lhb_active
活跃席位榜: 上榜次数/连买(ljb)/连卖(ljs)/占比/涨幅
打板情绪
连板天梯 / 跌停名单 / 涨停揭秘 / 大盘涨跌分布 —— 市场情绪与赚钱效应
/api/a/stock/zdt
涨跌停打板数据: ladder=连板天梯·个股(连板数/涨停时间/涨停原因); dt=跌停个股; stat=涨停揭秘统计(涨停家数/炸板率等)
/api/a/stock/zdt_board_stat
连板天梯·板块统计: 各板块涨停家数/涨停占比/昨日涨停表现/连板数/板块高度
/api/a/stock/movers
每日复盘·涨跌榜: 个股涨跌TOP10(gg) / 行业涨跌榜(hy, 含板块上涨/下跌家数)
/api/a/market/index_breadth
每日复盘·指数面包屑: 9指数(上证180/380等)涨跌幅+收盘点位+上涨/下跌家数
/api/a/stock/zdt_board_height
板块连板高度序列: 各板块(880/881)连板高度/汇总高度 —— 空间板情绪顶底信号
资金流向
融资融券余额序列与个股两融历史 / 每日内外盘主动买卖统计(大单)
/api/a/stock/margin
融资融券数据: scope=market 全市场余额序列(沪深京分市场); scope=stock 个股两融历史(融资余额/融资净买入/融券余量); scope=stock+date 无code=全市场单日截面(按rzye降序)
/api/a/stock/tick_stats
个股每日分笔统计: 成交笔数/主动买卖(内外盘)量额/大单量额 —— 资金流向粗对位
/api/a/stock/block_trades
大宗交易统一视图: 成交价/额/量 + 买方/卖方营业部 + 收盘价 + 溢价率% + 云榜独有补充列(申报价量/后续7·30·90日收益/买卖席位明细/类型, 可空)
/api/a/stock/inst_holdings_chg
机构增减持动静: 机构持有数(万)/机构买入/机构卖出
/api/a/stock/inst_holdings_rank
私募机构持股榜: 机构名/报告期/持股市值(万)/占流通股比%/行业
/api/a/stock/holders_chg
增减持动静: 增持市值/减持市值/净增持市值(万) + 区间起始日与价格
公司财务
报告期财务快照(约400字段: EPS / ROE / BPS / 三表科目) + F10公司资料结构化
/api/a/stock/financial
获取最新或指定报告期的财务快照
/api/a/stock/f10
F10公司资料结构化: 股东研究(十大流通股东)/分红扩股/股本结构/财务分析(指标×报告期)/公司概况/高层治理/龙虎榜单(两融/资金流/大宗)/主力追踪(机构持股/股东户数)/资本运作(增发/质押/回购)/经营分析(主营构成)/行业分析/研究报告 等
/api/a/stock/report_calendar
财报披露时间表: 预约披露日期 + 距披露倒计时天数(按披露日升序)
/api/a/stock/earnings_forecast
A股业绩预告: 预告类型(业绩大幅上升/预亏等) + 预告内容全文
/api/a/stock/rating
券商研报评级流: 评级值(5买4增3中2减1卖) / 变化(H调高K维持L调低M首次) / 券商 / 分析师 / 行业