分钟线查询¶

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Kline.md

所属接口集：K 线数据

请求 URL¶

GET /v1/api/minutes

认证方式¶

Bearer Token（详见认证与签名）

接口概述¶

查询分钟级 K 线数据，接口逻辑与 /kline 一致，但数据源使用通达信分钟线库（get_minutes_data），适用于日内分时场景。缓存 TTL 固定为 30 秒。

请求参数¶

参数	类型	必填	说明
`code`	string	是	股票代码，支持带市场后缀（如 `600000.SH`、`000001.SZ`）或纯数字。市场识别规则同 KlineView
`freq`	string	是	分钟频率，如 `1m`、`5m` 等
`start`	string	否	起始日期时间，格式 `YYYY-MM-DD` 或 `YYYY-MM-DD HH:MM:SS`
`end`	string	否	结束日期时间，格式同上
`fields`	string	否	返回字段逗号分隔列表，用于筛选输出列。`trade_date` 和 `ts` 始终返回
`adj`	string	否	复权方式，默认 `none`。暂不支持 `qfq`/`hfq`，传非 `none` 值会返回 400
`indicators`	string	否	附加技术指标，格式 `ma=5,10;ema=12,26`，支持 `ma`（简单移动平均）和 `ema`（指数移动平均）

接口说明¶

根据传入的 code 自动解析市场与纯数字代码。
调用 get_minutes_data 从通达信分钟线 MySQL 库获取原始 DataFrame。
如果传入了 indicators，按 ma=周期列表;ema=周期列表 格式解析，基于 close 列计算对应均线，新增 ma{N} / ema{N} 列。
格式化输出：trade_date 转为 YYYYMMDD 字符串，ts 转为带 Asia/Shanghai 时区的 ISO 格式，追加 ts_tz 和 ts_code（如 000001.SZ），移除原始 code 列。
如果指定 fields，筛选输出列（trade_date 和 ts 始终保留）。
NaN / None 统一输出为 JSON null。
与 /kline 的区别：数据源为通达信分钟线库，不附加 free_float_shares / free_float_mcap / turnover_rate / value_turnover 字段，缓存 TTL 固定为 30 秒。

响应格式示例¶

{
  "code": 1,
  "message": "success",
  "data": [
    {
      "trade_date": "20260115",
      "ts": "2026-01-15T09:31:00+08:00",
      "ts_tz": "Asia/Shanghai",
      "ts_code": "000001.SZ",
      "market": "SZ",
      "open": 12.30,
      "high": 12.35,
      "low": 12.28,
      "close": 12.32,
      "volume": 50000,
      "amount": 616000.0,
      "pre_close": 12.28,
      "change": 0.04,
      "pct_chg": 0.33,
      "ma5": 12.30
    }
  ]
}

返回状态¶

状态码	说明
200	成功
400	`adj` 参数传了非 `none` 值（暂不支持复权）
401	未认证
403	无权限