---
title: "分时（当日 / 近 5 日盘中走势）"
method: GET
path: "/v1/minute"
tags: ["pro"]
---

# 分时（当日 / 近 5 日盘中走势）

`GET /v1/minute`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/minute`
- Auth: none declared

**分时数据**：盘中每分钟的价格与累计成交量。用户问『今日分时 / 盘中走势 / 分钟级走势 / 今天怎么走的』时用这个。

⚠️ 与 `/v1/kline` 的**分钟线**（`period=m1~m120`）是**两件不同的东西**：本端点 = **分时**（每分钟一个价 + 累计量）；`kline` 分钟线 = **分钟 K 线**（每分钟一根 OHLC 蜡烛）。

⚠️ **`days` 只有两档**（2026-10-06 实测，非推测）：**`1` = 当日**（默认）、**`5` = 近 5 个交易日**。⛔ **没有 2/3/4 这种『取 N 天』** —— 传 2/3/4 上游**不报错但一律返回整 5 日**（实测 `--days 2` 与 `--days 5` **逐字节完全相同**），故参数校验只放行 1 与 5，避免『要 2 天给 5 天』的静默错口径。
⚠️ **字段随标的与 days 不同**（不是固定列）：`code time price volume amount`（`days=1`）；`days=5` 多一列 `date`；**板块 / 美股 / 北交所**无 `amount`（列随上游而定，别硬编码列数）。
⚠️ **期货（`fu*`）/ 外汇（`fx*`）只有 `price` `time` 两列**（单一标的故不带 `code`）。
⚠️ 覆盖标的：A股 / 指数 / 板块 / ETF / 可转债 / 港股 / 美股 / **北交所** / **期货 / 外汇**（期货·外汇走的通道与其余标的**不同** —— 这两类只有该通道有数据）。
⚠️ **属付费层**（需 API Key）—— 门槛 **`standard`（¥29.9）及以上**，`trial`（¥9.9）不可用。
⚠️ **付费档实时**（每次取此刻最新）—— 本端点自 `standard` 起，调用方均为付费档，故无缓存。

## Query parameters

- `code` string, required: 股票代码：sh600667；同样支持 指数 sh000001 / 板块 pt01801081 / ETF sh510300 / 港股 hk00700 / 美股 usAAPL / 可转债 sz128136 / 北交所 bj920047 / 期货 fuCN / 外汇 fxCNH
- `days` integer: 分时档位：1 = 当日（默认）· 5 = 近 5 个交易日（**没有 2/3/4**）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)