分时数据
GET/v1/quote/{symbol}/rt-data获取标的当日分时数据。支持 NORMAL（默认；港股自动包含暗盘）/ FULL（完整含盘前盘后，仅美股）/ PREMARKET / AFTERHOURS（美股盘前盘后）/ HK_DARK（港股暗盘）/ OVERNIGHT（夜盘）。仅当日交易时段，不含跨日历史。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 标的代码，格式 {market}.{code}，如 HK.00700。 |
request_section | string | 查询 | 否 | 交易时段，默认 NORMAL。详见下方 request_section 枚举表。 |
枚举 request_section（交易时段）
| 取值 | 含义 |
|---|---|
| NORMAL | 正常盘中（默认；港股自动含暗盘） |
| FULL | 完整含盘前盘后（仅美股，不含夜盘） |
| PREMARKET | 美股盘前 |
| AFTERHOURS | 美股盘后 |
| HK_DARK | 港股暗盘 |
| OVERNIGHT | 美股夜盘 |
请求示例
bash
curl -s "$ip/v1/quote/HK.00700/rt-data?request_section=NORMAL" \
-H "X-Futu-Client-Nnid: 76879657" | jq响应字段
返回 data.section_list[] + 顶层 data.volume_precision。section_list 每个元素为一个交易时段，含该段元数据 + 该段分钟级数据点列表。
顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
| volume_precision | int | 成交量精度 n。后端将每个 point 的 volume 放大 10^n；普通股票通常为 0，事件合约 / 部分高精度品类非 0 |
section_list[] 通用字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 标的代码，例 HK.00700 |
| name | string | 股票名称，例 腾讯控股 |
| trade_section | string | 交易时段类型（按市场细分），详见下方 trade_section 枚举 |
| last_close | float | 该段昨收/参考对比价（用于该段涨跌计算） |
| point_list | array | 该段分钟数据点数组 |
point_list[] 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| time | int | 数据点时间，毫秒时间戳 |
| open | float | 开盘价 |
| high | float | 最高价 |
| low | float | 最低价 |
| cur_price | float | 当前价（该分钟收盘价） |
| volume | int | 成交量（已按 volume_precision 放大；按需除以 10^volume_precision 还原） |
| turnover | float | 成交额 |
枚举 trade_section（交易时段类型）
| 取值 | 含义 |
|---|---|
| AUCTION | 港股竞价时段 |
| MORNING | 港股上午时段 |
| AFTERNOON | 港股下午时段 |
| NIGHT | 夜市 |
| US_PREMARKET | 美股盘前 |
| US_AFTERHOURS | 美股盘后 |
| HK_DARK | 港股暗盘 |
| FUT_PART1 | 期货第一时段 |
| FUT_PART2 | 期货第二时段 |
| STIB_AFTERHOURS | 科创板盘后 |
| US_OVERNIGHT | 美股夜盘 |
| US_REGULAR | 美股常规交易时段 |
| DEFAULT | 默认（一般市场） |
| REGULAR | 常规交易时段 |
| US_INDEX_OPT_REGULAR | 美股指数期权常规 |
| US_INDEX_OPT_GLOBAL | 美股指数期权全球 |
| US_INDEX_OPT_CURB | 美股指数期权 CURB |
| JP_INDEX_OPT_NIGHT | 日股指数期权夜盘 |
| JP_INDEX_OPT_REGULAR | 日股指数期权常规 |
| KR_REGULAR | 韩股常规 |
| KR_PREMARKET | 韩股盘前 |
| KR_AFTERHOURS | 韩股盘后 |
限制范围
- 支持市场：HK / US / SH / SZ / JP / SG / AU 等。
- 支持品类：正股、ETF、期货、期权、指数等。优先股 / SPAC / 可转债 / 牛熊证等不支持品类返回空。
- 当日交易时段内有效；非交易日 / 未订阅 / 不支持品类时返回空 section_list。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功（含未订阅 / 非交易时段 / 不支持品类返回空 section_list） | — |
| -3 | invalid_parameter | 缺 symbol / request_section 不在合法枚举内 | 校正请求参数后重试 |
| -4 | internal_error | 网关构造后端请求失败（含标的代码无法解析为已知证券） | 检查市场前缀是否在限制范围内；通过 search 接口确认代码合法性 |
| -5 | internal_error | 后端调用失败（网络 / 超时） | 重试；持续失败请联系网关侧 |
| -6 | internal_error | 网关响应转换失败 | 重试；持续失败请联系网关侧 |
| >0 | backend_biz_error | 后端业务错误透传（无权限、风控、限频等） | 按 ret_msg 文案判断；权限类错误请确认账号已开通对应市场实时行情 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"section_list": [
{
"code": "HK.00700",
"name": "腾讯控股",
"trade_section": "MORNING",
"last_close": 481.6,
"point_list": [
{ "time": 1780450200000, "open": 484, "high": 484, "low": 484, "cur_price": 484, "volume": 1355500, "turnover": 656062000 }
]
},
{
"code": "HK.00700",
"name": "腾讯控股",
"trade_section": "AFTERNOON",
"last_close": 481.6,
"point_list": []
}
],
"volume_precision": 0
}
}