二、HTTP 行情与 K 线

2.6 市场状态和交易时间

GET/api/status

今天、明天是否交易日，现在是否在交易，交易时段，以及距离下一次开盘或收盘还有多久。

请求

请求头 Authorization：你的密钥（必填）。

参数	是否必填	说明
country	必填	国家，如 america；全部取值见「国家与市场参数」
market	可选	交易所代码；传了就只返回这一个交易所

财务信息那一类的外壳，data 是数组，一个国家的每个交易所一条（america 实际返回：NASDAQ）。

字段	说明
exchange	交易所代码
current	现在是否在交易：1 是，0 否
today / tomorrow	今天、明天是否交易日：1 是，0 否
specialDay	节假日等特殊日的标记，平时为 null
tradingDay	每周哪几天交易，如 1,2,3,4,5 表示周一到周五
tradingTimes	交易时段（交易所当地时间），可能有多段
timezone	交易所时区，如 -04:00
countdown	秒数：休市时是距离下一次开盘，开市时是距离收盘
updateTime	这条状态的更新时间，Unix 秒

说明

交易时间会因节假日、夏令时而变，不要写死在程序里，定期重新查。
这里的状态是参考信息，做交易决定请以交易所公告为准。

错误

HTTP	返回	情况
200	{"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"}	没带 country
200	status=500 No Market or Country!	国家不存在

示例

GET/status?country=america

请求头 Authorization: 你的密钥 · HTTP 200

{
  "status": 0,                      // 0 成功，500 失败
  "message": "SUCCESS",             // 成功为 SUCCESS，失败时是原因
  "data": [                         // 每个交易所一条
    {
      "specialDay": null,           // 节假日等特殊日的标记，平时为 null
      "current": 0,                 // 现在是否在交易：1 是，0 否
      "timezone": "-04:00",         // 交易所时区
      "tradingDay": "1,2,3,4,5",    // 每周哪几天交易，1,2,3,4,5 表示周一到周五
      "today": 1,                   // 今天是否交易日：1 是，0 否
      "tradingTimes": [             // 交易时段（交易所当地时间），可能有多段
        {
          "closeTime": "16:00:00",  // 这一段的结束
          "openTime": "09:30:00"    // 这一段的开始
        }
      ],
      "tomorrow": 1,                // 明天是否交易日：1 是，0 否
      "countdown": 10175,           // 秒数：休市时是距离下一次开盘，开市时是距离收盘
      "exchange": "NASDAQ",         // 交易所代码
      "updateTime": 1791196312      // 这条状态的更新时间，Unix 秒
    }
  ],
  "total": 0,                       // 总条数，分页的接口才有值
  "page": 0,                        // 当前页，分页的接口才有值
  "market": null,                   // 市场代码
  "symbol": null,                   // 产品代码
  "code": null,                     // 产品代码
  "interval": null                  // K 线周期，这类接口不用
}