多周期分钟K线
获取指定证券的多周期分钟K线
接口说明
1/5/15/30/60 分钟五种周期的分钟K线，适合观察日内结构、构建短周期策略。
start_date/end_date 区间查询一次拉一段历史：5/15/30/60分钟上限 250 个交易日，1分钟上限 10 日(超出取区间内最近N日)
period=1 历史库与盘中实时行拼接(实时行带 is_realtime 标记)；merge_days=N 合并最近N个交易日供指标预热
历史深度随周期不同：1分钟~26年，5分钟约5.5年，15/30/60分钟更长
快速调用
同一调用的三种等价写法，按接入习惯任选其一，复制即可运行。
5分钟K线
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.minute_kline(code="sz000001", period=5)
1分钟K线(合并最近5个交易日, 实盘预热)
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.minute_kline(code="sz000001", period=1, merge_days=5)
5分钟K线
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/minute_kline",
headers={"X-API-Key": KEY},
params={"code": "sz000001", "period": 5},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
1分钟K线(合并最近5个交易日, 实盘预热)
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/minute_kline",
headers={"X-API-Key": KEY},
params={"code": "sz000001", "period": 1, "merge_days": 5},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
5分钟K线
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/minute_kline?code=sz000001&period=5"
1分钟K线(合并最近5个交易日, 实盘预热)
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/minute_kline?code=sz000001&period=1&merge_days=5"
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| code | str | True | 证券代码 |
| period | int | False | 周期(分钟): 1/5/15/30/60, 默认5 |
| end_date | str | False | 结束日期 YYYY-MM-DD, 缺省最新一天 |
| start_date | str | False | 起始日期 YYYY-MM-DD(与end_date构成区间; 5/15/30/60上限250个交易日, 1分钟上限10日, 超出取区间内最近N日) |
| merge_days | int | False | 合并最近N个交易日(period=1专用; 缺省单日) |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| code | str | 证券代码 |
| period | int | 本次生效周期 |
| rows[] | array | 字段同分时(time/open/high/low/close/volume/amount) |
返回数据样例
{
"code": "sz000001",
"period": 5,
"rows": [
{
"time": "09:35:00",
"open": 11.78,
"high": 11.89,
"low": 11.78,
"close": 11.79,
"volume": 10383600,
"amount": 122832626.0
},
{
"time": "09:40:00",
"open": 11.79,
"high": 11.81,
"low": 11.72,
"close": 11.73,
"volume": 4360100,
"amount": 51282727.0
},
{
"time": "09:45:00",
"open": 11.73,
"high": 11.77,
"low": 11.72,
"close": 11.75,
"volume": 2967700,
"amount": 34843653.0
}
]
}
样例取自平台实时数据，rows共 48 条，样例仅展示前 3 条。
最佳实践：长历史(跨多个截尾窗口)用 SDK iter_minute_kline 自动分块迭代; 实盘当日1分钟K配 period=1+merge_days(实时行带 is_realtime 标记)。