2.6 市场状态和交易时间

请求市场的交易状态，交易时间，当前的交易状态，及特殊交易状态。

接口信息

项目	内容
接口路径	/status
请求方法	GET
鉴权	需要
返回格式	JSON

请求参数

参数	位置	类型	必填	实际参数	说明
country	Query	string	是	国家代码，参考 3.8	指定需要查询的国家或地区

请求格式：

/status?country={country}

country 表示国家或地区，不是交易所代码。

返回结构

字段	类型	说明
State	integer	业务状态
Code	integer/string	业务代码
Msg	string	状态说明
data	array	交易所状态和交易时间

市场状态字段

字段	类型	允许为空	说明
market	string	否	交易所代码
timezone	string	否	交易所时区或 UTC 偏移
time	string/array	是	正常交易时段
week	string/array	是	正常交易日
status	integer/string/boolean	是	当前市场状态
special	string/object/null	是	节假日、半日市等特殊交易安排
countdown	integer/string/null	是	距离下一次状态变化的剩余时间

字段名称区分大小写，客户端应按照接口实际返回字段读取。

交易时间

交易时间按照交易所所在地的当地时间返回。

一个交易日可能包含一个或多个交易时段。存在多个时段时，客户端应分别解析，不应将中间间隔计算为正常交易时间。

交易时间可能因以下情况发生变化：

• 法定节假日；
• 半日市；
• 临时休市；
• 夏令时切换；
• 交易所特别安排。

客户端不应在程序中长期固定交易时间，应定期查询并更新。

时区

timezone 表示交易所当前使用的时区或 UTC 偏移。

如果接口返回 UTC 偏移，客户端应注意夏令时可能导致偏移发生变化。不能将某次返回的偏移长期保存为固定时区。

显示交易时间时，应同时保存：

• 交易所代码；
• 当地交易时间；
• 时区或 UTC 偏移；
• 查询时间。

市场状态

客户端应根据接口返回的状态判断当前市场是否处于交易时间。

如果状态字段为空或无法识别，不应默认市场已经开市。应结合交易时段、当地时间和特殊交易安排进行判断。

该接口反映服务端当前配置，不应替代交易所官方交易日历。涉及交易决策时，应同时参考交易所公告。

空数据

返回空数组可能表示：

• 国家代码无效；
• 账号没有该国家或地区的数据权限；
• 当前没有可用的市场状态；
• 服务端暂时没有交易时间数据。

客户端应同时检查业务状态、国家代码和账号权限。

错误处理

情况	客户端处理
未传或错误的访问密钥	检查鉴权信息
缺少 country	补充国家代码
国家代码无效	参考 3.8 核对国家代码
返回空数组	检查国家代码和账号权限
无法识别市场状态	按未知状态处理，不得默认开市
时区或交易时间缺失	不执行依赖交易时间的自动操作

HTTP 状态码为 200 不一定表示业务成功，客户端还需要检查业务状态和返回数据。

使用限制

高频查询时应遵守账号调用额度。

一次请求查询一个国家或地区。

返回内容可能包含该国家或地区下的多个交易所。

市场状态会随时间变化，不应长期缓存。

交易时间和时区应以最新返回数据为准。

正常响应

{
    "status": 0,
    "message": "SUCCESS",                        //状态
    "data": [
        {
            "specialDay": "holiday",             //特殊交易日（假日）
            "current": 0,                        //当前是否正常交易，1是，0否      
            "timezone": "+08:00",                    //交易时区
            "tradingDay": "1,2,3,4,5",           //交易星期几，0表示周日。
            "today": 0,                          //今天是否正常交易，1是，0否
            "tradingTimes": [
                {
                    "closeTime": "12:00:00",     //收盘时间,可能存在多段开收盘时间
                    "openTime": "09:30:00"       //开盘时间,可能存在多段开收盘时间
                },
                {
                    "closeTime": "16:00:00",     //收盘时间,可能存在多段开收盘时间
                    "openTime": "13:00:00"       //开盘时间,可能存在多段开收盘时间
                } 
            ],
            "countdown": 127546,                 //开市倒计时
            "tomorrow": 1,                       //明天是否正常交易，1是，0否
            "exchange": "HKEX",                  //交易所（可能为空）
            "updateTime": 1779678546             //本地更新时间，以天为更新。
        }
    ],
    "total": 0,
    "page": 0,
    "market": null,
    "symbol": null,
    "code": null,
    "interval": null
}