查询参数

日期

时间口径与日期范围约定。

交易日期支持多种查询方式。以 daily 为代表的日级接口,后端会按统一规则解析 tradedatestartdateenddaterecentdaystradedate_offset

日期格式

  • 日级字段统一使用 YYYYMMDD
  • 也兼容 YYYY-MM-DD,后端会自动转成 YYYYMMDD
  • 分钟级字段一般拆分为 tradedatetrademin

查询方式

传参方式含义
不传 tradedatestartdateenddate默认查询最新交易日
只传 tradedate查询指定交易日
只传 startdatestartdate 查到最新交易日
同时传 startdateenddate查询日期区间
只传 recentdays查询最近 N 个交易日覆盖的日期区间
只传 tradedate_offset查询相对最新交易日偏移后的单日

recentdays 会先从交易日历缓存中取最近 N 个交易日,再转换为 startdateenddate 的闭区间。它是区间查询,不是单日偏移。

tradedate_offset 用于表达相对最新交易日的单日查询:0 表示最新交易日,-1 表示上一交易日,-2 表示再往前一个交易日。

参数约束

  • tradedate 不能和 startdateenddate 同时传
  • startdate 不能大于 enddate
  • 仅传 startdate 时,startdate 不能大于最新交易日
  • recentdays 不能和 tradedatestartdateenddate 同时传
  • tradedate_offset 不能和 tradedatestartdateenddaterecentdays 同时传
  • 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"
  }
}