批量日线
批量日线: 一批证券(≤100码)一次HTTP往返取回, rows合并(每行含code); 复权/截尾/实时行语义与单票 /api/a/stock/day 完全一致。服务端按码数计点 —— 一次调用消耗 codes 中码数个配额点
接口说明
批量日线:一批证券(≤100码)一次 HTTP 往返取回,rows 合并返回(每行含 code 列)。
复权/截尾/实时行语义与单票 /stock/day 完全一致
按码数计点:50码一次=50点,与逐码等价 —— 省的是往返不是配额
全市场每日落库用 /stock/day 的 date 截面(1次1点拉8700行),别用批量
股票池>100码:SDK 里分批循环,或用 pro.batch() 执行器(内置限速与失败汇总)
快速调用
同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。
一批研究标的批量取(前复权)
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.stock_day_batch(codes="sz000911,sh600519,bj832566",
start_date="2026-09-01", adjust="qfq", limit=10)
print(df.groupby("code").size())
一批研究标的批量取(前复权)
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/day_batch",
headers={"X-API-Key": KEY},
params={"codes": "sz000911,sh600519,bj832566",
"start_date": "2026-09-01", "adjust": "qfq", "limit": 10},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
一批研究标的批量取(前复权)
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/day_batch?codes=sz000911%2Csh600519%2Cbj832566&start_date=2026-09-01&adjust=qfq&limit=10"
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| codes | str | True | 逗号分隔≤100码(见代码规范), 例: sz000911,sh600519 |
| start_date | str | False | 起始日期 YYYY-MM-DD, 缺省全历史 |
| end_date | str | False | 结束日期 YYYY-MM-DD, 缺省最新 |
| adjust | str | False | 复权: qfq前复权 / hfq后复权, 缺省不复权 |
| limit | int | False | 响应截尾: 每码只返回区间内最新N根(≤10000) |
| include_today | bool | False | 盘中追加当日实时行(is_realtime标记); 复权序列不支持 |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| total_codes / total_rows | int | 码数与合并后总行数 |
| codes[] | list | 每码行数清单: [{code, name, rows}] |
| rows[].code | str | 证券代码(批量行独有列) |
| rows[].date/open/.../turnover | - | 与 /api/a/stock/day 单票行完全同构 |
返回数据样例
{
"total_codes": 3,
"total_rows": 6,
"codes": [
{
"code": "sz000001",
"name": "平安银行",
"rows": 2
},
{
"code": "sz000911",
"name": "*ST广糖",
"rows": 2
},
{
"code": "sh600519",
"name": "贵州茅台",
"rows": 2
}
],
"rows": [
{
"code": "sz000001",
"date": "2026-10-08",
"open": 11.57,
"high": 11.87,
"low": 11.54,
"close": 11.78,
"volume": 148168500,
"amount": 1743402496.0,
"turnover": 0.76
},
{
"code": "sz000001",
"date": "2026-10-09",
"open": 11.78,
"high": 11.89,
"low": 11.58,
"close": 11.59,
"volume": 107810500,
"amount": 1259717120.0,
"turnover": 0.56
},
{
"code": "sz000911",
"date": "2026-10-08",
"open": 5.62,
"high": 5.89,
"low": 5.51,
"close": 5.65,
"volume": 15484500,
"amount": 88080064.0,
"turnover": 3.87
}
]
}
样例取自平台实时数据,rows共 6 条,样例仅展示前 3 条。
最佳实践:批量是「一次HTTP往返」的省事通道, 不省配额点: 50码一次调用=50点, 与逐码调用等价; 股票池>100码请分批。全市场每日落库别用它 —— 用 date 截面(1次调用1点拉8700行)。