Skip to content

Real-time Ticker ​

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

Get tick-by-tick trade data for a symbol. Returns the latest N trade details, including price, volume, buy/sell direction, trade type and session.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesStock symbol (path parameter), format {market}.{code}, e.g. HK.00700 / US.AAPL Max length 128; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
numintquerynoReturn the latest N tick trades, default 500, range 1~750 ≥ 1; ≤ 750; Default 500
periodstring[]querynoOptional; filter ticks by session; repeat the key, e.g. ?period=BEFORE&period=AFTER. NORMAL=regular / BEFORE=pre-market / AFTER=after-hours / OVERNIGHT=overnight Max items 4; Values NORMAL, BEFORE, AFTER, OVERNIGHT

Request Example ​

bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/HK.00700/rt-ticker?num=3" \
  -H "Authorization: Bearer <AccessToken>" | jq

Response Fields ​

Returns top-level fields + ticker_list array + volume_precision.

Top-level Fields ​

NameTypeDescription
dataobject
data.last_closenumber
data.codestring
data.namestring
data.sc_namestring
data.tc_namestring
data.ticker_listobject[]
data.ticker_list[].sequenceint
data.ticker_list[].timeint
data.ticker_list[].pricenumberTrade price. Event-contract YES uses price, NO uses price_ex
data.ticker_list[].volumenumberTrade volume. Integer shares for stocks; real size for event contracts and perpetuals, may be fractional.
data.ticker_list[].turnovernumberTurnover. Stock turnover, or the real value for event contracts and perpetuals.
data.ticker_list[].ticker_directionstring
data.ticker_list[].pred_sidestringEvent-contract tick side. NONE for the contract itself or other instruments; YES or NO for the side. Not buy/sell
data.ticker_list[].tick_typestringTick trade matching type. Full 32 values; common: AUTO_MATCH / NON_AUTO_MATCH / ODD_LOT / AUCTION / BULK / OVERSEAS etc.
data.ticker_list[].period_typestringTick session. NORMAL=regular / BEFORE=pre-market / AFTER=after-hours / OVERNIGHT=overnight
data.ticker_list[].trade_typestringExchange trade type (ASCII) for direct display, e.g. US P=Pre-market, T=Form-T, U=Cancel; may be empty for HK/A-share
data.volume_precisionintVolume precision n. Actual volume = volume / 10^n; usually 0 for common stocks, non-zero for event contracts / perpetuals; divide to recover real shares
paginationobjectPagination returned by some endpoints

ticker_list[] Elements ​

FieldTypeDescription
sequenceintTick-by-tick sequence number (int64, monotonically increasing, can be used for dedup / incremental fetch)
timeintTrade time, millisecond timestamp
pricefloatTrade price
volumenumberTrade volume. Share count for stocks; real size for event contracts and perpetuals, may be fractional
turnovernumberTurnover. Real value for event contracts and perpetuals
pred_sidestringEvent-contract side: NONE, YES, or NO. Not buy/sell
ticker_directionstringBuy/sell direction. See ticker_direction enum below
tick_typestringTick-by-tick trade type (trade method). See tick_type enum below
period_typestringSession the tick belongs to. See enum period_type
trade_typestringExchange trade type (ASCII character), display directly in UI, e.g. US P=Pre-market / T=Form-T / U=Cancel; HK / A-shares may be empty

Enum ticker_direction (Buy/sell direction)

ValueMeaning
BUYBuy
SELLSell
NEUTRALNeutral (cannot determine active side)

Enum tick_type (Tick-by-tick trade type)

ValueMeaning
UNKNOWNUnknown
AUTO_MATCHAuto-match trade (most common for HK)
LATELate trade
NON_AUTO_MATCHNon-auto-match trade
ODD_LOTOdd lot trade
AUCTIONAuction trade
BULKBlock trade
OVERSEASOverseas trade
UNAUTO_MATCH_OFFNon-auto-match off-exchange
NON_DIRECT_OFFNon-direct off-exchange
OVERSEAS_OFFOverseas off-exchange
AUTO_MATCH_OFFAuto-match off-exchange
BULK_OFFBlock trade off-exchange
LATE_OFFLate trade off-exchange
AUCTION_OFFAuction off-exchange
ODD_LOT_OFFOdd lot off-exchange
EVENINGEvening trade
ACCEPT_ELECTRONICAccept electronic
OUT_HOUR_CONTRACTAfter-hours contract trade
BANK_CHARGECCASS charge
ELECTRONICElectronic trade
HIGH_DENSITYHigh density trade
INTERMEDIATE_PRICEIntermediate price trade
AT_AUCTIONAt-auction trade
AUCTION_LIMITAuction limit trade
AT_AUCTION_LIMITAt-auction limit
ENHANCE_LIMITEnhanced limit
HOT_QUOTEReal-time quote
MARKETMarket order
ROUND_LOTRound lot
SPECIAL_LOTSpecial lot
ODD_AND_SPECIAL_LOTOdd and special lot

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.
  • Only returns the latest N trades, does not support time range filtering; for historical tick-by-tick data by time range, use other history APIs.

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
-3invalid_parametersymbol format invalid / num out of range / period value not in enumCorrect parameters and retry
-7invalid_symbolsymbol format valid but corresponding security not foundUse search API to confirm code validity
-5internal_errorService errorRetry; if persistent, contact support
positivebackend_biz_errorBusiness error; see the response message for detailsFollow ret_msg instructions; permission issues require enabling the corresponding market

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "code": "HK.00700",
    "name": "TENCENT",
    "sc_name": "腾讯控股",
    "tc_name": "騰訊控股",
    "last_close": 481.6,
    "ticker_list": [
      {
        "sequence": 7647056964060558023,
        "time": 1780469195226,
        "price": 465.8,
        "volume": 100,
        "turnover": 46580,
        "ticker_direction": "SELL",
        "tick_type": "LATE",
        "period_type": "NORMAL",
        "trade_type": " "
      },
      {
        "sequence": 7647056964060558022,
        "time": 1780469195104,
        "price": 465.8,
        "volume": 500,
        "turnover": 232900,
        "ticker_direction": "SELL",
        "tick_type": "LATE",
        "period_type": "NORMAL",
        "trade_type": " "
      },
      {
        "sequence": 7647056964060558021,
        "time": 1780469195062,
        "price": 465.8,
        "volume": 100,
        "turnover": 46580,
        "ticker_direction": "BUY",
        "tick_type": "AUTO_MATCH",
        "period_type": "NORMAL",
        "trade_type": " "
      }
    ],
    "volume_precision": 0
  }
}