TradFi 接入指南

信息

本指南涵蓋的 Bybit 原生 Spot、Futures 與 Options 產品均支持透過 V5 API 交易。
TradFi CFD 使用 MetaTrader 5（MT5），不支持透過 V5 API 查詢或交易。

本指南涵蓋與傳統資產相關的交易產品，包括股票及 ETF 永續合約、大宗商品及外匯永續合約、股票代幣、代幣化黃金與期權，並說明 TradFi 與 Trade 下的 Web UI 入口，以及查詢產品規格和交易所需的 V5 API。

Web UI 入口與 API 支持範圍

TradFi（Futures、Options 與 CFD）

在 Web 導覽列開啟 TradFi，可進入以下衍生品區塊：

Web UI 入口	產品	API 接入方式
TradFi → Futures	以 USDT 結算的永續合約，包括股票、ETF、大宗商品及外匯	Bybit 原生；V5 `category=linear`
TradFi → Options	以 USDT 結算的期權，包括 `SPCX`、`NVDA` 等股票標的	Bybit 原生；V5 `category=option`
TradFi → CFD	MT5 差價合約，包含貴金屬、股票、指數、外匯及大宗商品等分類	MT5；不支持 V5 API

Futures
Options
CFD

TradFi 永續合約使用 V5 category=linear，期權使用 category=option。選單名稱不一定是 API 列舉值，請按下文說明使用對應參數查詢產品。All、Trending、New 為 Web UI 篩選項，沒有專用的 symbolType 值。

Trade（Spot、Futures 與 Options）

本節列出的產品均為 Bybit 原生產品，支持透過現有的 V5 交易 API 進行交易。現貨交易對使用 category=spot，下列永續合約使用 category=linear，期權使用 category=option。

Trade → Spot → xStocks：股票代幣，例如 TSLAX、AAPLX、GOOGLX。
Trade → Spot → RWA：包含代幣化黃金（XAUT/USDT）、xStocks 及其他 RWA 相關資產。
Trade → Futures → USDT → RWA：包含以 USDT 結算的代幣化黃金永續合約，例如 XAUTUSDT、PAXGUSDT，使用 V5 category=linear。
Trade → Options：包含以 USDT 結算的代幣化黃金（XAUT）期權。使用 V5 category=option，並透過 baseCoin=XAUT 查詢合約規格。

Spot (xStocks)
Spot (XAUT)
Futures (XAUT / PAXG)
Options (XAUT)

登入後，在 Trade → Spot 下選擇 xStocks，即可查看 AAPLX/USDT、NVDAX/USDT、SPCXX/USDT 等股票代幣交易對：

在 Trade → Spot 下選擇 RWA，即可找到 XAUT/USDT（Tether Gold）。此列表範圍較廣，也包含 xStocks 及其他資產：

在 Trade → Futures 下選擇 USDT → RWA，即可找到 XAUTUSDT（Tether Gold）與 PAXGUSDT（Pax Gold）永續合約：

Trade → Options 選單包含 XAUT，並同時展示 BTC、ETH、SOL 等其他期權標的：

xStocks 使用 V5 category=spot 與 symbolType=xstocks；XAUT 現貨則使用 category=spot 與 symbol=XAUTUSDT 查詢。

Spot 與 Futures 下的 RWA 選單是主題篩選項，沒有對應的 symbolType=RWA 列舉值。這些列表也包含其他 RWA 相關加密資產。

透過 API 查詢 TradFi 產品

TradFi Futures：按 symbolType 篩選

使用查詢可交易產品的規格信息介面，傳入 category=linear 與 symbolType 列舉值，取得永續合約規格。

GET/v5/market/instruments-info

Futures 分類	`category`	`symbolType`	範例 symbol
Stocks（股票）	`linear`	`stock`	`TSLAUSDT`、`NVDAUSDT`
ETF	`linear`	`ETF`	`QQQUSDT`、`SPYUSDT`
Commodities（大宗商品）	`linear`	`commodity`	`XAUUSDT`、`XAGUSDT`、`CLUSDT`、`BZUSDT`
Pre-IPO	`linear`	`stock`（另傳 `status=PreLaunch`）	`OPENAIUSDT`、`ANTHROPICUSDT`、`MOONSHOTUSDT`
FX（外匯）	`linear`	`forex`	`EURUSDUSDT`、`GBPUSDUSDT`、`USDJPYUSDT`

每次請求傳入一個 symbolType，並使用列舉值的準確拼寫（ETF 為大寫）。這些產品返回標準的 linear 合約欄位，包括 contractType、leverageFilter、priceFilter、lotSizeFilter 與 fundingInterval。可透過有值的 fullName、marketRegion、underlyingTicker 識別標的資產。

請求範例：

