Skip to main content
Understanding fee retention, developer fees, and supported currency/rail pairs.

​
Overview

This integration supports two integration types — BYBIT and PASS_THROUGH — each with different settlement strategies, supported currency/rail pairs, and fee structures.

​
Integration Types

​
PASS_THROUGH with FEE_RETENTION

Used for native crypto-to-crypto settlements where fees are deducted from the deposit before settlement.
  • integration_type = PASS_THROUGH
  • settlement_via = FEE_RETENTION
  • rebalance_fee must be false
Supported currency/rail pairs:
CurrencyRailMinimum Order Amount
BTCBITCOIN0.00005 BTC
ETHETHEREUM—
USDTTRON—
Settlement formula: 
settlement_amount = order_amount - total_fee
total_fee = gas_fee + developer_fee + payment_fee + conversion_fee + withdrawal_fee

​
BYBIT with ONE_TO_ONE

Used for stablecoin settlements where order and destination currencies match.
  • integration_type = BYBIT
  • settlement_via = ONE_TO_ONE
  • rebalance_fee can be true or false
Supported destination currency/chain pairs:
CurrencyChain
USDCSOLANA
USDCETHEREUM
USDCBASE
Supported order currency/chain pairs:
CurrencyChain
USDCSOLANA
USDCETHEREUM
USDCBASE

​
BYBIT with MARKET_ORDER

Used when the order currency differs from the destination currency.
  • integration_type = BYBIT
  • settlement_via = MARKET_ORDER
Supported destination currency/chain pair:
CurrencyChain
PYUSDSOLANA
Supported order currency/chain pair:
CurrencyChain
USDTSOLANA

​
Minimum Order Amounts

PairMinimum Amount
SOL <> USDC3 USDC
ETH <> USDC7 USDC
BASE <> USDC3 USDC
SOL <> PYUSD3 USDT
BTC <> BITCOIN0.00005 BTC

​
Developer Fee

The developer_fee object allows you to charge an additional fee on top of platform fees. It is only applicable for FEE_RETENTION settlement. 
"developer_fee": {
  "fixed": "0.15",       // optional, default is 0
  "percentage": "2.5"    // optional, default is 0
}
  • The entire developer_fee object is nullable (defaults to 0)
  • fixed is nullable (defaults to 0)
  • percentage is nullable (defaults to 0)
  • total_developer_fee = fixed + (percentage x total order amount)
  • total_fee = total_developer_fee + all other fees

​
Quotation Endpoint Rules

Currency/Railintegration_typesettlement_viarebalance_fee
USDC.solanaBYBITONE_TO_ONEtrue or false
USDT.tronPASS_THROUGHFEE_RETENTIONfalse
BTC.bitcoinPASS_THROUGHFEE_RETENTIONfalse
ETH.ethereumPASS_THROUGHFEE_RETENTIONfalse
Warning: Setting rebalance_fee: true for PASS_THROUGH + FEE_RETENTION will throw an error.

​
Create Payment Rules

​
With quote_id

  • order_amount field and fin object must be null

​
With order_amount

  • quote_id must be null
  • fin object must be provided and valid
Warning: Providing both order_amount and quote_id results in a 422 error. Providing both quote_id and fin object results in a 422 error.

​
Response Differences by Integration Type

Integration TypeResponse Field
BYBITdata.provider_response
PASS_THROUGHdata.deposit_instruction