数据时间口径

一句话

看返回里的日期，不要看你的系统时间。 不同市场各自的最新交易日不同，各端点的更新节奏也不同。

数据日期看 date

行情类端点（/v1/quote、/v1/kline）每一行都带 date —— 那是数据日期，不是你的请求日期。

2026-10-05（A 股国庆休市）实测，同一次请求里三个市场给出三个不同日期：

代码	data[0].date	说明
sh600519	2026-09-30	A 股休市 ⇒ 最近交易日
hk00700	2026-10-05	港股当天开市
usAAPL	2026-10-02	美股最近交易日

⇒ 判断“是不是最新”，请比 data[0].date 和你的交易日历，不要比系统时间。

last 是“最新价”，不是 tick

/v1/quote 的 data[0] 是最新一根日线：

• 盘中：date = 当天，last = 截至请求时刻的最新价（可当现价用）。
• 盘后 / 休市：date = 最近交易日，last = 那天收盘价。

字段叫 last 而不是 close 就是这个原因 —— 一个名字覆盖两种含义。做展示时先看 date 是不是当天，避免把昨日收盘价当现价显示。

各端点的更新节奏

端点	数据有多新
/v1/orderbook	约 10 秒刷新一次；盘中才有意义，收盘后是当日最后一份快照
/v1/quote · /v1/kline	最新一根日线。不追求 tick 级：同一只票、同样参数在几分钟内重复请求会拿到同一份数据
/v1/market-overview	返回里自己标了数据日期（见下）
/v1/changedist	当期口径
龙虎榜 / 主力资金 / 财务	按交易日盘后更新，盘中拿到的是上一交易日口径
板块类（/v1/sector 等）	更新更慢，需要时再取即可

⚠️ market-overview 会把数据日期写在返回里，实测原文：

数据日期 2026-09-30（请求日期 2026-10-05，后端实际数据日期）

涨跌家数：别用错端点

想要	用	口径
当期涨跌家数 / 涨停家数 / 市场广度	/v1/changedist	当期
大盘画像（含涨跌分布）	/v1/market-overview?type=updown	T-1，可能滞后一个交易日

两者数值会不同，不是数据不一致 —— 是口径不同。要当期就用 /v1/changedist。

常见误用

• 拿系统时间当数据日期 —— 休市日会以为“数据没更新”，其实那就是最近交易日。
• 把 last 当实时 tick —— 它是日线的最新价；要秒级看盘口用 /v1/orderbook。
• 用 market-overview?type=updown 当当期广度 —— 那是 T-1 口径。
• 盘中查龙虎榜 / 主力资金 —— 按交易日盘后披露，盘中拿到的仍是上一交易日。