Trading Days
GET/api/v1.0/quote/trading-daysGet the trading calendar for a specified market within a date range.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
market | string | query | yes | Market code. See Naming Dictionary. Trading days also accept BJ, JP_FUTURE, SG_FUTURE, BMD, FX. |
start | string | query | yes | Start date (yyyy-MM-dd). |
end | string | query | yes | End 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' | jqResponse Fields
Returns data.trading_days[], one element per trading day. Non-trading days (full-day closures, weekends, special holidays) are filtered out.
| Name | Type | Description |
|---|---|---|
data | object | |
data.trading_days | object[] | |
data.trading_days[].time | string | Trading day, format yyyy-MM-dd, e.g. 2026-05-22 |
data.trading_days[].trade_date_type | string | Trading day type. Values: WHOLE (full day) / MORNING (morning only) / AFTERNOON (afternoon only) |
data.trading_days[].trade_second | int | Total trading seconds of the day; useful to detect half-day sessions (e.g. HK Christmas Eve ~14400s) |
pagination | object | Pagination 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_code | error.code | Trigger Condition | Recommended Action |
|---|---|---|---|
| -3 | invalid_parameter | Missing market/start/end; market not in enum; start/end not in yyyy-MM-dd format; start > end | Correct parameters and retry |
| -4 / -6 | internal_error | Service error | Retry; 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
}
]
}
}