> Source: https://ashareapi.com/wiki/freshness/  ·  Markdown version for LLMs / AI agents

参考

# 数据时间口径
 判断数据新不新，看返回里的日期字段，不要看你的系统时间。不同市场各自的最新交易日不同；各端点更新节奏也不一样，从约 10 秒到按交易日盘后都有。

## 一句话

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


## 数据日期看 `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 口径。


- **盘中查龙虎榜 / 主力资金** —— 按交易日盘后披露，盘中拿到的仍是上一交易日。




 最后更新: 2026-10-05
 各市场的数据日期与更新节奏为 2026-10-05 线上实测；端点更新节奏取自端点说明与数据层实现。

 接着看

-
[返回信封字段](/wiki/envelope)

-
[空结果不等于故障](/wiki/empty-result)

 [← 全部 Wiki](/wiki)