快速开始
① 注册账号(免费,零门槛)
② 登录后进入 控制台 → Token 页签发 API Token
③ 请求带 Authorization: Bearer <token> 头,调用下方任意端点
两套 API 同一把 Token:📀 历史数据走 https://api-stock.600044.xyz
· ⚡ 实时行情走 https://rt-stock.600044.xyz(须先在
实时行情订阅添加代码)·
选型指引见 快速开始 · 两套 API 总览 →
字段单位口径以 /api/datasets 返回的 units 为准
Python SDK(推荐)
pip install stockroute
(镜像同步慢时:pip install -i https://pypi.org/simple stockroute)
· 开源:Stock-Route/stockroute-sdk
from stockroute import StockRoute
sr = StockRoute() # 或环境变量 STOCKROUTE_TOKEN
df = sr.kline("600519") # 历史 K线(按档位)
print(df.attrs["units"]) # 单位口径自动挂载
| 端点 | SDK 方法 |
|---|---|
/api/kline | sr.kline(code, start, end) |
/api/financial | sr.financial(code, kind, as_of) |
/api/daily_basic | sr.daily_basic(code, date) |
/api/query | sr.query(dataset, code, start, end, limit) |
/api/meta/stocks | sr.stocks(status, industry, keyword, paginate=True) |
/api/news | sr.news(since, code, keyword) |
/api/datasets | sr.datasets() |
异常分层:AuthError / TierError(.have/.need) /
QuotaError / RateLimited(.retry_after) / NotFoundError / ServerError。
备用入口:StockRoute(base="https://api-stock.stockroute.pro")
端点速览
| 端点 | 说明 | 服务 | 鉴权 |
|---|---|---|---|
GET /v1/quote/{code} |
实时行情报价——⚠ 本接口在独立域名 rt-stock.600044.xyz(非文档站所在域)。单股实时快照:盘口 15 字段 / 五档买卖盘 / 当日资金流,按 fields 参数按需返回。 | ⚡ 实时 | Bearer |
GET /api/health |
服务健康探活——服务状态与数据覆盖概要。负载均衡/监控探活用,无需鉴权。 | 📀 历史 | 无需鉴权 |
GET /api/datasets |
数据集列表——列出你有权访问的数据集(名称/口径 units/SLA/是否需会员)。返回随身份过滤——免费版看不到需会员的数据集。 | 📀 历史 | Bearer |
GET /api/meta/stocks |
股票列表——全部 A 股基础列表:代码/名称/同花顺行业/上市退市日期——选股与批量的第一步元数据。 | 📀 历史 | Bearer |
GET /api/query |
通用数据直查——按数据集名直查:宏观/资金流/分钟线/竞价/龙虎榜/两融/涨停池/热榜/可转债/基金/股东/三大报表/高管/解禁/质押/回购/元数据等 81 个数据集,一个端点通吃。 | 📀 历史 | Bearer |
GET /api/kline |
历史K线(日/周/月)——个股 K线 OHLCV:日线/周线/月线一键切换(周月由前复权日线聚合,自动剔除分红假跌;上市以来全历史,免费版限近 3 年)。 | 📀 历史 | Bearer |
GET /api/financial |
点时财务指标——单股财务指标,as_of 点时强制:只返回公告日严格早于决策日的财报,杜绝前视。 | 📀 历史 | Bearer |
GET /api/daily_basic |
每日指标(估值)——个股每日估值指标:PE/PB/PS/股息率/换手率/总市值/流通市值(本站加工口径)。 | 📀 历史 | Bearer |
GET /api/download/kline |
K线全历史下载——单股日K线全历史 parquet 文件下载(二进制),适合一次性落地本地。 | 📀 历史 | Bearer |
通用约定
| 项 | 说明 |
|---|---|
code 格式 | 三种写法等价:600519 / 600519.SH / sh.600519 |
| 单位口径 | 每个响应携带 units 字段——45 是 45% 还是 0.45,查 units 不猜 |
| PIT 点时 | 财务类接口 as_of 必填,只返回公告日严格早于决策日的记录,拒绝前视 |
| 限速与配额 | 按档位:免费版 30 次/分 · 1,000 次/月;每次调用按数据集扣 1~10 次(月次数=调用预算) |
| 错误码 | 401 无效token / 403 需会员(该数据集基础档起) / 404 无数据 / 422 缺必填 / 429 限速或月配额 / 503 授权暂不可用(fail-closed) |