查询参数

日期

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

交易日期支持多种查询方式。以 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_yes 查询请求日的上一交易日涨停池,并按请求日补齐竞价、实时和热度字段:

{
  "apiname": "limit_pool_yes",
  "fields": "symbol,name,tradedate,type,pre_limit_times,pre_fd_amount,pre_pct_chg,pre_amount,auc_pct_chg,auc_amt,auc_to_pre_vol_pct,auc_to_pre_auc_vol_ratio,pct_chg_pub,amount_pub,hot_ths_normal_rank",
  "params": {
    "tradedate": "20260430",
    "type": ["u", "ub"],
    "limit": 6000
  }
}