1.2 Cross-chain Quota and Fees
Last updated
Last updated
The available quota for each token must be queried separately. The API endpoint is as follows:
Use the values returned by the tokenPairs
API for fromChainType
, toChainType
, and symbol
in the request parameters.
Example:
Response Example:
Usage Notes
Choose the appropriate chainType
based on the desired cross-chain direction.
For instance, when transferring from Arbitrum to BSC, set fromChainType=ARETH
and toChainType=BNB
. Conversely, when transferring from BSC to Arbitrum, use fromChainType=BNB
and toChainType=ARETH
.
The maxQuota
value in the response is expressed using the decimals of fromToken
.
The fee API returns two types of fees:
networkFee: Charged in the native token of the blockchain (e.g., ETH on Ethereum, BNB on BSC).
operationFee: Charged in the token being transferred (e.g., USDT is charged when it is being transferred).
Fee Calculation Rules
If isPercent
is false
, the fee is charged as a fixed amount based on the value
field.
If isPercent
is true
, the value
represents a percentage and must be multiplied by the transfer amount.
When fees are percentage-based, minFeeLimit
and maxFeeLimit
define the minimum and maximum fee thresholds.
API Endpoint:
Use the values from tokenPairs
for fromChainType
, toChainType
, and tokenPairID
.
Example 1: Querying Fees for USDT Transfer from Arbitrum to Ethereum
Response Example:
This means a network fee of 7000000000000000
wei (0.007 ETH) is charged on Arbitrum.
Example 2: Querying Fees for BTC Transfer from Ethereum to Bitcoin
Response Example:
This means no network fee is charged, and BTC is charged at 0.6% of the transfer amount, with a minimum fee of 35000 satoshis (0.00035 BTC) and a maximum fee of 50000000 satoshis (0.5 BTC).
API Endpoint:
Example:
Response Example: