交易日曆
GET/api/v1.0/quote/trading-days獲取指定市場在 [start, end] 區間內的交易日曆;返回交易日(yyyy-MM-dd)、交易日類型與當日交易總秒數(用於識別半日市等縮短交易)。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
market | string | 查詢 | 是 | 市場前綴,詳見命名詞典 > market。交易日曆還可傳 BJ、JP_FUTURE、SG_FUTURE、BMD、FX |
start | string | 查詢 | 是 | 起始日期(含),格式 yyyy-MM-dd,例:2026-04-22 |
end | string | 查詢 | 是 | 結束日期(含),格式 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[],每元素一天交易日。已過濾非交易日(全天休市、週末、特殊休市假日)。
| 參數 | 類型 | 説明 |
|---|---|---|
data | object | |
data.trading_days | object[] | |
data.trading_days[].time | string | 交易日,格式 yyyy-MM-dd,例: 2026-05-22 |
data.trading_days[].trade_date_type | string | 交易日類型,取值: WHOLE(全天交易)/ MORNING(僅上午)/ AFTERNOON(僅下午) |
data.trading_days[].trade_second | int | 當日交易總秒數;用於識別半日市等縮短交易(如 HK 聖誕前夕約 14400s) |
pagination | object | 部分接口返回分頁信息 |
限制範圍
- 市場:HK / US / SH / SZ / BJ / SG / JP / KR / 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 | 服務錯誤 | 重試;持續失敗請聯繫支持 |
響應示例
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
}
]
}
}