Payment FxConvert

HTTP Request

POST /v5/bybitpay/fx/convert

Request Parameters

Parameter	Required	Type	Comments
merchantId	true	string	Onboarding merchant UID
merchantName	false	string	If not filled in, we will show users the name of your company doing KYB on the Bybit platform
clientId	false	string	Merchant client ID
paymentType	true	string	Payment type
orderAmount	true	string	Order amount
orderCurrency	true	string	Order currency (uppercase, e.g., EUR, USD, USDT)
orderCurrencyType	true	string	Currency type (fiat or crypto)
settleCurrency	true	string	Settle currency (USDT/USDC/BTC)
settleCurrencyType	true	string	Currency type (fiat or crypto)

Response Parameters

Parameter	Type	Comments
quotationId	string	Return result quotationId to create order
settleCurrency	string	Settle currency (USDT/USDC/BTC)
settleAmount	string	Order settle amount

Request Example

Crypto to Crypto (ETH to USDT)

POST /v5/bybitpay/fx/convert HTTP/1.1
Host: api2.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1736233200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "merchantId": "305142568",
    "merchantName": "Digital Store",
    "clientId": "client_001",
    "paymentType": "E_COMMERCE",
    "orderAmount": "0.5",
    "orderCurrency": "ETH",
    "orderCurrencyType": "crypto",
    "settleCurrency": "USDT",
    "settleCurrencyType": "crypto"
}

Fiat to Crypto (EUR to USDT)

POST /v5/bybitpay/fx/convert HTTP/1.1
Host: api2.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1736233200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "merchantId": "305142568",
    "merchantName": "Digital Store",
    "clientId": "client_001",
    "paymentType": "E_COMMERCE",
    "orderAmount": "100.00",
    "orderCurrency": "EUR",
    "orderCurrencyType": "fiat",
    "settleCurrency": "USDT",
    "settleCurrencyType": "crypto"
}

Crypto to Crypto (BTC to USDC)

POST /v5/bybitpay/fx/convert HTTP/1.1
Host: api2.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1736233200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "merchantId": "305142568",
    "merchantName": "Digital Store",
    "paymentType": "E_COMMERCE",
    "orderAmount": "0.01",
    "orderCurrency": "BTC",
    "orderCurrencyType": "crypto",
    "settleCurrency": "USDC",
    "settleCurrencyType": "crypto"
}

Response Example

Crypto to Crypto Response

{
    "retCode": 100000,
    "retMsg": "success",
    "result": {
        "quotationId": "QT1749825188001",
        "settleCurrency": "USDT",
        "settleAmount": "1250.50"
    }
}

Fiat to Crypto Response

{
    "retCode": 100000,
    "retMsg": "success",
    "result": {
        "quotationId": "QT1749825188002",
        "settleCurrency": "USDT",
        "settleAmount": "108.25"
    }
}