交易日曆

GET /v1/quote/trading-days

獲取指定市場的交易日曆。

請求參數

參數	類型	位置	必填	說明
market	string	查詢	是	市場代碼，例如 HK、US、SH。詳見命名詞典。
start	string	查詢	是	開始日期（yyyy-MM-dd）。
end	string	查詢	是	結束日期（yyyy-MM-dd）。

請求示例

curl '$ip/v1/quote/trading-days?market=HK&start=2026-04-22&end=2026-05-22' | 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}
    ]
  }
}