API REFERENCE

交易日历

基础信息与分类

本分类还包括交易日历、ST 与风险警示历史、名称变更、上市公司主体和北交所新旧代码映射。

以下接口统一使用日线数据权限和 API Key 鉴权。返回数据中,data.fields 为字段顺序,data.items 为按该顺序排列的数据行。

交易日历

POSThttps://jinniu.ziyoutang.com/api/trade_cal

请求示例

curl -X POST 'https://jinniu.ziyoutang.com/api/trade_cal' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"exchange":"BSE","start_date":"20260810","end_date":"20260907","limit":64}'

请求字段

字段必填说明
api_key是个人中心生成的 API Key,也可使用请求头 X-Api-Key。
exchange否交易所:SSE、SZSE 或 BSE。北交所日历覆盖自 20211115 起,按A股共同交易日规则返回。
cal_date否精确日期,格式 YYYYMMDD;填写后只返回该日。
start_date / end_date否日期区间,格式 YYYYMMDD;可单独使用或组合使用。
limit否最大返回行数,1 至 5,000,默认 5,000。
fields否逗号分隔的返回字段;不填则返回全部字段。

返回字段

字段说明
exchange交易所代码。
cal_date日历日期,格式 YYYYMMDD。
is_open是否开市:1 为开市,0 为休市;枚举值,无计量单位。
pretrade_date上一交易日,格式 YYYYMMDD;无上一交易日时为空。

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "fields": ["exchange", "cal_date", "is_open", "pretrade_date"],
    "items": [["BSE", "20260810", 1, "20260807"]]
  }
}