命名詞典
交易接口使用的所有枚舉值與數據結構對照表。各接口文檔中的枚舉字段與響應結構均可在此查閱。
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 | 觸及限價單 |
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 | HKCC 市場 |
| CA | 加拿大市場 |
| FUTURES | 期貨市場 |
exchange(交易所)
| 取值 | 含義 |
|---|---|
| US | 美國市場 |
| SEHK | 香港聯合交易所 |
| SGX | 新加坡交易所 |
| SSE | 上海證券交易所(滬港通) |
| SZSE | 深圳證券交易所(深港通) |
| JP | 日本交易所 |
| CA | 加拿大交易所 |
| CME | 芝加哥商品交易所 |
| CBOT | 芝加哥期貨交易所 |
| NYMEX | 紐約商品交易所 |
| COMEX | 紐約商品交易所(貴金屬) |
| CBOE | 芝加哥期權交易所 |
| HKFE | 香港期貨交易所 |
trading_session(交易時段)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| RTH | 常規交易時段 |
| RTH+Pre/Post-Mkt | 盤前盤後 |
| OVERNIGHT | 夜間交易 |
| ALL_DAY | 全日交易 |
僅適用於美股;市價單僅支持 RTH。
time_in_force(有效期)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| DAY | 當日有效 |
| GTC | 撤單前有效 |
order_class(訂單類別)
| 取值 | 含義 |
|---|---|
| NORMAL | 普通單腿訂單(默認) |
| MLEG | 多腿訂單 |
lot_type(手數類型)
| 取值 | 含義 |
|---|---|
| ODD | 碎股 |
| ROUND | 整手(默認) |
僅適用於港股交易。
currency(幣種)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| HKD | 港幣 |
| USD | 美元 |
| CNH | 離岸人民幣 |
| JPY | 日元 |
| SGD | 新加坡元 |
trail_type(追蹤類型)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| RATIO | 追蹤比例 |
| AMOUNT | 追蹤金額 |
deal_status(成交狀態)
| 取值 | 含義 |
|---|---|
| OK | 正常 |
| CANCELLED | 已撤銷 |
| CHANGED | 已變更 |
security_type(證券類型)
| 取值 | 含義 |
|---|---|
| STOCK | 股票 |
| OPTION | 期權 |
| FUTURES | 期貨 |
| MULTILEG_OPTION | 多腿期權 |
position_side(持倉方向)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| LONG | 多頭(默認) |
| SHORT | 空頭 |
clt_risk_status(風險狀態)
| 取值 | 含義 |
|---|---|
| NONE | 未知 |
| LEVEL1 | 非常安全 |
| LEVEL2 | 安全 |
| LEVEL3 | 安全 |
| LEVEL4 | 低風險 |
| LEVEL5 | 中風險 |
| LEVEL6 | 高風險 |
| LEVEL7 | 預警 |
| LEVEL8 | 追繳保證金 |
| LEVEL9 | 追繳保證金 |
enable_market(支持交易市場)
用於 獲取授權交易賬戶 返回值。
| 取值 | 含義 |
|---|---|
| 1 | 港股市場 |
| 2 | 美股市場 |
| 4 | HKCC 市場 |
| 5 | 期貨市場 |
| 6 | 新加坡市場 |
| 7 | 加密貨幣 |
| 8 | 澳洲市場 |
| 9 | 外匯市場 |
| 10 | 債券 |
| 11 | 馬來西亞市場 |
| 12 | 加拿大市場 |
| 14 | 基金 |
| 15 | 日本市場 |
| 16 | 結構化票據 |
| 24 | 新加坡基金 |
security_firm(券商)
用於 獲取授權交易賬戶 返回值。
| 取值 | 含義 |
|---|---|
| FUTUSECURITIES | 富途證券(香港) |
| FUTUSG | moomoo(新加坡) |
| FUTUINC | moomoo(美國) |
| FUTUCA | moomoo(加拿大) |
option_strategy(期權策略)
用於多腿訂單的 multi_leg_info.option_strategy 字段。
| 取值 | 含義 |
|---|---|
| Covered | 備兌策略 |
| VerticalSpread | 垂直價差 |
| Straddle | 跨式 |
| Strangle | 寬跨式 |
| Collar | 領口策略 |
| Butterfly | 蝶式 |
| Condor | 鷹式 |
| IronButterfly | 鐵蝶式 |
| IronCondor | 鐵鷹式 |
| CalenderSpread | 日曆價差 |
| DiagonalSpread | 對角價差 |
| Customize | 自定義 |
Account(賬戶結構)
獲取授權交易賬戶 接口返回的賬戶對象。
| 字段 | 類型 | 說明 |
|---|---|---|
account_id | string | 交易業務賬戶 ID |
security_firm | SecurityFirm | 券商信息 |
enable_market | list[int] | 支持的交易市場,取值參見 enable_market |
univs_account_card_number | string | 綜合賬戶卡號(16 位) |
acc_type | string | 賬戶類型:cash(現金賬戶)/ margin(保證金賬戶) |
account_card_number | string | 業務賬戶卡號(16 位) |
Order(訂單結構)
訂單查詢接口返回的訂單對象。
| 字段 | 類型 | 說明 |
|---|---|---|
side | TrdSide | 交易方向 |
order_type | OrderType | 訂單類型 |
order_status | OrderStatus | 訂單狀態 |
order_id | string | 訂單 ID |
code | string | 證券代碼 |
stock_name | string | 證券名稱 |
security_type | SecurityType | 證券類型 |
qty | string | 訂單數量 |
price | string | 訂單價格 |
currency | Currency | 交易幣種 |
create_time | uint64 | 創建時間 |
updated_time | uint64 | 最後更新時間 |
dealt_qty | string | 成交數量 |
dealt_avg_price | string | 成交均價 |
last_err_msg | string | 最後錯誤描述 |
remark | string | 下單時的備註標識 |
time_in_force | TimeInForce | 有效期 |
session | TradingSession | 交易時段 |
aux_price | string | 觸發價格 |
trail_type | TrailType | 追蹤類型 |
trail_value | string | 追蹤金額/比例。當 TrdSide 為 SELL 或 SELL_SHORT 時為負數。 |
trail_spread | string | 指定價差。當 TrdSide 為 SELL 或 SELL_SHORT 時為負數。 |
multi_leg_info | list[MultiLegInfo] | 多腿訂單信息 |
OrderFill(成交結構)
成交查詢接口返回的成交對象。
| 字段 | 類型 | 說明 |
|---|---|---|
trd_side | TrdSide | 交易方向 |
deal_id | string | 成交 ID |
order_id | string | 訂單 ID |
code | string | 證券代碼 |
stock_name | string | 證券名稱 |
qty | string | 成交數量 |
price | string | 成交價格 |
create_time | uint64 | 創建時間 |
updated_time | uint64 | 最後更新時間 |
counter_broker_id | int | 對手方券商編號 |
counter_broker_name | string | 對手方券商名稱 |
status | DealStatus | 成交狀態 |
MultiLegInfo(多腿訂單信息)
下單或訂單詳情中多腿訂單的詳細信息。
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
option_strategy | OptionStrategy | 是 | 多腿期權策略類型 |
underlying_symbol | string | 是 | 多腿期權的標的股票代碼,例如 AAPL |
underlying_stock_name | string | 否 | 標的股票名稱(僅響應中返回) |
leg_infos | list[OrderLegInfo] | 是 | 各腿信息 |
OrderLegInfo(訂單腿信息)
多腿訂單中每一腿的詳細信息。
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
leg_symbol | string | 是 | 腿的證券代碼 |
leg_exchange | Exchange | 是 | 腿的交易所 |
leg_ratio_qty | string | 是 | 各腿按最大公因數原則確定的比例 |
leg_side | TrdSide | 是 | 各腿方向 |
leg_security_type | SecurityType | 是 | 腿的證券類型 |
leg_stock_name | string | 否 | 腿的證券名稱(僅響應中返回) |
leg_hp_multiplier | string | 否 | 腿的合約乘數(僅響應中返回) |
leg_avg_fill_price | string | 否 | 各腿成交均價(僅響應中返回) |