Skip to content

交易日历 ​

GET /api/v1.0/quote/trading-days

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

请求参数 ​

参数类型位置必填说明
marketstring查询是市场前缀,详见命名词典 > market。交易日历还可传 BJ、JP_FUTURE、SG_FUTURE、BMD、FX
startstring查询是起始日期(含),格式 yyyy-MM-dd,例:2026-04-22
endstring查询是结束日期(含),格式 yyyy-MM-dd,例:2026-05-22;要求 end >= start

请求示例 ​

bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/trading-days?market=HK&start=2025-12-22&end=2025-12-26" | jq

响应字段 ​

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

参数类型说明
dataobject
data.trading_daysobject[]
data.trading_days[].timestring交易日,格式 yyyy-MM-dd,例: 2026-05-22
data.trading_days[].trade_date_typestring交易日类型,取值: WHOLE(全天交易)/ MORNING(仅上午)/ AFTERNOON(仅下午)
data.trading_days[].trade_secondint当日交易总秒数;用于识别半日市等缩短交易(如 HK 圣诞前夕约 14400s)
paginationobject部分接口返回分页信息

限制范围 ​

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

错误码 ​

ret_codeerror.code触发条件处理建议
-3invalid_parameter缺 market/start/end;market 不在枚举内;start/end 不符合 yyyy-MM-dd;start > end校正参数后重试
-4 / -6internal_error服务错误重试;持续失败请联系支持

响应示例 ​

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