分時數據
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
}
}