命名詞典
交易接口使用的所有枚舉值與數據結構對照表。各接口文檔中的枚舉字段與響應結構均可在此查閱。
trd_side(交易方向)
| 取值 | 含義 |
|---|---|
| NONE | 未知方向 |
| BUY | 買入 |
| SELL | 賣出 |
| SELL_SHORT | 賣空 |
| BUY_BACK | 買回(平空倉) |
order_type(訂單類型)
| 取值 | 含義 |
|---|---|
| NONE | 未知類型 |
| LIMIT | 限價單 |
| MARKET | 市價單 |
| AUCTION | 競價市價單 |
| AUCTION_LIMIT | 競價限價單 |
| STOP | 止損單 |
| STOP_LIMIT | 止損限價單 |
| MARKET_IF_TOUCHED | 觸及市價單 |
| LIMIT_IF_TOUCHED | 觸及限價單 |
| TRAILING_STOP | 跟蹤止損市價單 |
| TRAILING_STOP_LIMIT | 跟蹤止損限價單 |
| TWAP | TWAP 市價算法單 |
| TWAP_LIMIT | TWAP 限價算法單 |
| VWAP | VWAP 市價算法單 |
| VWAP_LIMIT | VWAP 限價算法單 |
| POV | POV 市價算法單(成交量占比) |
| POV_LIMIT | POV 限價算法單 |
| SLICER | Slicer 市價算法單(切片) |
| SLICER_LIMIT | Slicer 限價算法單 |
| PEG | PEG 市價算法單 |
| PEG_LIMIT | PEG 限價算法單 |
| ICEBERG_LIMIT | 冰山限價算法單 |
order_status(訂單狀態)
| 取值 | 含義 |
|---|---|
| NONE | 未知狀態 |
| WAITING_SUBMIT | 等待提交 |
| SUBMITTING | 提交中 |
| SUBMITTED | 已提交(待成交) |
| FILLED_PART | 部分成交(未撤單) |
| FILLED_ALL | 全部成交 |
| CANCELLED_PART | 部分成交,剩餘已撤單 |
| CANCELLED_ALL | 全部撤單,無成交 |
| FAILED | 訂單失敗,被服務端拒絕 |
| DISABLED | 訂單已失效 |
| DELETED | 已刪除,僅未成交訂單可刪除 |
trd_market(交易市場)
| 取值 | 含義 |
|---|---|
| NONE | 未知市場 |
| HK | 港股市場 |
| US | 美股市場 |
| SG | 新加坡市場 |
| HKCC | A股通市場 |
| CA | 加拿大市場 |
| FUTURES | 期貨市場 |
| JP | 日本市場 |
| KR | 韓國市場 |
| MY | 馬來西亞市場 |
| AU | 澳大利亞市場 |
| FOREX | 外匯市場 |
| PREDICTION | 預測市場(事件合約) |
exchange(交易所)
| 取值 | 含義 |
|---|---|
| US | 美國交易所 |
| SEHK | 香港聯合交易所 |
| SGX | 新加坡交易所 |
| SSE | 上海證券交易所(滬港通) |
| SZSE | 深圳證券交易所(深港通) |
| JP | 日本交易所 |
| CA | 加拿大交易所 |
| CME | 芝加哥商品交易所 |
| CBOT | 芝加哥期貨交易所 |
| NYMEX | 紐約商品交易所 |
| COMEX | 紐約商品交易所(貴金屬) |
| CBOE | 芝加哥期權交易所 |
| HKFE | 香港期貨交易所 |
| KR | 韓國交易所 |
| BMS | 馬來西亞證券交易所 |
| BMD | 馬來西亞衍生品交易所 |
| ASX | 澳大利亞交易所 |
| FX | 外匯交易所 |
| KALSHI | Kalshi 事件合約交易所 |
trading_session(交易時段)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| RTH | 常規交易時段 |
| RTH+Pre/Post-Mkt | 盤前盤後 |
| OVERNIGHT | 夜間交易 |
| ALL_DAY | 全日交易 |
僅適用於美股;市價單僅支持 RTH。
time_in_force(有效期)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| DAY | 當日有效 |
| GTC | 撤單前有效 |
| GTD | 指定日期前有效 |
| IOC | 立即成交剩餘撤單 |
| FOK | 立即全部成交否則撤單。僅外匯訂單可主動指定。 |
order_class(訂單類別)
| 取值 | 含義 |
|---|---|
| MLEG | 多腿訂單 |
lot_type(手數類型)
| 取值 | 含義 |
|---|---|
| ODD | 碎股 |
| ROUND | 整手(默認) |
適用於港股和日股交易。
currency(幣種)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| HKD | 港幣 |
| USD | 美元 |
| CNH | 離岸人民幣 |
| JPY | 日元 |
| SGD | 新加坡元 |
| KRW | 韓元 |
| MYR | 馬來西亞林吉特 |
| AUD | 澳大利亞元 |
trail_type(追蹤類型)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| RATIO | 追蹤比例 |
| AMOUNT | 追蹤金額 |
position_open_type(開倉類型)
跟蹤止損單專用,控制是否允許開新倉。
| 取值 | 含義 |
|---|---|
| DISABLE_POSITION_OPEN | 禁止開倉(僅平倉) |
| ENABLE_POSITION_OPEN | 允許開倉 |
pricing_strategy(算法單子單價格策略)
算法單通用可選參數,控制子單掛單價格策略。默認 ADAPTIVE(中性)。
| 取值 | 含義 |
|---|---|
| ADAPTIVE | 中性 |
| GHOST | 激進 |
| PASSIVE | 保守 |
layering(算法單子單下單檔位)
算法單通用可選參數,控制子單掛單分檔檔位數。默認 3 檔。
| 取值 | 含義 |
|---|---|
| AUTO | 自動 |
| 1 - 10 | 顯式檔位數 |
peg_offset(PEG 算法單子單價格跟隨規則)
PEG 算法單必填參數,控制子單價格跟隨行情價的變動規則。
| 取值 | 含義 |
|---|---|
| MID_PRICE | 中間價 |
| AGGRESSIVE_ONE_TICK | 積極 1 檔 |
| NEAR_PRICE | 擺盤 1 檔 |
| PASSIVE_ONE_TICK | 擺盤 2 檔 |
| PASSIVE_TWO_TICKS | 擺盤 3 檔 |
| PASSIVE_THREE_TICKS | 擺盤 4 檔 |
| PASSIVE_FOUR_TICKS | 擺盤 5 檔 |
| PASSIVE_FIVE_TICKS | 擺盤 6 檔 |
| PASSIVE_SIX_TICKS | 擺盤 7 檔 |
| PASSIVE_SEVEN_TICKS | 擺盤 8 檔 |
| PASSIVE_EIGHT_TICKS | 擺盤 9 檔 |
| PASSIVE_NINE_TICKS | 擺盤 10 檔 |
deal_status(成交狀態)
| 取值 | 含義 |
|---|---|
| OK | 正常 |
| CANCELLED | 已撤銷 |
| CHANGED | 已變更 |
security_type(證券類型)
| 取值 | 含義 |
|---|---|
| STOCK | 股票 |
| OPTION | 期權 |
| FUTURES | 期貨 |
| FUND | 基金 |
| MULTILEG_OPTION | 多腿期權 |
| FOREX | 外匯 |
| EVENT_CONTRACT | 事件合約 |
position_side(持倉方向)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| LONG | 多頭(默認) |
| SHORT | 空頭 |
clt_risk_status(風險狀態)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| LEVEL1 | 非常安全 |
| LEVEL2 | 安全 |
| LEVEL3 | 安全 |
| LEVEL4 | 低風險 |
| LEVEL5 | 中風險 |
| LEVEL6 | 高風險 |
| LEVEL7 | 預警 |
| LEVEL8 | 追繳保證金 |
| LEVEL9 | 追繳保證金 |
enable_market(支持交易市場)
用於 獲取授權交易賬戶 返回值。
| 取值 | 含義 |
|---|---|
| 1 | 港股市場 |
| 2 | 美股市場 |
| 4 | A股通市場 |
| 5 | 期貨市場 |
| 6 | 新加坡市場 |
| 7 | 加密貨幣 |
| 8 | 澳洲市場 |
| 9 | 外匯市場 |
| 10 | 債券 |
| 11 | 馬來西亞市場 |
| 12 | 加拿大市場 |
| 14 | 基金 |
| 15 | 日本市場 |
| 16 | 結構化票據 |
| 17 | 事件合約 |
| 18 | 韓國市場 |
security_firm(券商)
用於 獲取授權交易賬戶 返回值。
| 取值 | 含義 |
|---|---|
| FUTUSECURITIES | 富途證券(香港) |
| FUTUSG | Moomoo(新加坡) |
| FUTUINC | Moomoo(美國) |
| FUTUCA | Moomoo(加拿大) |
| FUTUMY | Moomoo(馬來西亞) |
| FUTUAU | Moomoo(澳大利亞) |
| FUTUJP | Moomoo(日本) |
acc_type(賬戶類型)
賬戶類型。用於 獲取授權交易賬戶 返回值的 acc_type 字段。
| 取值 | 含義 |
|---|---|
| cash | 現金賬戶 |
| margin | 保證金賬戶 |
| derivative | 衍生品賬戶(僅日本) |
asset_category(資產類別)
僅日本。用於 獲取賬戶資金、獲取持倉 接口的 asset_category 入參。
| 取值 | 含義 |
|---|---|
| DOMESTIC | 國內(日本) |
| FOREIGN | 國外 |
sub_acc_type(子賬戶類型)
僅日本。日本賬戶下的子賬戶類型,參見 sub_account。
| 取值 | 含義 |
|---|---|
| General | 一般 |
| Specified | 特定 |
| NISA | NISA |
margin_trading_type(信用交易類型)
僅日本保證金賬戶。信用交易類型。
| 取值 | 含義 |
|---|---|
| GENERAL | 協商型 |
| STANDARDIZED | 標準型 |
margin_period_type(信用期限類型)
僅日本保證金賬戶。信用交易期限類型。
| 取值 | 含義 |
|---|---|
| INDEFINITE | 無期限型 |
option_strategy(期權策略)
用於多腿訂單的 multi_leg_info.option_strategy 字段。
| 取值 | 含義 |
|---|---|
| Covered | 備兌策略 |
| VerticalSpread | 垂直價差 |
| Straddle | 跨式 |
| Strangle | 寬跨式 |
| Collar | 領口策略 |
| Butterfly | 蝶式 |
| Condor | 鷹式 |
| IronButterfly | 鐵蝶式 |
| IronCondor | 鐵鷹式 |
| CalenderSpread | 日曆價差 |
| DiagonalSpread | 對角價差 |
| Customize | 自定義 |
account(賬戶結構)
獲取授權交易賬戶 接口返回的賬戶對象。
| 字段 | 類型 | 說明 |
|---|---|---|
account_id | uint64 | 交易業務賬戶 ID。JSON 為數字;超過 JavaScript 安全整數時不要用 Number 解析。 |
security_firm | security_firm | 券商信息 |
enable_market | list[int] | 支持的交易市場,取值參見 enable_market |
univs_account_card_number | string | 綜合賬戶卡號(16 位) |
acc_type | acc_type | 賬戶類型 |
account_card_number | string | 業務賬戶卡號(16 位) |
sub_accounts | list[sub_account] | 僅日本。該賬戶下可選的子賬戶(按子賬戶類型各一條),僅返回可下單的子賬戶。非日本券商為空或不下發。 |
sub_account(子賬戶結構)
日本賬戶下的子賬戶對象,包含在 account 對象的 sub_accounts 列表中。
| 字段 | 類型 | 說明 |
|---|---|---|
sub_acc_type | sub_acc_type | 僅日本。子賬戶類型。 |
sub_acc_id | string | 子賬戶 ID。下單時作為 sub_acc_id 傳入。 |
order(訂單結構)
訂單查詢接口返回的訂單對象。
| 字段 | 類型 | 說明 |
|---|---|---|
side | trd_side | 交易方向 |
order_type | order_type | 訂單類型 |
order_status | order_status | 訂單狀態 |
order_id | string | 訂單 ID |
code | string | 證券代碼 |
stock_name | string | 證券名稱 |
security_type | security_type | 證券類型 |
qty | string | 訂單數量 |
price | string | 訂單價格 |
currency | currency | 交易幣種 |
create_time | uint64 | 創建時間,Unix 微秒時間戳 |
updated_time | uint64 | 最後更新時間,Unix 微秒時間戳 |
dealt_qty | string | 成交數量 |
dealt_avg_price | string | 成交均價 |
last_err_msg | string | 最後錯誤描述 |
remark | string | 下單時的備註標識 |
time_in_force | time_in_force | 有效期 |
session | trading_session | 交易時段 |
aux_price | string | 觸發價格 |
trail_type | trail_type | 追蹤類型 |
trail_value | string | 追蹤金額/比例 |
trail_spread | string | 指定價差 |
multi_leg_info | multi_leg_info | 多腿訂單信息 |
position_open_type | position_open_type | 開倉類型,僅跟蹤止損單返回 |
algo_info | algo_info | 算法單資訊,僅算法單返回 |
expire_time | uint64 | 微秒級 Unix 時間戳 |
sub_acc_id | string | 僅日本。訂單所屬子賬戶 ID(由「獲取授權交易賬戶」接口返回)。 |
sub_acc_type | sub_acc_type | 僅日本。子賬戶類型。 |
margin_trading_type | margin_trading_type | 僅日本保證金賬戶。信用交易類型。 |
margin_period_type | margin_period_type | 僅日本保證金賬戶。信用交易期限類型。 |
exchange | string | 交易所 |
order_fill(成交結構)
成交查詢接口返回的成交對象。
| 字段 | 類型 | 說明 |
|---|---|---|
trd_side | trd_side | 交易方向 |
deal_id | string | 成交 ID。最長不超過 32 字符的 Base58 編碼,大小寫敏感。 |
order_id | string | 訂單 ID |
code | string | 證券代碼 |
stock_name | string | 證券名稱 |
qty | string | 成交數量 |
price | string | 成交價格 |
create_time | uint64 | 創建時間,Unix 微秒時間戳 |
update_time | uint64 | 最後更新時間,Unix 微秒時間戳 |
counter_broker_id | string | 對手方券商編號 |
counter_broker_name | string | 對手方券商名稱 |
status | deal_status | 成交狀態 |
sub_acc_id | string | 僅日本。訂單所屬子賬戶 ID(由「獲取授權交易賬戶」接口返回)。 |
sub_acc_type | sub_acc_type | 僅日本。子賬戶類型。 |
multi_leg_info(多腿訂單信息)
下單或訂單詳情中多腿訂單的詳細信息。
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
option_strategy | option_strategy | 是 | 多腿期權策略類型。下多腿訂單必填;查詢組合可交易信息時可不填。 |
underlying_symbol | string | 是 | 多腿期權的標的股票代碼,例如 AAPL |
underlying_stock_name | string | 否 | 標的股票名稱(僅響應中返回) |
leg_infos | list[order_leg_info] | 是 | 各腿信息 |
order_leg_info(訂單腿信息)
多腿訂單中每一腿的詳細信息。
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
leg_code | string | 是 | 腿的證券代碼。格式:market.symbol,如 US.AAPL |
leg_ratio_qty | string | 是 | 各腿按最大公因數原則確定的比例 |
leg_side | trd_side | 是 | 各腿方向 |
leg_stock_name | string | 否 | 腿的證券名稱(僅響應中返回) |
leg_hp_multiplier | string | 否 | 腿的合約乘數(僅響應中返回) |
leg_avg_fill_price | string | 否 | 各腿成交均價(僅響應中返回) |
leg_security_type | security_type | 否 | 腿的證券類型(僅響應中返回) |
leg_symbol | string | 否 | 腿的證券 symbol(僅響應中返回) |
leg_exchange | string | 否 | 腿的交易所(僅響應中返回) |
direction(資金流水方向)
用於 獲取資金流水 請求參數 direction 字段。
| 取值 | 含義 |
|---|---|
| IN | 資金流入 |
| OUT | 資金流出 |
cash_log(資金流水)
獲取資金流水 接口返回的流水對象。
| 字段 | 類型 | 說明 |
|---|---|---|
transaction_name | string | 資金變動事件描述(如"股票賣出成交"、"基金申購"等) |
created_time | string | 流水創建時間,格式為 MM/DD/YYYY HH:MM:SS,如 09/29/2026 05:53:16 |
cash_change | string | 資金變動金額,正數為流入,負數為流出 |
balance | string | 變動後賬戶餘額 |
symbol | string | 關聯標的代碼,不含市場前綴,例如 AAPL、00700。請求過濾請用 code(market.symbol,如 US.AAPL)。無關聯標的時為空 |
stock_name | string | 關聯標的代碼加名稱,例如 "AAPL Apple Inc.",不是純名稱。無關聯標的時為空 |
order_fee(費用項)
獲取訂單費用 接口返回的費用明細對象。
| 字段 | 類型 | 說明 |
|---|---|---|
type | string | 費用項類型名稱(如"佣金"、"平台費"等) |
amount | string | 費用項金額 |
margin_preview(保證金預覽)
獲取組合可交易信息 接口返回的保證金預覽對象。
| 字段 | 類型 | 說明 |
|---|---|---|
name | string | 保證金項目名稱 |
inc_value | string | 保證金變動金額 |
margin_ratio(融資融券數據)
獲取融資融券數據 接口返回的融資融券數據對象。
| 字段 | 類型 | 說明 |
|---|---|---|
code | string | 標的代碼,格式:market.symbol |
is_long_permit | bool | 是否允許融資 |
is_short_permit | bool | 是否允許融券 |
short_pool_remain | string | 賣空池剩餘 |
short_fee_rate | string | 融券參考利率,例如 "0.003%" |
alert_long_ratio | string | 融資預警比率,例如 "130.00%" |
alert_short_ratio | string | 融券預警比率 |
im_long_ratio | string | 融資初始保證金率 |
im_short_ratio | string | 融券初始保證金率 |
mcm_long_ratio | string | 融資 margin call 保證金率 |
mcm_short_ratio | string | 融券 margin call 保證金率 |
mm_long_ratio | string | 融資維持保證金率 |
mm_short_ratio | string | 融券維持保證金率 |
algo_info(算法單資訊)
訂單查詢介面中算法單的執行資訊,僅算法單返回。pricing_strategy、layering 為通用字段,各算法類型對應的子結構按訂單類型返回。
| 字段 | 類型 | 說明 |
|---|---|---|
start_time | int64 | 算法單開始執行時間,Unix 微秒時間戳 |
end_time | int64 | 算法單結束執行時間,Unix 微秒時間戳 |
pricing_strategy | pricing_strategy | 子單價格策略 |
layering | layering | 子單下單檔位 |
twap | twap_info | TWAP 執行參數 |
vwap | vwap_info | VWAP 執行參數 |
pov | pov_info | POV 執行參數 |
slicer | slicer_info | Slicer 執行參數 |
peg | peg_info | PEG 執行參數 |
iceberg | iceberg_info | Iceberg 執行參數 |
twap_info(TWAP 執行資訊)
| 字段 | 類型 | 說明 |
|---|---|---|
participation_rate | string | 最大跟隨比例,取值範圍 1%–99%,最小變動單位 1%。字串類型表示該數值為百分數,無需傳入 %,如 "20" 表示 20% |
vwap_info(VWAP 執行資訊)
| 字段 | 類型 | 說明 |
|---|---|---|
participation_rate | string | 最大跟隨比例,取值範圍 1%–99%,最小變動單位 1%。字串類型表示該數值為百分數,無需傳入 %,如 "20" 表示 20% |
pov_info(POV 執行資訊)
| 字段 | 類型 | 說明 |
|---|---|---|
participation_rate | string | 最大跟隨比例,取值範圍 1%–80%(港股 / A 股通 / 期貨)或 1%–99%(美股),最小變動單位 1%。字串類型表示該數值為百分數,無需傳入 %,如 "20" 表示 20% |
slicer_info(Slicer 執行資訊)
| 字段 | 類型 | 說明 |
|---|---|---|
slice_interval | int | 子單下單間隔時間,單位秒,取值 ≥10 且 ≤(end_time − start_time)換算秒;與 display_qty 二選一必填 |
display_qty | int | 子單單次下單量,正整數手數;與 slice_interval 二選一必填 |
display_qty_var | int | 子單下單量隨機化程度,整數 0–99,默認 0 |
peg_info(PEG 執行資訊)
| 字段 | 類型 | 說明 |
|---|---|---|
display_qty | int | 子單單次下單量,正整數手數 |
peg_offset | peg_offset | 盯住位置,默認 NEAR_PRICE |
display_qty_var | int | 子單下單量隨機化程度,整數 0–99,默認 0 |
iceberg_info(Iceberg 執行資訊)
| 字段 | 類型 | 說明 |
|---|---|---|
display_qty | int | 子單單次下單量,正整數手數,範圍 1–父單手數 |
display_qty_var | int | 子單下單量隨機化程度,整數 0–99,默認 0 |