Key Features
Currency Availability
Use the Get Tradable Currencies endpoint to display the list of tradable currencies supported by the platform. These are the only currencies allowed for swaps.Trading Pairs
Use the Get Pairs endpoint to retrieve the supported currency pairs for trading. For example, a supported trade pair might be BTC-USDT.Instant Swap
The simplest way to execute a trade. A single request to/trades/swap creates a quote and executes the trade immediately at the best available rate — no need to call create-quote and accept-quote separately.
Provide either amount (how much of the source currency you are selling) or amountToReceive (the exact amount of the target currency you want), but not both.
There are no extra charges for this service.
RFQ System
Use the two-step RFQ flow when you want to show users a confirmed rate before committing to the trade.- Create Quote: Obtain a quote by specifying source currency, target currency, amount, and side (BUY/SELL). The response includes the swap rate, the amount you’ll receive, and a validity window in seconds. For example, if you’re swapping 1,000 USDT to BTC, the quote will include the current rate (e.g., 67,648.9154 USDT per BTC) and show the amount you’ll receive in BTC (0.0478218 BTC).
- Validity Window: The quote must be accepted within this time window. If it expires, request a new quote.
-
Accept Quote: Pass the
quoteIdfrom the Create Quote response to confirm the swap. Funds are deducted from your source wallet and credited to your target wallet.
Transaction History
To review swap transactions, use the Get User Trades endpoint. You can filter by side (buy/sell), currency ID, and date.Key Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /currencies/tradeable | List of tradable currencies on our platform |
| GET | /trades/pairs | Retrieve supported currency pairs |
| POST | /trades/swap | Create and execute a swap in one request (instant swap) |
| POST | /trades/quote | Create a quote (RFQ flow) |
| POST | /trades/quote/{quoteId} | Accept a quote to complete the swap (RFQ flow) |
| GET | /trades/summary/me | Review transaction history |
Flow
Instant swap (recommended for most integrations):- Fetch tradable currencies and pairs
- Call
/trades/swapwith the source, target, and amount
- Fetch tradable currencies and pairs
- Call
/trades/quoteto get a rate and quote ID - Call
/trades/quote/{quoteId}within the validity window to confirm