市场状态

POST /v1/quote/market-state

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

请求参数

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

请求示例

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

响应字段

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

字段	类型	说明
code	string	股票代码，例 HK.00700，原样回填请求中的 code
stock_name	string	股票名称（来源于网关本地证券缓存）；未支持市场或暂未入库时缺省
market_state	string	市场状态枚举（字符串），详见命名词典 > market_state
time_date	string	该市场对应的交易日，格式 YYYY-MM-DD HH:MM:SS（北京时区）。后端不下发时省略
traded_seconds	int	当前交易时段已交易时长（秒）。后端不下发时省略
total_seconds	int	当前交易时段总时长（秒）。后端不下发时省略
trade_section	array	该市场当日的交易时段切片，元素含 trade_section_type（int，详见命名词典 > trade_section_type）、begin_time / end_time（北京时区 HH:MM:SS）。后端不下发时省略
broker_id	int	仅数字货币 + is_need_crypto_multi_broker=true 时下发；标识该条数据所属券商
broker_ids	int[]	数字货币综合行情时下发，列出该 market_id 下的全部券商 id

限制范围

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

错误码

ret_code	error.code	触发条件	处理建议
0	—	请求成功，data.market_state_list 长度等于请求 code_list 长度	遍历 market_state_list，按 code 对齐自己请求的标的
-3	invalid_parameter	code_list 缺失 / 元素类型非 string / 列表为空 / 长度超 400 / 元素未带市场前缀	修正请求体，补足 {market}.{code} 格式
-5	backend_biz_error	QTA 后端返回非零业务错误（罕见）	读取 error.message 排查；可重试
-2 / -4 / -6	internal_error	网关自身路由 / body 构造 / response 转换异常	留存 x-trace-id 反馈给网关方

响应示例

{
  "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": "平安银行" }
    ]
  }
}