Real-time Data
GET/api/v1.0/quote/{symbol}/rt-dataGet intraday time-sharing data for a symbol. Supports NORMAL (default; HK automatically includes dark pool) / FULL (complete including pre/post market, US only) / PREMARKET / AFTERHOURS (US pre/post market) / HK_DARK (HK dark pool) / OVERNIGHT (night session). Current day trading sessions only, no cross-day history.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Symbol code, format {market}.{code}, e.g. HK.00700. |
request_section | string | query | no | Trading session, default NORMAL. See request_section enum table below. |
Enum request_section (Trading session)
| Value | Meaning |
|---|---|
| NORMAL | Regular session (default; HK automatically includes dark pool) |
| FULL | Complete including pre/post market (US only, excluding night session) |
| PREMARKET | US pre-market |
| AFTERHOURS | US after-hours |
| HK_DARK | HK dark pool |
| OVERNIGHT | US night session |
Request Example
bash
curl -s "https://webapi.moomoo.com/api/v1.0/quote/HK.00700/rt-data?request_section=NORMAL" \
-H "X-Futu-Client-Nnid: 76879657" | jqResponse Fields
Returns data.section_list[] + top-level data.volume_precision. Each section_list element represents one trading session, containing session metadata + minute-level data points.
Top-level Fields
| Field | Type | Description |
|---|---|---|
| volume_precision | int | Volume precision n. Backend scales each point's volume by 10^n; regular stocks are usually 0, event contracts / certain high-precision categories are non-0 |
section_list[] Common Fields
| Field | Type | Description |
|---|---|---|
| code | string | Symbol code, e.g. HK.00700 |
| name | string | English name, e.g. TENCENT |
| sc_name | string | Simplified Chinese name, e.g. 腾讯控股 |
| tc_name | string | Traditional Chinese name, e.g. 騰訊控股 |
| trade_section | string | Trading session type (market-specific), see trade_section enum below |
| last_close | float | Previous close / reference price for this session (used for change calculation) |
| point_list | array | Minute-level data points array for this session |
point_list[] Fields
| Field | Type | Description |
|---|---|---|
| time | int | Data point time, millisecond timestamp |
| open | float | Open price |
| high | float | High price |
| low | float | Low price |
| cur_price | float | Current price (close price at that minute) |
| volume | int | Volume (scaled by volume_precision; divide by 10^volume_precision to restore) |
| turnover | float | Turnover amount |
Enum trade_section (Trading session type)
| Value | Meaning |
|---|---|
| AUCTION | HK auction session |
| MORNING | HK morning session |
| AFTERNOON | HK afternoon session |
| NIGHT | Night market |
| US_PREMARKET | US pre-market |
| US_AFTERHOURS | US after-hours |
| HK_DARK | HK dark pool |
| FUT_PART1 | Futures session 1 |
| FUT_PART2 | Futures session 2 |
| STIB_AFTERHOURS | STAR Market after-hours |
| US_OVERNIGHT | US overnight |
| US_REGULAR | US regular trading session |
| DEFAULT | Default (general markets) |
| REGULAR | Regular trading session |
| US_INDEX_OPT_REGULAR | US index option regular |
| US_INDEX_OPT_GLOBAL | US index option global |
| US_INDEX_OPT_CURB | US index option CURB |
| JP_INDEX_OPT_NIGHT | Japan index option night |
| JP_INDEX_OPT_REGULAR | Japan index option regular |
Supported Markets
- Code must use a supported market prefix from the 5 markets listed below; otherwise returns
invalid_symbol. - Valid only during the current day's trading sessions; returns empty section_list on non-trading days / unsubscribed / unsupported categories.
Supported market prefixes and categories:
| Prefix | Market | Supported Categories |
|---|---|---|
| HK | Hong Kong | Equity / Trust / REIT / Warrant / CBBC / Inline Warrant / Index / Sector / ETF / Option |
| US | United States | Equity / ETF / Index |
| SH | Shanghai | Equity / ETF / Index / Sector |
| SZ | Shenzhen | Equity / ETF / Index / Sector |
| BJ | Beijing | Equity / Index |
Error Codes
| ret_code | error.code | Trigger Condition | Recommended Action |
|---|---|---|---|
| 0 | — | Success (including unsubscribed / non-trading session / unsupported categories returning empty section_list) | — |
| -3 | invalid_parameter | Missing symbol / request_section not in valid enum | Correct request parameters and retry |
| -4 | internal_error | Gateway failed to construct backend request (including symbol code cannot be resolved to a known security) | Check that market prefix is within supported range; use search API to confirm code validity |
| -5 | internal_error | Backend call failed (network / timeout) | Retry; if persistent, contact gateway support |
| -6 | internal_error | Gateway response conversion failed | Retry; if persistent, contact gateway support |
| >0 | backend_biz_error | Backend business error passthrough (no permission, risk control, rate limit, etc.) | Check ret_msg message; for permission errors, confirm the account has the corresponding market real-time quote access enabled |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"section_list": [
{
"code": "HK.00700",
"name": "TENCENT",
"sc_name": "腾讯控股",
"tc_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": "TENCENT",
"sc_name": "腾讯控股",
"tc_name": "騰訊控股",
"trade_section": "AFTERNOON",
"last_close": 481.6,
"point_list": []
}
],
"volume_precision": 0
}
}