市场状态
POST/api/v1.0/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. 前缀生效。 |
请求示例
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[],元素字段如下。
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.market_state_list | object[] | |
data.market_state_list[].code | string | |
data.market_state_list[].stock_name | string | |
data.market_state_list[].sc_name | string | |
data.market_state_list[].tc_name | string | |
data.market_state_list[].market_state | string | |
data.market_state_list[].time_date | int | |
data.market_state_list[].traded_seconds | string | |
data.market_state_list[].total_seconds | string | |
data.market_state_list[].trade_section | string | |
data.market_state_list[].broker_id | int | |
data.market_state_list[].broker_ids | string | |
pagination | object | 部分接口返回分页信息 |
限制范围
- 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_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 | 业务错误,详见响应错误信息 | 读取 error.message 排查;可重试 |
| -2 / -4 / -6 | internal_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": "平安银行"
}
]
}
}