Skip to main content

Flash Swaps

Quickswap flash swaps allow you to withdraw up to the full reserves of any ERC20 token on Quickswap and execute arbitrary logic at no upfront cost, provided that by the end of the transaction you either:

  • pay for the withdrawn ERC20 tokens with the corresponding pair tokens
  • return the withdrawn ERC20 tokens along with a small fee

Flash swaps are incredibly useful because they obviate upfront capital requirements and unnecessary order-of-operations constraints for multi-step transactions involving Quickswap.

Examples#

Capital Free Arbitrage#

One particularly interesting use case for flash swaps is capital-free arbitrage. It's well-known that an integral part of Quickswap's design is to create incentives for arbitrageurs to trade the Quickswap price to a "fair" market price. While game-theoretically sound, this strategy is accessible only to those with sufficient capital to take advantage of arbitrage opportunities. Flash swaps remove this barrier entirely, effectively democratizing arbitrage.

Imagine a scenario where the cost of buying 1 ETH on Quickswap is 200 DAI (which is calculated by calling getAmountIn with 1 ETH specified as an exact output), and on Oasis (or any other trading venue), 1 ETH buys 220 DAI. To anyone with 200 DAI available, this situation represents a risk-free profit of 20 DAI. Unfortunately, you may not have 200 DAI lying around. With flash swaps, however, this risk-free profit is available for anyone to take as long as they're able to pay gas fees.

Withdrawing Matic from Quickswap#

The first step is to optimistically withdraw 1 Matic from Quickswap via a flash swap. This will serve as the capital that we use to execute our arbitrage. Note that in this scenario, we're assuming that:

  • 1 ETH is the pre-calculated profit-maximizing trade
  • The price has not changed on Quickswap or Oasis since our calculation

It may be the case that we'd like to calculate the profit-maximizing trade on-chain at the moment of execution, which is robust to price movements. This can be somewhat complex, depending on the strategy being executed. However, one common strategy is trading as profitably as possible against a fixed external price. (This price may be e.g., the average execution price of one or more orders on Oasis.) If the Quickswap market price is far enough above or below this external price, the following example contains code that calculates the amount to trade over Quickswap for maximum profit: ExampleSwapToPrice.sol.

ExampleSwapToPrice.sol

Trade at External Venue#

Once we've obtained our temporary capital of 1 ETH from Quickswap, we now can trade this for 220 DAI on Oasis. Once we've received the DAI, we need to pay Quickswap back. We've mentioned that the amount required to cover 1 ETH is 200 DAI, calculated via getAmountIn. So, after sending 200 of the DAI back to the Quickswap pair, you're left with 20 DAI of profit!

Instant Leverage#

Flash swaps can be used to improve the efficiency of levering up using lending protocols and Quickswap.

Consider Maker in its simplest form: a system which accepts ETH as collateral and allows DAI to be minted against it while ensuring that the value of the ETH never drops below 150% of the value of the DAI.

Say we use this system to deposit a principal amount of 3 ETH, and mint the maximum amount of DAI. At a price of 1 ETH / 200 DAI, we receive 400 DAI. In theory, we could lever this position up by selling the DAI for more ETH, depositing this ETH, minting the maximum amount of DAI (which would be less this time), and repeating until we've reached our desired leverage level.

It's quite simple to use Quickswap as a liquidity source for the DAI-to-ETH component of this process. However, looping through protocols in this way isn't particularly elegant, and can be gas-intensive.

Luckily, flash swaps enable us to withdraw the full ETH amount upfront. If we wanted 2x leverage against our 3 ETH principal, we could simply request 3 ETH in a flash swap and deposit 6 ETH into Maker. This gives us the ability to mint 800 DAI. If we mint as much as we need to cover our flash swap (say 605), the remainder serves as a safety margin against price movements.

Developer resources#