GET /v5/market/instruments-info?category=linear&symbolType=stock&limit=1000
GET /v5/market/instruments-info?category=linear&symbolType=ETF&limit=1000
GET /v5/market/instruments-info?category=linear&symbolType=commodity&limit=1000
GET /v5/market/instruments-info?category=linear&symbolType=stock&status=PreLaunch&limit=1000
GET /v5/market/instruments-info?category=linear&symbolType=forex&limit=1000

若 nextPageCursor 非空，請在下一次請求中將其作為 cursor 傳入，以取得剩餘產品。

Pre-IPO

如需查詢 Pre-IPO 下的盤前股票合約，請使用 category=linear、symbolType=stock 與 status=PreLaunch。預設列表查詢不包含 PreLaunch 合約。

請透過 isPreListing 與 preListingInfo.curAuctionPhase 確認交易狀態。status=PreLaunch 的合約可能已處於 ContinuousTrading。

Options：先查基礎幣種，再查具體合約

TradFi → Options 下的股票期權，可先透過查詢期權基礎幣種取得標的。此介面的 underlyingType 按標的資產類型篩選，其中 2 代表股票。

GET/v5/market/option-base-coins

GET /v5/market/option-base-coins?underlyingType=2

檢查 hasSymbol=1，以識別當前有可交易期權合約的基礎幣種，例如 SPCX、NVDA。然後使用查詢可交易產品的規格信息，傳入 category=option 及返回的 baseCoin：

GET /v5/market/instruments-info?category=option&baseCoin=SPCX&limit=1000
GET /v5/market/instruments-info?category=option&baseCoin=NVDA&limit=1000

Trade → Options 下的代幣化黃金期權同樣使用 category=option，傳入 baseCoin=XAUT 即可查詢：

GET /v5/market/instruments-info?category=option&baseCoin=XAUT&limit=1000

使用返回的 symbol 識別不同到期日、行權價及看漲／看跌的具體合約。期權規格包含 optionsType、deliveryTime、quoteCoin、settleCoin、priceFilter 與 lotSizeFilter。若返回 nextPageCursor，請繼續分頁查詢。

symbolType 篩選不適用於 category=option。underlyingType 屬於查詢期權基礎幣種介面；在查詢可交易產品的規格信息中，應使用 baseCoin 篩選期權合約。

xStocks：相關現貨產品

如需查詢 NVDAXUSDT、AAPLXUSDT 等股票代幣交易對，請在 API 請求中使用 category=spot 與 symbolType=xstocks：

GET /v5/market/instruments-info?category=spot&symbolType=xstocks

請使用返回的 symbol 與現貨交易規則；xStocks 與股票永續合約各有獨立的產品規格，詳見查詢可交易產品的規格信息。

代幣化黃金：XAUT 現貨

如需查詢 Trade → Spot → RWA 下的 XAUT/USDT，請透過 symbol 取得現貨規格：

GET /v5/market/instruments-info?category=spot&symbol=XAUTUSDT

XAUT 現貨返回的 symbolType 為空字串，不包含在 symbolType=xstocks 的篩選結果中。請使用返回的現貨交易規則。同一個 XAUTUSDT 代碼在 category=linear 下代表永續合約，因此查詢及交易時務必傳入對應的 category。

代幣化黃金：永續與交割合約

如需查詢 Trade → Futures → USDT → RWA 下的 USDT 永續合約，請使用 category=linear 與完整 symbol：

GET /v5/market/instruments-info?category=linear&symbol=XAUTUSDT
GET /v5/market/instruments-info?category=linear&symbol=PAXGUSDT

這些合約返回 contractType=LinearPerpetual，symbolType 為空字串，不包含在 symbolType=commodity 的查詢結果中。TradFi → Futures 下的 XAUUSDT 則是另一個大宗商品永續合約。

如需查詢相同代幣化黃金標的的其他合約，請使用 baseCoin：

GET /v5/market/instruments-info?category=linear&baseCoin=XAUT&limit=1000
GET /v5/market/instruments-info?category=linear&baseCoin=PAXG&limit=1000

結果包含以 USDC 結算的永續合約（XAUTPERP、PAXGPERP）及 XAUT 交割合約。請檢查 contractType（LinearPerpetual 或 LinearFutures）、quoteCoin、settleCoin 與 deliveryTime，以識別具體合約。請使用返回的 symbol；若返回 nextPageCursor，請繼續分頁查詢。

CFD：MT5 產品

TradFi → CFD 下的 Stocks、Indices、Forex、Metals、Commodities 等分類屬於 MT5，並非 V5 的 symbolType 列舉值。這些 CFD 產品不能透過本指南中的 V5 介面查詢或交易。例如，截圖中的 CFD 代碼 XAUUSD.s 與 V5 永續合約代碼 XAUUSDT 代表不同產品。

法律條款審閱

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

母帳戶簽署協議

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

方式一：透過 Web UI

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

信息

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

交易條款協議彈窗

方式二：透過 API

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

信息

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

HTTP 請求

