Skip to main content

TradFi Integration

This guide explains how to integrate with Bybit's TradFi (Traditional Finance) products via the existing V5 API, including how to distinguish between MT5-based instruments and Bybit-native equity perpetuals, how to sign required agreements, and how to trade.

Distinguish MT5 & Equity Perp Listing​

Bybit offers two paths for trading traditional assets:

TradFi (MT5-based)​

Access via the Web UI: navigate to Trade → TradFi. This section covers forex, commodities, and stock CFDs powered by the MT5 engine.

TradFi Web UI Entry

Bybit Platform (Native)​

Access via the main Trade menu. This includes all standard Bybit product types:

  • Spot: xStock tokens (e.g., TSLAX, AAPLX, GOOGLX)
  • Futures: Stock perpetuals (e.g., TSLAUSDT), metals perpetuals (XAU, XAG), crude oil perpetuals
  • Options: Options contracts settled in USDT, including tokenised gold options (XAUTUSDT-Options)

Bybit Trading Menu

Before trading traditional asset perpetuals, please review the applicable terms and conditions:

Sign Agreement by Main Account​

To trade commodity contracts (metals and crude oil) or stock perpetuals, users must first sign the trading agreement. Stock perpetuals share the same agreement as metals. This can be done in two ways:

Option 1: Via Web UI​

When attempting to trade for the first time, a Trading Terms pop-up will appear. Check the checkbox and click Confirm to accept.

info

Only the master account can sign the agreement via Web UI. Please ensure you are logged in with the master account.

Trading Terms Agreement Pop-up

Option 2: Via API​

Use the Sign Agreement endpoint to sign programmatically.

info
  • Only the master account can sign the agreement. Subaccounts are not supported for this action.
  • Once the master account has signed, all subaccounts will be eligible to trade.
  • The API key must have at least one of the following permissions: Account Transfer, Subaccount Transfer, or Withdrawal.

HTTP Request​

POST/v5/user/agreement

Request Parameters​

ParameterRequiredTypeComments
categoryfalseinteger2: Metals commodity contracts (XAU & XAG). Stock perps share this agreement
3: Crude oil commodity contract
Either category or categoryV2 is required. This field remains supported, but new enum values will no longer be added here — use categoryV2 instead.
categoryV2falseinteger1: Metals commodity contracts (XAU & XAG). Stock perps share this agreement
2: Crude oil commodity contract
Either category or categoryV2 is required. Recommend using this field; new enum values will be added here going forward.
agreetruebooleantrue

Response Parameters​

None

Request Example​

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
}

Response Example​

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

Index Price Rollover Mechanism​

The index price of perpetual futures is derived from the respective underlying futures contracts. As commodities do not have a traditional spot market, the external reference price is determined based on designated futures contracts.

Before the underlying contract expires, a rollover (contract transition) is performed: the reference price gradually shifts from the front-month contract to the next-month contract over several days, according to a predefined weight schedule.

The weight allocation during the rollover period follows this schedule:

DayFront-Month WeightNext-Month Weight
Day 180%20%
Day 260%40%
Day 340%60%
Day 420%80%
Day 50%100% (Rollover Completed)

For example, CLUSDT (Crude Oil) uses this mechanism to transition between its designated underlying futures contracts (e.g., from WTIK6 to WTIM6).

info

For the latest rollover schedules and full details, please refer to the Help Center article: Introduction to TradFi Perpetual Contracts.

To query the current components and their weights contributing to an index price, use the Get Index Price Components endpoint:

GET/v5/market/index-price-components

Query parameter: indexName={symbol}

The response includes each component's exchange, spot pair, equivalent price, multiplier, and weight used in the index calculation.

Instruments Info for xStock, Stock & Commodities​

Use the Get Instruments Info endpoint together with the symbolType filter to retrieve trading rules and metadata for TradFi instruments. See the symbolType enum for all supported values.

GET/v5/market/instruments-info
ProductcategorysymbolTypeExample SymbolsNotable Fields
xStock tokensspotxstocksTSLAXUSDT, AAPLXUSDT, NVDAXUSDTxstockMultiplier
Stock perpetualslinearstockTSLAUSDT—
Commodity perpetualslinearcommodityXAUUSDT, XAGUSDT, CLUSDT—

Stock and commodity perpetuals return standard linear contract fields (leverage, tick size, funding interval, etc.).

Example request:

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

Trade via Existing API​

After signing the agreement, you can trade TradFi-related instruments (metals perpetuals, crude oil perpetuals, etc.) using the standard Trade endpoints. No separate API is needed — use the same order placement, amendment, and cancellation interfaces:

Simply pass the appropriate category and symbol in your request:

  • xStock tokens: category=spot, symbol e.g., TSLAXUSDT, AAPLXUSDT
  • Stock perpetuals: category=linear, symbol e.g., TSLAUSDT
  • Metals perpetuals: category=linear, symbol e.g., XAUUSDT, XAGUSDT
  • Crude oil perpetual: category=linear, symbol: CLUSDT