逐筆成交
GET/v1/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 "$ip/v1/quote/HK.00700/rt-ticker?num=3" \
-H "X-Futu-Client-Nnid: 76879657" | jq響應字段
返回結構：外層字段 + ticker_list 數組 + volume_precision。
外層字段
| 字段 | 類型 | 說明 |
|---|---|---|
| code | string | 標的代碼 |
| 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 | 碎股與特殊手數 |
限制範圍
- 支持市場：HK / US / SH / SZ / SG / JP / AU / CA / MY / FX / 加密幣 等全部主流市場。
- 支持品類：正股 / ETF / 指數 / 窩輪 / 期權 / 期貨 / 板塊指數 等；停牌或當日無成交時返回空數組。
- 僅返回最新 N 筆成交，不支持時間區間篩選；按時間區間拉歷史逐筆請用其他歷史接口。
錯誤碼
| 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": "腾讯控股",
"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
}
}