查询参数
日期
时间口径与日期范围约定。
交易日期支持多种查询方式。以 daily 为代表的日级接口,后端会按统一规则解析 tradedate、startdate、enddate、recentdays、tradedate_offset。
日期格式
- 日级字段统一使用
YYYYMMDD - 也兼容
YYYY-MM-DD,后端会自动转成YYYYMMDD - 分钟级字段一般拆分为
tradedate和trademin
查询方式
| 传参方式 | 含义 |
|---|---|
不传 tradedate、startdate、enddate | 默认查询最新交易日 |
只传 tradedate | 查询指定交易日 |
只传 startdate | 从 startdate 查到最新交易日 |
同时传 startdate、enddate | 查询日期区间 |
只传 recentdays | 查询最近 N 个交易日覆盖的日期区间 |
只传 tradedate_offset | 查询相对最新交易日偏移后的单日 |
recentdays 会先从交易日历缓存中取最近 N 个交易日,再转换为 startdate 到 enddate 的闭区间。它是区间查询,不是单日偏移。
tradedate_offset 用于表达相对最新交易日的单日查询:0 表示最新交易日,-1 表示上一交易日,-2 表示再往前一个交易日。
参数约束
tradedate不能和startdate、enddate同时传startdate不能大于enddate- 仅传
startdate时,startdate不能大于最新交易日 recentdays不能和tradedate、startdate、enddate同时传tradedate_offset不能和tradedate、startdate、enddate、recentdays同时传tradedate_offset只支持0或负数
示例
1. 不传日期,默认最新交易日
{
"apiname": "daily",
"params": {
"symbols": "000001"
}
}
2. 指定单个交易日
{
"apiname": "daily",
"params": {
"symbols": "000001",
"tradedate": "20260316"
}
}
3. 从开始日期查到最新交易日
{
"apiname": "daily",
"params": {
"symbols": "000001",
"startdate": "20260301"
}
}
4. 区间查询
{
"apiname": "daily",
"params": {
"symbols": "000001",
"startdate": "20260301",
"enddate": "20260316"
}
}
5. 最近 N 个交易日
{
"apiname": "daily",
"params": {
"symbols": "000001",
"recentdays": 10
}
}
6. 交易日偏移
{
"apiname": "daily",
"params": {
"symbols": "000001",
"tradedate_offset": -1
}
}
7. 昨日涨停池 + 今日补充字段
先用 limit_pool 查询上一交易日涨停池:
{
"apiname": "limit_pool",
"fields": "symbol,name,tradedate,type,limit_times,fd_amount,pct_chg,amount",
"params": {
"tradedate_offset": -1,
"type": ["u", "ub"],
"limit": 6000
}
}
再拿返回的 symbol 列表调用 daily 查询最新交易日补充字段,最后在自己的代码里按 symbol 拼接:
{
"apiname": "daily",
"fields": "symbol,tradedate,pct_chg,amount,turnover_rate_f,hot_ths_normal_rank",
"params": {
"tradedate_offset": 0,
"symbols": "000001,000002"
}
}