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.

Bybit Platform (Native)

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

• Spot: xStock tokens (e.g., TSLA, AAPL, GOOG)
• Futures: Metals perpetuals (XAU, XAG), crude oil perpetuals
• Options: Options contracts settled in USDT, including tokenised gold options (XAUTUSDT-Options)

Legal Review

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

• Derivative Contract Terms - TradFi Perps
• Derivative Contract Terms - Oil Perps

Sign Agreement by Main Account

To trade commodity contracts (metals and crude oil), users must first sign the trading agreement. 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.

Option 2: Via API

Use the Sign Agreement endpoint to sign programmatically.

HTTP Request

POST /v5/user/agreement

Request Parameters

Parameter	Required	Type	Comments
category	true	integer	2: Metals commodity contracts (XAU & XAG) 3: Crude oil commodity contract
agree	true	boolean	true

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.

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

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

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:

• Place Order
• Amend Order
• Cancel Order
• Get Open & Closed Orders
• Cancel All Orders
• Get Order History (2 years)
• Get Trade History (2 years)
• Batch Place Order
• Batch Amend Order
• Batch Cancel Order
• Get Borrow Quota (Spot)
• Pre Check Order

Simply pass the appropriate symbol (e.g., XAUUSDT, XAGUSDT for metals; oil-related symbols for crude oil contracts) and category in your request.