Skip to content

市场状态 ​

POST /api/v1.0/quote/market-state

批量获取股票所属市场的当前交易状态(开盘 / 休市 / 盘前 / 盘后 / 夜盘 / 收盘竞价等)。

请求参数 ​

参数类型位置必填说明
code_liststring[]请求体是股票代码列表,元素格式 {market}.{code},例 ["HK.00700","US.AAPL","SH.600519"]。必须显式带市场前缀。单批最多 400 个。
is_contain_babool请求体否是否包含美股盘前 / 盘后时段;true 表示一旦盘前或盘后开始就把 trade_section 切换到下一交易日的时间表。默认 false。仅美股相关项生效。
is_contain_overnightbool请求体否是否包含美股夜盘时段;true 表示夜盘开始后把 trade_section 切换到下一交易日的时间表。默认 false。仅美股相关项生效。
is_need_crypto_multi_brokerbool请求体否数字货币市场是否返回多券商数据;true 时同一 market_id 会按券商展开多条记录。默认 false。仅 CC. 前缀生效。

请求示例 ​

bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/quote/market-state" \
  -H "Content-Type: application/json" \
  -d '{"code_list":["HK.00700","US.AAPL","SH.600519","SZ.000001"]}' | jq

响应字段 ​

返回 data.market_state_list[],元素字段如下。

参数类型说明
dataobject
data.market_state_listobject[]
data.market_state_list[].codestring
data.market_state_list[].stock_namestring
data.market_state_list[].sc_namestring
data.market_state_list[].tc_namestring
data.market_state_list[].market_statestring
data.market_state_list[].time_dateint
data.market_state_list[].traded_secondsstring
data.market_state_list[].total_secondsstring
data.market_state_list[].trade_sectionstring
data.market_state_list[].broker_idint
data.market_state_list[].broker_idsstring
paginationobject部分接口返回分页信息

限制范围 ​

  • code 必须是已开通行情前缀必须落在下列 12 个市场内,否则返回 invalid_symbol:HK(港股)/ US(美股)/ SH(沪市 A 股)/ SZ(深市 A 股)/ BJ(北交所)/ SG(新加坡)/ JP(日本)/ KR(韩国)/ CA(加拿大)/ AU(澳大利亚)/ SH_FX(沪深外汇)/ CC(数字货币)。
  • 不支持的市场前缀(不限于):DE 德国、FR 法国、GB 英国、MY 马来西亚、TH 泰国、ID 印尼、VN 越南、NZ 新西兰、NL 荷兰、PT 葡萄牙、IT 意大利。
  • 遇到不支持市场:对应项保留请求中的 code,market_state 回 "NONE",扩展字段省略;不影响同批次其它合法标的。
  • 单批 code_list 长度上限 400;超出或为空数组返回 invalid_parameter。
  • 调用方必须显式带市场前缀,缺前缀(如 "00700")触发 invalid_parameter。

错误码 ​

ret_codeerror.code触发条件处理建议
0—请求成功,data.market_state_list 长度等于请求 code_list 长度遍历 market_state_list,按 code 对齐自己请求的标的
-3invalid_parametercode_list 缺失 / 元素类型非 string / 列表为空 / 长度超 400 / 元素未带市场前缀修正请求体,补足 {market}.{code} 格式
-5backend_biz_error业务错误,详见响应错误信息读取 error.message 排查;可重试
-2 / -4 / -6internal_error服务错误留存 x-trace-id 反馈给技术支持

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "market_state_list": [
      {
        "code": "HK.00700",
        "market_state": "AFTERNOON",
        "stock_name": "腾讯控股"
      },
      {
        "code": "US.AAPL",
        "market_state": "AFTER_HOURS_END",
        "stock_name": "苹果"
      },
      {
        "code": "SH.600519",
        "market_state": "AFTERNOON",
        "stock_name": "贵州茅台"
      },
      {
        "code": "SZ.000001",
        "market_state": "AFTERNOON",
        "stock_name": "平安银行"
      }
    ]
  }
}