> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/rest-api/basic-info/get-market-trading-days.md). # GET获取市场的交易日信息 ## 接口说明 该接口是获取不同市场的交易日信息，包含全天交易日以及半天交易日 ## 请求频率 跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](/getting-started/api-limitation.md) ## 错误码说明 参考[HTTP错误码说明](/getting-started/error-codes/http.md) ## 股票市场 ### 接口地址 * 基本路径：`/common/basic/markets/trading_days` * 完整路径：`https://data.infoway.io /common/basic/markets/trading_days` ### 请求头 | 参数 | 类型 | 必填 | 描述 | | -------- | ------ | -- | ------------ | | `apiKey` | String | 是 | 您套餐中的API Key | ### Request param入参说明
参数名类型必填描述示例值
marketString是市场US, HK, CN, JP, IN, KS
beginDayString是开始日期，使用 YYYYMMDD 格式20230101
endDayString是结束时间，使用 YYYYMMDD 格式20230301
### 返回示例 ```json { "ret": 200, "msg": "success", "traceId": "46fbf427-a30e-48ff-8760-9fb20025c667", "data": { "trade_days": [ "20230221", "20230222", "20230223", "20230224", "20230227", "20230228", "20230301" ], "half_trade_days": [] } } ``` | 字段名 | 类型 | 必填 | 描述 | 示例值 | | ----------------- | ---- | -- | ------------------- | ---------- | | `trade_days` | List | 否 | 交易日，使用 `YYYMMDD` 格式 | `20230101` | | `half_trade_days` | List | 否 | 半日市，使用 `YYYMMDD` 格式 | `20230101` | ## 其他市场 ### 接口地址 * 基本路径：`/common/basic/markets/trading_schedule` * 完整路径：`https://data.infoway.io /common/basic/markets/trading_schedule` ### 请求头 | 参数 | 类型 | 必填 | 描述 | | -------- | ------ | -- | ------------ | | `apiKey` | String | 是 | 您套餐中的API Key | ### Request param入参说明
参数名类型必填描述示例值
typeString否类型（不传查所有）ENERGY, FOREX, FUTURES, METAL，INDICES
### 返回示例 ```json { "ret": 200, "msg": "success", "traceId": "9ae7a566-0a08-4ecb-b0ed-da0d90c1e88c", "data": [ { "symbol": "XAGEUR", "type": "METAL", "name": "白银/欧元", "timezone": "America/New_York", "session": "1700-1700", "holidays": { "summary": "", "dates": [] }, "symbol_code": "OANDA:XAGEUR", "is_24_7": false, "trading_hours": { "summary": "（GMT 0）\n夏令时（每年3月第2个周日开始）周日至周五（连续 24 小时）\n冬令时（每年11月第1个周日开始）周日至周五（连续 24 小时）\nSummer Time (from the 2nd Sunday of March) Sunday-Friday (24h continuous)\nWinter Time (from the 1st Sunday of November) Sunday-Friday (24h continuous)", "segments": [ { "days": "周日至周五", "overnight": true, "gmt0": { "summer": { "start": "21:00", "end": "21:00" }, "winter": { "start": "22:00", "end": "22:00" } }, "days_en": "Sunday-Friday", "continuous_24h": true, "native": { "start": "17:00", "end": "17:00" } } ], "is_dst": true }, "break_time": { "summary": "", "windows": [] } } ] } ``` | 字段名 | 类型 | 必填 | 描述 | 示例 | | --------------- | ------- | -- | ----------------------------- | -------------------- | | `symbol` | string | 是 | 交易品种代码（不含数据源前缀） | `"XAGEUR"` | | `type` | string | 是 | 品种类别（METAL/FX/STOCK 等） | `"METAL"` | | `name` | string | 是 | 品种名称 | `"白银/欧元"` | | `timezone` | string | 是 | 品种原生报价所采用的时区（IANA 时区名） | `"America/New_York"` | | `session` | string | 是 | 原生交易时段区间，格式 `HHMM-HHMM` | `"1700-1700"` | | `holidays` | object | 是 | 休市（节假日）信息容器 | 见 二、holidays | | `symbol_code` | string | 是 | 含数据源前缀的完整品种标识（TradingView 格式） | `"OANDA:XAGEUR"` | | `is_24_7` | boolean | 是 | 是否为 7×24 小时不间断交易品种 | `false` | | `trading_hours` | object | 是 | 交易时段信息容器 | 见 三、trading\_hours | | `break_time` | object | 否 | 盘中休息（集合竞价/午休）窗口容器 | 见 四、break\_time | ### holidays | 字段名 | 类型 | 必填 | 描述 | 示例 | | ------------------ | -------------- | -- | ---------------------------------- | ---- | | `holidays.summary` | string | 否 | 休市说明的简短文字（无休市时为空串） | `""` | | `holidays.dates` | array\ | 否 | 休市日期列表（通常为 `YYYY-MM-DD` 或 `MM/DD`） | `[]` | ### trading\_hours | 字段名 | 类型 | 必填 | 描述 | 示例 | | ------------------------ | -------------- | -- | -------------------- | ----------------- | | `trading_hours.summary` | string | 否 | 交易时段的中文/英文汇总说明（多行文本） | `"（GMT 0）\n夏令时…"` | | `trading_hours.segments` | array\ | 是 | 交易时段分段列表，每段描述一组交易日规则 | 见 五、segments\[] | | `trading_hours.is_dst` | boolean | 是 | 当前是否处于夏令时（影响显示与计算） | `true` | ### break\_time | 字段名 | 类型 | 必填 | 描述 | 示例 | | -------------------- | -------------- | -- | --------------------------- | ---- | | `break_time.summary` | string | 否 | 盘中休息说明文字（无休息时为空串） | `""` | | `break_time.windows` | array\ | 否 | 盘中休息时段列表（结构与 `segments` 类似） | `[]` | ### trading\_hours.segments\[] 每个数组元素描述一组交易日规则： | 字段名 | 类型 | 必填 | 描述 | 示例 | | ------------------------------ | ------- | -- | ------------------------ | -------------------------------------- | | `segments[].days` | string | 是 | 该分段适用的交易星期（中文） | `"周日至周五"` | | `segments[].days_en` | string | 否 | 适用的交易星期（英文） | `"Sunday-Friday"` | | `segments[].overnight` | boolean | 是 | 是否跨夜（结束时间在次日） | `true` | | `segments[].continuous_24h` | boolean | 否 | 是否为连续 24 小时交易 | `true` | | `segments[].native` | object | 否 | 原生时区下的起止时间容器 | `{ "start": "17:00", "end": "17:00" }` | | `segments[].native.start` | string | 否 | 原生时区开盘时间 `HH:MM` | `"17:00"` | | `segments[].native.end` | string | 否 | 原生时区收盘时间 `HH:MM` | `"17:00"` | | `segments[].gmt0` | object | 是 | GMT 0 时区下的起止时间容器（分夏/冬令时） | `{ "summer": {...}, "winter": {...} }` | | `segments[].gmt0.summer` | object | 否 | 夏令时下 GMT 0 的起止时间 | `{ "start": "21:00", "end": "21:00" }` | | `segments[].gmt0.summer.start` | string | 否 | 夏令时 GMT 0 开盘 `HH:MM` | `"21:00"` | | `segments[].gmt0.summer.end` | string | 否 | 夏令时 GMT 0 收盘 `HH:MM` | `"21:00"` | | `segments[].gmt0.winter` | object | 否 | 冬令时下 GMT 0 的起止时间 | `{ "start": "22:00", "end": "22:00" }` | | `segments[].gmt0.winter.start` | string | 否 | 冬令时 GMT 0 开盘 `HH:MM` | `"22:00"` | | `segments[].gmt0.winter.end` | string | 否 | 冬令时 GMT 0 收盘 `HH:MM` | `"22:00"` |