逐筆成交

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

獲取標的的逐筆成交數據。返回最新 N 筆成交明細，包含價格、量、買賣方向、成交類型與所在時段。

請求參數

參數	類型	位置	必填	說明
`symbol`	string	路徑	是	標的代碼，如 `HK.00700`。
`num`	int	查詢	否	返回條數，默認 `500`，範圍 `1~750`。
`period`	string[]	查詢	否	按時段過濾；同名多值傳入，如 `?period=BEFORE&period=AFTER`；不傳=全部時段。詳見枚舉對照表 period_type

請求示例

bash

curl -s "https://webapi.moomoo.com/api/v1.0/quote/HK.00700/rt-ticker?num=3" \
  -H "X-Futu-Client-Nnid: 76879657" | jq

響應字段

返回結構：外層字段 + ticker_list 數組 + volume_precision。

外層字段

字段	類型	說明
code	string	標的代碼
name	string	英文名
sc_name	string	簡體中文名
tc_name	string	繁體中文名
last_close	float	昨收價（便於客戶端計算漲跌）
volume_precision	int	成交量精度 n。後端將每個 ticker 的 volume 放大 10^n；普通股票通常為 0，事件合約 / 永續合約等高精度品類非 0；調用方按需除以 10^n 還原

ticker_list[] 元素

字段	類型	說明
sequence	int	逐筆成交序號（int64，單調遞增可用於去重 / 增量拉取）
time	int	成交時間，毫秒時間戳
price	float	成交價
volume	int	成交量（按 `volume_precision` 還原）
turnover	float	成交額
ticker_direction	string	買賣方向。詳見下方 ticker_direction 枚舉表
tick_type	string	逐筆成交類型（交易方式）。詳見下方 tick_type 枚舉表
period_type	string	逐筆所在時段。詳見枚舉對照表 period_type
trade_type	string	交易所成交類型（ASCII 字符），UI 直接展示，如美股 `P`=Pre-market / `T`=Form-T / `U`=Cancel；港股 / A 股可能為空

枚舉 ticker_direction（買賣方向）

取值	含義
BUY	買盤
SELL	賣盤
NEUTRAL	中性盤（無法判定主動方向）

枚舉 tick_type（逐筆成交類型）

取值	含義
UNKNOWN	未知
AUTO_MATCH	自動對盤成交（港股最常見）
LATE	後期成交
NON_AUTO_MATCH	非自動對盤成交
ODD_LOT	碎股成交
AUCTION	競價成交
BULK	大宗交易
OVERSEAS	海外成交
UNAUTO_MATCH_OFF	非自動對盤買賣盤外
NON_DIRECT_OFF	非直接成交（場外）
OVERSEAS_OFF	海外成交（場外）
AUTO_MATCH_OFF	自動對盤成交（場外）
BULK_OFF	大宗交易（場外）
LATE_OFF	後期成交（場外）
AUCTION_OFF	競價成交（場外）
ODD_LOT_OFF	碎股成交（場外）
EVENING	夜市成交
ACCEPT_ELECTRONIC	接受電子盤
OUT_HOUR_CONTRACT	收盤後合約成交
BANK_CHARGE	中央結算系統收費
ELECTRONIC	電子交易
HIGH_DENSITY	高密度交易
INTERMEDIATE_PRICE	中間價交易
AT_AUCTION	競價交易
AUCTION_LIMIT	競價限價交易
AT_AUCTION_LIMIT	競價限價
ENHANCE_LIMIT	增強限價
HOT_QUOTE	實時報價
MARKET	市價
ROUND_LOT	整手
SPECIAL_LOT	特殊手數
ODD_AND_SPECIAL_LOT	碎股與特殊手數

限制範圍

code 必須是已開通行情前綴必須落在下表 5 個市場內，否則返回 invalid_symbol。
僅返回最新 N 筆成交，不支持時間區間篩選；按時間區間拉歷史逐筆請用其他歷史接口。

支持的市場前綴與品類：

前綴	市場	支持品類
HK	香港	正股 / 信託 / REIT / 窩輪 / 牛熊證 / 界內證 / 指數 / 板塊 / ETF / 期權
US	美國	正股 / ETF / 指數
SH	上海	正股 / ETF / 指數 / 板塊
SZ	深圳	正股 / ETF / 指數 / 板塊
BJ	北京	正股 / 指數

錯誤碼

ret_code	error.code	觸發條件	處理建議
-3	invalid_parameter	symbol 格式非法 / num 越界 / period 取值不在枚舉內	校正參數後重試
-7	invalid_symbol	symbol 格式合法但查不到對應證券	通過 search 接口確認代碼合法性
-5	internal_error	BFF 構造請求體或調用後端失敗	重試；持續失敗請聯繫網關側
業務正碼	backend_biz_error	後端返回業務錯誤（如未訂閱、權限不足）	按 ret_msg 提示處理；權限類需開通對應市場

響應示例

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
  }
}

逐筆成交 ​

請求參數 ​

請求示例 ​

響應字段 ​

外層字段 ​

ticker_list[] 元素 ​

限制範圍 ​

錯誤碼 ​

響應示例 ​