市場狀態

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