数据水位(增量游标) 在线试调 →
各码(或缺省全市场)日线最新交易日, 充当增量拉取游标: 以水位为界 start_date>水位 即增量段, 不必全量重拉
接口说明
数据水位(增量游标):各码(或缺省全市场)日线最新交易日,附应已就绪交易日(与健康页同源口径)。
为 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"])
股票池逐码水位(增量拉取前置)
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/market/data_watermark",
headers={"X-API-Key": KEY},
params={"codes": "sh600519,sz000001"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
全市场水位
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/market/data_watermark",
headers={"X-API-Key": KEY},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
股票池逐码水位(增量拉取前置)
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/market/data_watermark?codes=sh600519%2Csz000001"
全市场水位
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/market/data_watermark"
输入参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| codes | str | 可选 | 逗号分隔≤100码=逐码水位; 缺省=全市场水位(market_watermark) |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| expected_trade_date | str | 应已就绪的最新交易日(未过当日更新时点自动回落上一交易日) |
| market_watermark | str | 全市场最新交易日(codes 缺省时) |
| rows[].code | str | 证券代码(归一后, 传 codes 时) |
| rows[].watermark | str | 该码日线最新交易日 YYYY-MM-DD |
| rows[].stale | bool | true=水位落后于应已就绪日(更新延迟窗口内) |
返回数据样例
{
"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 落后于它 = 该码尚在当日更新延迟窗口内(别急着拉)。