Skip to main content
Swapping between different ERC20/native token currencies on a given Chain is made easy by Sequence’s Smart Swap API. Please make sure that your token pair has enough liquidity on a supported exchange such as UniSwap. Checkout this guide on how to add liquidity on UniSwap.

​
GetSwapPrice

This method can be used to get the current SwapPrice for a given buyCurrency and buyAmount using a given sellCurrency. 
ISwap swapper = new CurrencySwap(_chain);
SwapPrice swapPrice = await swapper.GetSwapPrice(buyCurrencyTokenAddress, usdcAddress, "1000"); // where USDC is an example sell currency
You can optionally subscribe to the OnSwapPriceReturn and OnSwapPriceError events in order to handle the response elsewhere. You can optionally provide a maximum allowable slippagePercentage.

​
GetSwapPrices

This method is similar to GetSwapPrice, it can be used to get the current SwapPrice for a given buyCurrency and buyAmount. Except, instead of providing a sellCurrency, you instead provide the user’s wallet address. This method will detect the eligible currencies (ERC20s or native tokens) that can be swapped for buyAmount of the buyCurrency and will return a SwapPrice[]. 
ISwap swapper = new CurrencySwap(_chain);
SwapPrice[] swapPrices = await swapper.GetSwapPrices(userWalletAddress, buyCurrencyTokenAddress, "1000");
You can optionally subscribe to the OnSwapPricesReturn and OnSwapPricesError events in order to handle the response elsewhere. You can optionally provide a maximum allowable slippagePercentage.

​
GetSwapQuote

This method is used to get an executable SwapQuote for a given userWallet address to buy buyAmount of buyCurrency using sellCurrency. 
ISwap swapper = new CurrencySwap(_chain);
SwapQuote quote = await swapper.GetSwapQuote(userWalletAddress, buyCurrencyTokenAddess, usdcAddress, "1000", true); // where USDC is an example sell currency
Once you’ve obtained a SwapQuote, you can transform it into a Transaction[] that can be submitted via your EmbeddedWallet to execute the swap. 
Transaction[] swapTransactions = quote.AsTransactionArray();

_wallet.SendTransaction(_chain, swapTransactions);
If includeApprove = true the SwapQuote response will also include the information required to create the required spend approval transaction(s). These will also be added to the Transaction[] created above via SwapQuote.AsTransactionArray(). As usual, with our embedded smart contract wallets, all of these transactions can be submitted at once in a bundle; significantly improving the UX for your players who would usually need to make separate transactions to approve and swap.
⌘I