Skip to content

Trading Days ​

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

Get the trading calendar for a specified market within a date range.

Parameters ​

NameTypeInRequiredDescription
marketstringqueryyesMarket code. See Naming Dictionary. Trading days also accept BJ, JP_FUTURE, SG_FUTURE, BMD, FX.
startstringqueryyesStart date (yyyy-MM-dd).
endstringqueryyesEnd date (yyyy-MM-dd).

Request Example ​

bash
curl 'https://webapi.futunn.com/api/v1.0/quote/trading-days?market=HK&start=2026-04-22&end=2026-05-22' | jq

Response Fields ​

Returns data.trading_days[], one element per trading day. Non-trading days (full-day closures, weekends, special holidays) are filtered out.

NameTypeDescription
dataobject
data.trading_daysobject[]
data.trading_days[].timestringTrading day, format yyyy-MM-dd, e.g. 2026-05-22
data.trading_days[].trade_date_typestringTrading day type. Values: WHOLE (full day) / MORNING (morning only) / AFTERNOON (afternoon only)
data.trading_days[].trade_secondintTotal trading seconds of the day; useful to detect half-day sessions (e.g. HK Christmas Eve ~14400s)
paginationobjectPagination returned by some endpoints

Supported Markets ​

  • Markets: HK / US / SH / SZ / BJ / SG / JP / KR / CA / AU / JP_FUTURE / SG_FUTURE
  • No category distinction (returns the trading calendar for the market as a whole)
  • Both start and end are inclusive; full-day closures, weekends, and special holidays are implicitly filtered

Error Codes ​

ret_codeerror.codeTrigger ConditionRecommended Action
-3invalid_parameterMissing market/start/end; market not in enum; start/end not in yyyy-MM-dd format; start > endCorrect parameters and retry
-4 / -6internal_errorService errorRetry; contact support if persistent

Response Example ​

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
      }
    ]
  }
}