Appearance
Swap
Swap (shown to users as Convert) turns one coin into another in one step, without using the order book screen. Behind the scenes it's a market order on the pair that links the two coins.
Page: Swap (/swap).
How users convert
- From: pick the coin to spend, and enter the amount (or Max). The Available balance is shown.
- To: pick the coin to receive. Switch swaps the two. Picking the same coin on the other side flips the pair.
- Check the Rate and the Estimated amount.
- Convert. The page shows "Searching orders with best rate…", then "Your order was processed. Please check your wallet and transaction history to get a report."
The coins come from and go to the user's Trading Account (Wallets). The swap appears in their order and trade history.
Which coins can be swapped
Only pairs that have an active market can be swapped: BTC → USDT works if BTC-USDT exists, in either direction. If no market links the two coins, the rate shows N/A.
The pair selected when the page opens is the Default swap market in General settings.
Rate, fees and limits
| Rate | The market's current price. The final amount can differ slightly from the estimate, because the order fills at the prices in the book at that moment. |
| Fee | The user's spot taker fee from their VIP level, like any market order |
| Limits | The market's trading rules: minimum and maximum amount and value (Markets → Trading rules) |
| Availability | Refused when the market is halted, trading is paused, or maintenance mode is on |
"0 Fees" on the Swap page
The Swap page shows 0 Fees and Instant Execution as selling points. Swaps do pay the taker fee. Set the taker fee to 0, or change the text in Languages, so the page tells the truth.
Fixed-rate swaps
By default a swap needs orders in the book to fill against. With FIXED_SWAP=true in .env, a swap is filled at the market's last price instead, even when the book is empty. The market must have a last price, or the user sees "Not enough liquidity".
Use it for markets without a liquidity provider where the book is often thin. There's no other user on the other side of a fixed-rate swap: the user's coins are converted at the last price, and your exchange carries that position. Make sure you hold enough of both coins to cover what users swap into.
