期貨交易

期貨 API 讓您可以在美國和香港交易所交易期貨合約，涵蓋指數、利率、貨幣、農產品、金屬、能源及加密貨幣。

前置條件

• 已開通期貨交易功能的帳戶（如尚未開通，請透過 Webull App 啟用）
• 帳戶中有足夠的保證金

支援市場

市場	Category 值	交易所
美國期貨	US_FUTURES	CME、CBOT、NYMEX、COMEX、CBOE
香港期貨	HK_FUTURES	HKEX

所有期貨端點均接受 category 參數以指定市場。美國上市合約使用 US_FUTURES，港交所上市合約使用 HK_FUTURES。

合約代碼

期貨合約採用標準化命名規則：產品代碼 + 月份字母 + 年份數字。

例如：

• ESZ5 = E-mini S&P 500，2025 年 12 月（美國）
• HSIZ5 = 恒生指數，2025 年 12 月（香港）

1月	2月	3月	4月	5月	6月	7月	8月	9月	10月	11月	12月
F	G	H	J	K	M	N	Q	U	V	X	Z

查詢合約

使用以下端點查詢可用的產品和合約：

端點	說明
期貨產品列表	列出所有期貨產品代碼及名稱
期貨產品分類	列出所有期貨產品分類群組
期貨合約查詢	依代號或產品代碼查詢合約詳情
依產品代碼查詢合約	依產品代碼及合約類型查詢可交易合約

每個合約回應包含關鍵資訊，如 contract_month（合約月份）、settlement_date（結算日期）、size（合約乘數）、min_tick（最小價格變動）、first_notice_date（首次通知日）、last_trading_date（最後交易日）、settlement（結算方式：現金或實物交割）及 contract_type（合約類型：MONTHLY 或 MAIN）。

支援的訂單類型

訂單類型	說明
MARKET	以當前最佳可用價格立即執行
LIMIT	以指定價格或更優價格執行
STOP_LOSS	當觸及止損價時觸發市價單
STOP_LOSS_LIMIT	當觸及止損價時觸發限價單
TRAILING_STOP_LOSS	止損價隨市場價格按設定幅度追蹤

有效期限

值	說明
DAY	僅在當前交易時段有效
GTC	持續有效直至取消

提示

期貨交易目前不支援組合訂單（OTO、OTOCO、OCO）。

交易時間

期貨市場的交易時間因交易所和產品而異：

• 美國期貨 — 每週近乎 24 小時交易，每週 6 天（美東時間週日晚間至週五下午）。各產品有各自的交易時間和維護時段。
• 香港期貨 — 港交所衍生產品於日間時段（上午 9:15 – 中午 12:00，下午 1:00 – 下午 4:30 HKT）及收市後時段（下午 5:15 – 翌日凌晨 3:00 HKT）交易。確切時間因產品而異。

請查閱交易所規格以了解您所交易合約的確切時間表。

保證金

保證金類型	說明
初始保證金	開倉所需的資金（通常為合約價值的 3–12%）
維持保證金	維持持倉所需的最低權益

警告

如果您的權益低於維持保證金，您將收到追繳保證金通知。您必須存入資金以恢復至初始保證金水平，否則您的持倉可能會被強制平倉。

結算與到期

• 大多數交易者會在到期前平倉以避免實物交割
• Webull 不支援實物交割 — 您必須在到期前平倉或轉倉
• 如果持倉在到期時未平倉，Webull 將嘗試代為平倉。未能在到期前平倉可能導致強制平倉或額外費用

警告

Webull 不支援標的商品的實物交割。請務必在合約到期日前平倉或轉倉您的期貨持倉，以避免強制平倉。

請求範例

美國期貨

以限價 4500 買入 1 張 E-mini S&P 500 2025 年 12 月合約。

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "combo_type": "NORMAL",
      "client_order_id": "<unique_id>",
      "symbol": "ESZ5",
      "instrument_type": "FUTURES",
      "market": "US",
      "order_type": "LIMIT",
      "limit_price": "4500",
      "quantity": "1",
      "side": "BUY",
      "time_in_force": "DAY",
      "entrust_type": "QTY"
    }
  ]
}

香港期貨

以限價 20000 買入 1 張恒生指數 2025 年 12 月合約。

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "combo_type": "NORMAL",
      "client_order_id": "<unique_id>",
      "symbol": "HSIZ5",
      "instrument_type": "FUTURES",
      "market": "HK",
      "order_type": "LIMIT",
      "limit_price": "20000",
      "quantity": "1",
      "side": "BUY",
      "time_in_force": "DAY",
      "entrust_type": "QTY"
    }
  ]
}

期貨行情數據

期貨行情數據可透過行情數據 API 取得，美國及香港合約均支援。以下端點支援 HK_FUTURES 類別：

端點	說明
逐筆成交	逐筆成交數據（價格、成交量、方向）
即時快照	即時快照，包含價格、漲跌、成交量、未平倉量、買賣盤
大單足跡	按價格層級的主動買賣量分佈
深度報價	Level-2 買賣盤（最多 10 檔）
歷史K線	多種時間粒度的 OHLCV K線數據

提示

透過 OpenAPI 存取期貨行情數據需要付費訂閱。訂閱詳情請參閱訂閱進階行情。

費用

有關當前費用標準，請參閱 Webull 香港定價。

下一步

• 股票交易 — 股票及 ETF 訂單管理
• 期權 — 期權交易
• 交易 API 概覽 — 完整功能矩陣