跳至主要内容

TradFi 接入指南

本指南說明如何透過現有的 V5 API 接入 Bybit 的 TradFi（傳統金融）產品，包括如何區分 MT5 相關的交易產品與 Bybit 平台原生的合約、如何簽署所需協議，以及如何進行交易。

區分 MT5 與 Equity Perp 上架​

Bybit 提供兩條傳統資產交易路徑：

TradFi（MT5 驅動）​

透過 Web UI 進入：導覽至 Trade → TradFi。此區塊涵蓋由 MT5 引擎驅動的外匯、大宗商品及股票 CFD。

TradFi Web UI 入口

Bybit 平台（原生）​

透過主選單 Trade 進入，包含所有標準的 Bybit 產品類型：

  • 現貨（Spot）：xStock 代幣（如 TSLAX、AAPLX、GOOGLX）
  • 合約（Futures）：股票永續合約（如 TSLAUSDT）、貴金屬永續合約（XAU、XAG）、原油永續合約
  • 期權（Options）：以 USDT 結算的期權合約，包括代幣化黃金期權（XAUTUSDT-Options）

Bybit 交易選單

法律條款審閱​

在交易傳統資產永續合約之前，請先閱讀適用的條款與細則：

母帳戶簽署協議​

交易大宗商品合約（貴金屬與原油）或股票永續合約前，用戶必須先簽署交易協議。股票永續合約與貴金屬共用同一份協議。可透過以下兩種方式完成：

方式一：透過 Web UI​

首次嘗試交易時，系統會彈出 Trading Terms 視窗，勾選核取方塊並點擊 Confirm 即可接受。

信息

僅母帳戶可透過 Web UI 簽署協議，請確保使用母帳戶登入。

交易條款協議彈窗

方式二：透過 API​

使用 簽署協議 介面以程式化方式簽署。

信息
  • 請使用母帳戶呼叫介面，子帳戶不支援此操作。
  • 母帳戶簽署後，旗下所有子帳戶即可進行交易。
  • API key 權限需具備其中之一：帳戶劃轉、母子帳戶劃轉、提幣。

HTTP 請求​

POST/v5/user/agreement

請求參數​

參數是否必需類型說明
categoryfalseinteger2: 貴金屬（黃金、白銀）合約協議，股票永續合約共用此協議
3: 原油合約協議
category 與 categoryV2 二選一必傳。該字段仍然可用，但後續新增的枚舉值將不再添加至此字段，請使用 categoryV2。
categoryV2falseinteger1: 貴金屬（黃金、白銀）合約協議，股票永續合約共用此協議
2: 原油合約協議
category 與 categoryV2 二選一必傳。建議使用此字段，後續新增的枚舉值將統一添加至此字段。
agreetruebooleantrue

響應參數​

無

請求示例​

POST /v5/user/agreement HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1772695036541
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 40

{
    "agree": true,
    "categoryV2": 2
}

響應示例​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {},
    "retExtInfo": {},
    "time": 1772695037330
}

指數價格展期機制（Index Price Rollover Mechanism）​

永續期貨的指數價格源自各自的標的期貨合約。由於大宗商品並無傳統的現貨市場，因此外部參考價格將根據指定的期貨合約來確定。

在標的合約到期前，系統會進行展期換月（contract rollover）：參考價格將依照預定的權重時程，於數日內從前月合約（front-month）逐步過渡至下月合約（next-month）。

展期期間的權重分配依照下表進行：

日期前月合約權重（Front-Month）下月合約權重（Next-Month）
Day 180%20%
Day 260%40%
Day 340%60%
Day 420%80%
Day 50%100%（展期完成）

以 CLUSDT（原油）為例，即依循此機制在其指定的標的期貨合約之間過渡（例如由 WTIK6 過渡至 WTIM6）。

信息

如需取得最新的展期時程與完整說明，請參閱幫助中心文章：TradFi 永續合約介紹。

如需查詢指數的當前成分及各成分的權重，可使用 查詢指數價格成分 介面：

GET/v5/market/index-price-components

查詢參數：indexName={symbol}

響應包含每個成分的交易所名稱、現貨交易對、等價價格、乘數，以及在指數計算中所占的權重。

xStock、股票永續合約與大宗商品的可交易產品的規格信息​

請使用 查詢可交易產品的規格信息 介面，並搭配 symbolType 參數來取得 TradFi 可交易產品的配置規則信息。完整列舉值請參閱 symbolType 列舉值。

GET/v5/market/instruments-info
產品類型categorysymbolType範例 symbol特有欄位
xStock 代幣spotxstocksTSLAXUSDT、AAPLXUSDT、NVDAXUSDTxstockMultiplier
股票永續合約linearstockTSLAUSDT—
大宗商品永續合約linearcommodityXAUUSDT、XAGUSDT、CLUSDT—

股票與大宗商品永續合約皆回傳標準的 linear 合約欄位（槓桿、最小價格變動單位、資金費率間隔等）。

請求範例：

GET /v5/market/instruments-info?category=linear&symbolType=stock&limit=1000

透過現有 API 交易​

簽署協議後，您可以使用標準的 交易 介面來交易 TradFi 相關的交易對（貴金屬永續合約、原油永續合約等），無需使用獨立的 API — 使用相同的下單、修改與撤單介面即可：

僅需在請求中傳入對應的 category 與 symbol：

  • xStock 代幣：category=spot，symbol 如 TSLAXUSDT、AAPLXUSDT
  • 股票永續合約：category=linear，symbol 如 TSLAUSDT
  • 貴金屬永續合約：category=linear，symbol 如 XAUUSDT、XAGUSDT
  • 原油永續合約：category=linear，symbol：CLUSDT