交易日历

GET /v1/quote/trading-days

获取指定市场在 [start, end] 区间内的交易日历；返回交易日（yyyy-MM-dd）、交易日类型与当日交易总秒数（用于识别半日市等缩短交易）。

请求参数

参数	类型	位置	必填	说明
market	string	查询	是	市场前缀，详见命名词典 > market
start	string	查询	是	起始日期（含），格式 yyyy-MM-dd，例：2026-04-22
end	string	查询	是	结束日期（含），格式 yyyy-MM-dd，例：2026-05-22；要求 end >= start

请求示例

curl -s "$ip/v1/quote/trading-days?market=HK&start=2025-12-22&end=2025-12-26" | jq

响应字段

返回 data.trading_days[]，每元素一天交易日。已过滤非交易日（全天休市、周末、特殊休市假日）。

字段	类型	说明
time	string	交易日，格式 yyyy-MM-dd
trade_date_type	string	交易日类型，详见命名词典 > trade_date_type
trade_second	int	当日交易总秒数；用于识别半日市等缩短交易（例：HK 圣诞前夕约 9000s）

限制范围

• 市场：HK / US / SH / SZ / BJ / SG / JP / CA / AU / JP_FUTURE / SG_FUTURE
• 不区分品类（按市场返回该市场交易日历）
• start 与 end 均含端点；隐式过滤全天休市、周末、特殊节假日

错误码

ret_code	error.code	触发条件	处理建议
-3	invalid_parameter	缺 market/start/end；market 不在枚举内；start/end 不符合 yyyy-MM-dd；start > end	校正参数后重试
-4 / -6	internal_error	网关内部错误（构造请求 / 响应转换失败）	重试；持续失败请联系支持

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "trading_days": [
      {"time": "2025-12-22", "trade_date_type": "WHOLE",   "trade_second": 19800},
      {"time": "2025-12-23", "trade_date_type": "WHOLE",   "trade_second": 19800},
      {"time": "2025-12-24", "trade_date_type": "MORNING", "trade_second": 9000}
    ]
  }
}