Skip to content

Was this helpful?

Suggest changes to this page

Executing Swaps

Execute swaps between stablecoins on the exchange. Swaps execute immediately against existing orders in the orderbook, providing instant liquidity for cross-stablecoin payments.

By the end of this guide you will be able to execute swaps, get price quotes, and manage slippage protection.

Execute a Swap

demo

1

Create an account, or use an existing one.

2

Add testnet funds to your account.

3

Make Swaps

Swap implementation steps

Stablecoin swap recipes

Handling insufficient liquidity

Quote requests will fail with an InsufficientLiquidity error if there isn't enough liquidity in the orderbook to satisfy the requested amount.

Handle this error when fetching quotes:

import { Hooks } from 'wagmi/tempo'
import { parseUnits } from 'viem'
 
const alphaUsd = '0x20c0000000000000000000000000000000000001'
const betaUsd = '0x20c0000000000000000000000000000000000002'
 
function Swap() {
  const amount = parseUnits('10', 6

Stablecoin swap best practices

Always get quotes before swapping

Query the expected price before executing a swap to ensure you're getting a fair rate and to set appropriate slippage protection.

Set appropriate slippage protection

Use minAmountOut or maxAmountIn to protect against unfavorable price movements between quoting and execution.

Stablecoin swap learning resources

Exchange Balance

Learn about how the Stablecoin DEX interacts with your balances

Swap Execution Details

Learn about the technical details of swap execution

Set up your swap client

Ensure that you have set up your client by following the guide.

Get a price quote

Before executing a swap, get a quote to see the expected price.

import {  } from 'wagmi/tempo'
import { ,  } from 'viem'
 
const  = '0x20c0000000000000000000000000000000000001'
const  = '0x20c0000000000000000000000000000000000002'
 
function () {
  const  = ('10', 6)
 
  // How much AlphaUSD do I need to spend to receive 10 BetaUSD?
  const { :  } = ..
    : , 
    : , 
    : , 
  }) 
 
  return <>Quote: {(, 6)}</>
}

import {  } from 'wagmi/tempo'
import { ,

Calculate slippage tolerance

Set appropriate slippage based on your quote to protect against unfavorable price movements.

Approve stablecoin spend

To execute a swap, you need to approve the Stablecoin DEX contract to spend the token you're using to fund the swap.

Execute a swap

Batch the token approval with the swap in a single transaction for better UX.

import {  } from 'wagmi/tempo'
import { ,  } from 'viem'
 
const  = '0x20c0000000000000000000000000000000000001'
const  = '0x20c0000000000000000000000000000000000002'
 
function () {
  const  = ('10', 6)
 
  // How much AlphaUSD do I need to spend to receive 10 BetaUSD?
  const { :  } = ..({
    : ,
    : ,
    : ,
  })
 
  // Calculate 0.5% slippage tolerance
  const  = 0.005
  const  =  
    ?  * (.((1 + ) * 1000)) /
    : 0n
 
  return (
    <>
      <>Quote: {(, 6)}</>
      <>Max input (0.5% slippage): {(, 6)}</> 
    </>
  )
}

import {  } from 'wagmi/tempo'
import { ,  }

import { ,  } from 'viem/tempo'
import {  } from 'wagmi/tempo'
import { ,  } from 'viem'
import {  } from 'wagmi'
 
const  = '0x20c0000000000000000000000000000000000001'
const  = '0x20c0000000000000000000000000000000000002'
 
function () {
  const  = ('10', 6)
 
  // How much AlphaUSD do I need to spend to receive 10 BetaUSD?
  const { :  } = ..({
    : ,
    : ,
    : ,
  })
 
  // Calculate 0.5% slippage tolerance
  const  = 0.005
  const  = 
    ?  * (.((1 + ) * 1000)) /
    : 0n
 
  const  = () 
 
  return (
    <>
      <>Quote: {(, 6)}</>
      <>Max input (0.5% slippage): {(, 6)}</>
      < ="button" ={() => { 
        const  = [ 
          ...
            : , // Approve the max amount with slippage
            : ., 
            : , 
          }), 
        ] 
        .({  }) 
      }}> 
        Approve Spend 
      </> 
    </>
  )
}

import { ,  } from 'viem/tempo'
import {  } from 'wagmi/tempo'
import {

import { ,  } from 'viem/tempo'
import {  } from 'wagmi/tempo'
import { ,  } from 'viem'
import {  } from 'wagmi'
 
const  = '0x20c0000000000000000000000000000000000001'
const  = '0x20c0000000000000000000000000000000000002'
 
function () {
  const  = ('10', 6)
 
  // How much AlphaUSD do I need to spend to receive 10 BetaUSD?
  const { :  } = ..({
    : ,
    : ,
    : ,
  })
 
  // Calculate 0.5% slippage tolerance
  const  = 0.005
  const  = 
    ?  * (.((1 + ) * 1000)) /
    : 0n
 
  const  = ()
 
  return (
    <>
      <>Quote: {(, 6)}</>
      <>Max input (0.5% slippage): {(, 6)}</>
      < ="button" ={() => {
        const  = [
          ...
            : , // Approve the max amount with slippage
            : .,
            : ,
          }),
          ...
            : , 
            , 
            : , 
            : , 
          }), 
        ]
        .({  })
      }}>
        Execute Swap
      </>
    </>
  )
}

import { ,  } from 'viem/tempo'
import {  } from 'wagmi/tempo'
import {