POST/v5/user/agreement

請求參數

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

響應參數

無

請求示例

以下範例簽署貴金屬協議（categoryV2=1），股票永續合約也使用此協議。

HTTP
Python

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

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

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.sign_agreement(
    categoryV2=1,
    agree=True
))

響應示例

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

透過現有 API 交易

上述現貨、永續、交割及期權產品均使用標準的 V5 交易介面。下單前請完成適用的交易協議；上文的簽署流程適用於其中列明的永續合約產品。請以各介面支持的 category 及產品專用參數為準：

請傳入對應的 category，以及查詢可交易產品的規格信息返回的 symbol：

Futures：category=linear，使用查詢可交易產品的規格信息返回的完整永續或交割合約代碼，例如 TSLAUSDT、QQQUSDT、XAUUSDT、XAUTUSDT、PAXGUSDT 或 XAUTPERP。
Options：category=option，使用包含到期日、行權價及看漲／看跌類型的完整期權合約代碼。下單時不能僅將基礎幣種 NVDA、SPCX 或 XAUT 作為 symbol。
Spot：category=spot，使用股票代幣交易對（例如 NVDAXUSDT、AAPLXUSDT）或代幣化黃金交易對 XAUTUSDT。

指數價格計算規則

TradFi 永續合約的指數價格由各成分加權計算，來源及權重依產品與交易時段而定。成分可包含價格數據源、交易所指數及期貨價格。

市場開市：每秒更新指數價格，以各成分的加權平均計算。
市場休市：停止更新的成分（例如 Pyth 提供的部分股票或大宗商品價格）可能被暫時剔除，以減少過時價格的影響。
時段切換：透過平滑機制維持指數價格的連續性。

計算方式及交易時段規則請參閱 TradFi 永續合約介紹。一般計算公式及價格保護機制請參閱指數價格計算。成分及權重變更請參閱指數價格公告。

如需查詢當前成分及權重，請使用查詢指數價格成分：

GET/v5/market/index-price-components

GET /v5/market/index-price-components?indexName=CLUSDT

響應包含各成分的來源（exchange）、參考代碼（spotPair）、等價價格、乘數及權重。spotPair 欄位也可能表示期貨參考合約或價格數據源。

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

對於指數參考有到期日期貨合約的大宗商品永續合約（例如 CLUSDT），當參考合約接近到期時，需將參考價格切換至較遠月份的合約。展期改變的是指數參考成分，Bybit 永續合約本身不會因此到期。

漸進式展期會在數日內，將前月合約的權重逐步移至下月合約。以下五日分配僅為示意，實際日期及權重以適用的展期時程為準：

日期	前月合約權重（Front-Month）	下月合約權重（Next-Month）
Day 1	80%	20%
Day 2	60%	40%
Day 3	40%	60%
Day 4	20%	80%
Day 5	0%	100%（展期完成）

以下截圖展示 CLUSDT 展期期間的指數成分，僅作歷史範例。當前參考合約及權重請透過查詢指數價格成分取得。

CLUSDT 展期期間的歷史指數成分範例

如需查看 Pyth 成分，可使用返回的參考代碼，在 Pyth Data Explorer 查找對應數據源。指數變更及時程請參閱適用的指數價格公告。市場休市期間的處理方式依上文指數規則執行。

股票拆分與反向拆分常見問題

詳情請參閱 Help Center：Stock Splits and Reverse Stock Splits for TradFi Perpetual Contracts。

Q1：調整期間合約在 instrumentInfo 中的狀態是什麼？

調整窗口期間，查詢可交易產品的規格信息中的合約狀態仍為 "Trading"，但調整期間會暫停交易。請按公告中的暫停及恢復時間判斷交易是否可用，不應僅依賴此欄位。

Q2：調整窗口期間價格數據會如何？

Bybit 將停止推送行情。
不會繼續推送最後一個價格——調整窗口期間沒有任何市場數據更新。

Q3：調整完成後，Bybit 是否提供調整前的歷史行情，還是直接刪除？

歷史 K 線價格將按拆分比例進行相應調整。個人交易記錄（您自己的委託及成交記錄）不會發生變化。

Web UI 入口與 API 支持範圍​

TradFi（Futures、Options 與 CFD）​

Trade（Spot、Futures 與 Options）​

透過 API 查詢 TradFi 產品​

TradFi Futures：按 symbolType 篩選​

Options：先查基礎幣種，再查具體合約​

xStocks：相關現貨產品​

代幣化黃金：XAUT 現貨​

代幣化黃金：永續與交割合約​

CFD：MT5 產品​

法律條款審閱​

母帳戶簽署協議​

方式一：透過 Web UI​

方式二：透過 API​

HTTP 請求​

請求參數​

響應參數​

請求示例​

響應示例​

透過現有 API 交易​

指數價格計算規則​

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

股票拆分與反向拆分常見問題​