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.futunn.com/api/v1.0/quote/HK.00700/rt-data?request_section=NORMAL" \
  -H "Authorization: Bearer <AccessToken>" | 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 ​

NameTypeDescription
dataobject
data.section_listobject[]
data.section_list[].codestringStock symbol, e.g. HK.00700
data.section_list[].namestringStock English name
data.section_list[].sc_namestringStock Simplified Chinese name
data.section_list[].tc_namestringStock Traditional Chinese name
data.section_list[].trade_sectionstringTrade session type (per market), e.g. MORNING
data.section_list[].last_closenumberPer-section previous-close / reference price for change calculation, e.g. 124.5
data.section_list[].point_listobject[]
data.section_list[].point_list[].timeintPoint time, millisecond timestamp, e.g. 1779249600000
data.section_list[].point_list[].opennumberOpen price, e.g. 124.12
data.section_list[].point_list[].highnumberHighest price, e.g. 127.45
data.section_list[].point_list[].lownumberLowest price, e.g. 122.7
data.section_list[].point_list[].cur_pricenumberCurrent price (close price of the minute), e.g. 124.72
data.section_list[].point_list[].volumeintVolume (scaled by 10^volume_precision; divide to recover real shares), e.g. 2960896
data.section_list[].point_list[].turnovernumberTurnover, e.g. 370529897
data.volume_precisionintVolume precision n. Actual volume = volume / 10^n; usually 0 for common stocks, non-zero for event contracts / high-precision instruments
paginationobjectPagination returned by some endpoints

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 market prefix supported by the API and your quote entitlements; the table below lists common markets, and other registered prefixes may also be supported. Otherwise, the API returns invalid_symbol.
  • Valid only during the current day's trading sessions; returns empty section_list on non-trading days / unsubscribed / unsupported categories.

Common 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
KRKoreaEquity / ETF / Index

Error Codes ​

ret_codeerror.codeTrigger ConditionRecommended Action
0—Success (including unsubscribed / non-trading session / unsupported categories returning empty section_list)—
-3invalid_parameterMissing symbol / request_section not in valid enumCorrect request parameters and retry
-4 / -5 / -6internal_errorService errorRetry; if persistent, contact support
>0backend_biz_errorBusiness error; see the response message for detailsCheck 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
  }
}