stock-intraday

# 股票跨日分时行情 ## 1. 接口描述 | 项目 | 说明 | |------|------| | 接口名称 | 股票跨日分时行情（stock_intraday） | | 外部接口 | `GET /api/v4/market/data/stock-intraday` | | 请求方式 | GET（query 参数） | | 适用场景 | 查询单只股票的分钟分时价格、均价及日累计成交量额；支持当日实时分时与近期历史分时合并返回 | | 数据范围 | 当日及近期历史交易日，时间范围按北京时间（Asia/Shanghai）计算 | | 单次限量 | 单只股票；`days` 为 1～5；无分页，返回所选范围内的可用数据点 | ## 2. 请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | symbol | string | 是 | 股票代码（需带市场后缀） | 600000.SH | 不接受裸代码；也接受 `600000.XSHG` 等 MIC 后缀 | | range | string | 否 | 预置区间 | Today | `Today`（当日）/`FiveDays`（当日及此前 4 个交易日，默认）；大小写敏感 | | days | int | 否 | 查询当日及此前 N−1 个交易日 | 3 | 范围 1～5，`1` 表示当日 | | ts_ms | int | 否 | 当日过滤起点（毫秒，包含起点） | 1789522140000 | 只过滤当日数据，不能通过它指定历史日期；早于当日零点时按当日零点处理 | 三个时间参数可以同时传入，按 `ts_ms` > `days` > `range` 选择生效参数，低优先级参数不参与范围计算；三者均不传时默认 `FiveDays`。 ## 3. 响应说明 外层固定为 `code`（成功 200）/ `message`（成功 `success`）/ `data`。`data` 为分时点数组，按时间升序排列，同一分钟只返回一个数据点，无分页： | 字段名 | 类型 | 说明 | 单位 | |--------|------|------|------| | ts_ms | int | 分钟起点的 Unix 毫秒时间戳 | 毫秒 | | price | number | 成交价格；历史分钟取该分钟收盘价，不复权 | 元 | | avg_price | number / null | 当日累计成交均价；不可用时为 `null`，字段仍返回 | 元 | | volume | int | 当日累计成交量 | 股 | | turnover | number | 当日累计成交额 | 元 | 注：`price` / `avg_price` / `turnover` 是 JSON 数字，不是字符串。历史均价按当日累计成交额除以累计成交量计算，累计成交量为零时均价为 `null`。 ## 4. 调用方式 ```bash # 当日分时 python <RUN_PY> stock-intraday --symbol 600000.SH --range Today # 默认五日范围（不传任何时间参数） python <RUN_PY> stock-intraday --symbol 600000.SH # 当日及此前两个交易日 python <RUN_PY> stock-intraday --symbol 600000.SH --days 3 # 显式指定五日范围 python <RUN_PY> stock-intraday --symbol 600000.SH --range FiveDays # 同时传入 days 与 range 时 days 优先，此请求按三日范围查询 python <RUN_PY> stock-intraday --symbol 600000.SH --days 3 --range Today ``` `<RUN_PY>` 为主 SKILL.md 同级 `run.py` 的绝对路径。输出 JSON；HTTP 错误输出到 stderr 并以非零状态退出。 ## 5. 注意事项 - `symbol` 必填且需带市场后缀，不接受裸代码。 - `days=3` 表示当日及此前 2 个交易日，历史日期跳过休市日；例如在周二且周一、上周五均为交易日时，范围覆盖上周五、周一和周二。 - 当日按自然日计算：非交易日不会自动用上一个交易日替换当日，因此实际有数据的日期数可能少于 `days`。 - `ts_ms` 只过滤当日数据；传入过去日期的时间戳不会返回该历史日期。跨日查询使用 `days` 或 `range`。 - 历史分钟价格不复权。 - 行情查询所需数据不可用时接口返回错误，不会以缺少部分日期的数据冒充完整成功结果；HTTP 400 表示参数问题，405 不支持的方法，502 行情查询失败，503 行情服务暂不可用。