数据水位(增量游标) 在线试调 →

各码(或缺省全市场)日线最新交易日, 充当增量拉取游标: 以水位为界 start_date>水位 即增量段, 不必全量重拉

门槛注册即用(免费版可用)

数据即查即返, 与数据健康页同源口径(应已就绪交易日按更新时点回落)

限制单次≤100码逐码水位 / 缺省全市场水位; 计量1次=1点

接口说明

数据水位(增量游标):各码(或缺省全市场)日线最新交易日,附应已就绪交易日(与健康页同源口径)。

为 LLM/agent 与定时任务设计:先查水位,只拉 start_date>水位 的增量段,省配额省传输

watermark 落后于 expected_trade_date = 该码尚在当日更新延迟窗口内(别急着拉)

逐码水位一次最多 100 码,更大的股票池分批调用

快速调用

同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。

股票池逐码水位(增量拉取前置)
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

wm = pro.data_watermark(codes="sh600519,sz000001")
for r in wm["rows"]:
    print(r["code"], r["watermark"])   # → 只拉 start_date>水位 的区间
全市场水位
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

wm = pro.data_watermark()
print(wm["market_watermark"], wm["expected_trade_date"])

输入参数

名称类型必填描述
codesstr可选逗号分隔≤100码=逐码水位; 缺省=全市场水位(market_watermark)

返回字段

名称类型描述
expected_trade_datestr应已就绪的最新交易日(未过当日更新时点自动回落上一交易日)
market_watermarkstr全市场最新交易日(codes 缺省时)
rows[].codestr证券代码(归一后, 传 codes 时)
rows[].watermarkstr该码日线最新交易日 YYYY-MM-DD
rows[].stalebooltrue=水位落后于应已就绪日(更新延迟窗口内)

返回数据样例

{
  "expected_trade_date": "2026-11-16",
  "rows": [
    {
      "code": "sh600519",
      "watermark": "2026-11-16"
    },
    {
      "code": "sz000001",
      "watermark": "2026-11-16"
    }
  ],
  "total": 2
}

最佳实践:agent/定时任务增量同步姿势: 本地记住上次水位 → 调本端点 → 只拉 start_date>水位 的区间 → 更新本地水位。expected_trade_date=应已就绪的交易日, watermark 落后于它 = 该码尚在当日更新延迟窗口内(别急着拉)。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。