---
name: stock-minutes
description: 股票历史分钟行情。必填 --symbol；可选日期和分页参数。 用户询问股票历史分钟行情时使用。
---

# 股票历史分钟行情

外部接口：`GET /api/v2/market/data/stock_minutes`。

必填 --symbol；可选日期和分页参数。

所有请求必须设置环境变量 `FTSHARE_API_KEY`；handler 将其作为 `FTSHARE_API_KEY` 请求头发送。缺失凭据时不会发起请求。

通过主目录 `run.py` 调用：

```bash
python <RUN_PY> stock-minutes --symbol 000001.SZ --since-ts-millis 1787189400000 --until-ts-millis 1787191200000 --limit 5
```

接口返回 JSON；HTTP 错误输出到 stderr 并以非零状态退出。

响应为数组结构（非分页），每根 K 线字段：open / high / low / close / ts_millis / ts_millis_open / turnover / volume / turnover_rate（换手率）。