Skip to content

Real-time Data

GET /api/v1.0/quote/{symbol}/rt-data

Get 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

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, format {market}.{code}, e.g. HK.00700.
request_sectionstringquerynoTrading session, default NORMAL. See request_section enum table below.

Enum request_section (Trading session)

ValueMeaning
NORMALRegular session (default; HK automatically includes dark pool)
FULLComplete including pre/post market (US only, excluding night session)
PREMARKETUS pre-market
AFTERHOURSUS after-hours
HK_DARKHK dark pool
OVERNIGHTUS 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" | jq

Response 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

FieldTypeDescription
volume_precisionintVolume 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

FieldTypeDescription
codestringSymbol code, e.g. HK.00700
namestringEnglish name, e.g. TENCENT
sc_namestringSimplified Chinese name, e.g. 腾讯控股
tc_namestringTraditional Chinese name, e.g. 騰訊控股
trade_sectionstringTrading session type (market-specific), see trade_section enum below
last_closefloatPrevious close / reference price for this session (used for change calculation)
point_listarrayMinute-level data points array for this session

point_list[] Fields

FieldTypeDescription
timeintData point time, millisecond timestamp
openfloatOpen price
highfloatHigh price
lowfloatLow price
cur_pricefloatCurrent price (close price at that minute)
volumeintVolume (scaled by volume_precision; divide by 10^volume_precision to restore)
turnoverfloatTurnover amount

Enum trade_section (Trading session type)

ValueMeaning
AUCTIONHK auction session
MORNINGHK morning session
AFTERNOONHK afternoon session
NIGHTNight market
US_PREMARKETUS pre-market
US_AFTERHOURSUS after-hours
HK_DARKHK dark pool
FUT_PART1Futures session 1
FUT_PART2Futures session 2
STIB_AFTERHOURSSTAR Market after-hours
US_OVERNIGHTUS overnight
US_REGULARUS regular trading session
DEFAULTDefault (general markets)
REGULARRegular trading session
US_INDEX_OPT_REGULARUS index option regular
US_INDEX_OPT_GLOBALUS index option global
US_INDEX_OPT_CURBUS index option CURB
JP_INDEX_OPT_NIGHTJapan index option night
JP_INDEX_OPT_REGULARJapan 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:

PrefixMarketSupported Categories
HKHong KongEquity / Trust / REIT / Warrant / CBBC / Inline Warrant / Index / Sector / ETF / Option
USUnited StatesEquity / ETF / Index
SHShanghaiEquity / ETF / Index / Sector
SZShenzhenEquity / ETF / Index / Sector
BJBeijingEquity / Index

Error Codes

ret_codeerror.codeTrigger ConditionRecommended Action
0Success (including unsubscribed / non-trading session / unsupported categories returning empty section_list)
-3invalid_parameterMissing symbol / request_section not in valid enumCorrect request parameters and retry
-4internal_errorGateway 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
-5internal_errorBackend call failed (network / timeout)Retry; if persistent, contact gateway support
-6internal_errorGateway response conversion failedRetry; if persistent, contact gateway support
>0backend_biz_errorBackend 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
  }
}