User Guide: Swaps
Does this article need to be translated?
MetaMask Swaps is a MetaMask feature that allows you to do exactly that: swap one cryptocurrency token for another (for more on ERC-20 tokens and the difference between these and NFTs, see our user guide). It's super convenient and straightforward, and drastically reduces the number of steps needed, and the amount of exposure to third-party smart contracts, in order to obtain tokens that interest you.
You can use MetaMask Swaps either on MetaMask Extension, MetaMask Mobile, or MetaMask Portfolio. Here are the networks Swaps is currently available on:
- Ethereum mainnet
- BNB Smart Chain
- Avalanche C-Chain
- Polygon
- Optimism
- Arbitrum
- zkSync Era (Extension and Mobile only)
- Linea
- Base (Portfolio and Extension only)
Things to know before swapping:
- Even if a token complies with the ERC-20 standard, you shouldn't buy or obtain a token without researching it first. One of the novelties of cryptocurrencies and decentralized finance is their programmatic nature; a token isn't necessarily a static asset; it may have functions that can affect how it is used, or how it affects your wallet — like this, for example. Of course, there are other less malicious caveats: for example, some tokens you can acquire, but to gain the utility intended from them, you need to stake them on a specific platform.
- Slippage is the amount of change between the price you click on and the final transaction price that MetaMask Swaps will tolerate. Given the highly liquid and fluctuating nature of decentralized finance and cryptocurrencies, prices can change from second to second. This is why Swaps allows a little bit of a difference between the price you agree on and the final price, to ensure your transaction goes through — but not too much, in order to protect you from sudden spikes or drops.
- Custom tokens is what MetaMask calls tokens that aren't common or widespread enough to be in MetaMask's standard list of tokens, which are detected by default when you have Ethereum mainnet (and a handful of other popular networks) selected as your network in MetaMask. If you swap some tokens into your wallet, but don't see them (after a few minutes — remember, blockchain is fast, but it's not instantaneous), try adding the tokens manually.
- Our support articles are for MetaMask Swaps only. In other words, MetaMask provides support for the swaps that happen through the use of the MetaMask Swaps button. If you are performing swaps directly on a different platform or another DEX, MetaMask may provide some general orientation or guidance, but it should not be considered definitive; reach out to the support team or community for the exchange or platform where you are swapping for assistance.
Remember: MetaMask is only an intermediary in your swap!
When you use MetaMask Swaps, bear in mind that MetaMask is acting as an aggregator or intermediary: we pull together quotes and offer you the most advantageous one. From there, you can decide whether or not to proceed with the transaction with the platform/liquidity provider at hand. MetaMask does not provide the liquidity, execute the trade, or sell you tokens.
Ready to dive in?
It doesn't matter whether you're on MetaMask Extension or Mobile, getting the tokens you want is only a few clicks—or taps—away.
You can also use Swaps in MetaMask Portfolio. The steps are almost identical to Swaps in MetaMask Extension. In any case, the concepts listed below apply to all platforms.
On the main MetaMask screen, look for a button marked 'swap'. Smash that button!
You'll be presented with the main Swap screen:
- Extension
- Portfolio
- Mobile
Preparing your Swap
- First, choose the token that you have, that you're willing to 'spend', using the drop-down menu at the top.
- Further down, choose the token you're interested in acquiring using the second drop-down menu.
- Adjust the amount of the first token up or down until you're comfortable with the amount you're spending, and the amount you're acquiring.
You'll see the app go through a process of searching for the best price. This process is the secret ingredient in making MetaMask Swaps the cheapest and best swapping service out there. There's a lot going on behind the scenes while you're watching Swaps search.
First of all, Swaps is searching across decentralized token exchanges and token swapping protocols to find you the most advantageous exchange rate.
At the same time, it's running test transactions, checking to make sure that if you do end up submitting a transaction, that it's likely to go through — and if not, those options are filtered out. MetaMask is saving users here from the pain of a failed transaction: with Ethereum mainnet gas fees and the complexity of token smart contracts, a failed transaction adds a significant financial injury to the insult of an incomprehensible error code. Swap's failure rate is very low, and improvements are in the works to make it almost nonexistent.
Some eagle-eyed users will have noticed on the previous screen, in the lower left-hand corner, a mention of "2% slippage". Slippage is yet another parameter that Swaps is using in your favor, and it's explained in more detail up above.
So with that DeFi number-crunching done, you get the quote screen:
Executing your Swap
There's kind of a lot going on here, but don't be alarmed. First of all, up at the top, you'll see that Swaps is continuing to do all the work that we mentioned previously on an ongoing basis, ensuring that you're getting the most up-to-date price and availability.
The main feature is in the middle of the screen: the amount of tokens that you are going to acquire (keeping in mind slippage) as of the last quote. You can see details such as the exchange rate, and optionally you can dive into how the quote got calculated, as well as advanced gas settings. That's a whole topic in and of itself (start here), but that's the amount the network is going to charge, plus MetaMask's fee.
If you're ready to go, smash that Swap swiper across the screen!
Why haven't my swapped tokens shown up in my wallet?
As with all blockchain transactions, it's not instantaneous, but you should see your tokens in your wallet soon. If they're uncommon tokens, or for whatever reason they're not showing up in your wallet, follow our instructions here to add them.
Send and swap crypto at the same time
Whenever you're sending funds from one account to another, you can choose which token you want to spend and select the token the other person wants to receive. This way, you won't have to first swap one token for another and then create another transaction to send it someone's way; saving you both time and gas.
To use MetaMask's 'Send & Swap' feature:
- Open your MetaMask interface and click 'Send'.
- Select the address you wish to send funds to.
- Choose the asset you wish to send from your account.
- Choose the asset you wish the recipient account to receive.
- Review the quote, and confirm your transaction!
This feature is currently available on MetaMask Extension, with MetaMask Mobile and Portfolio coming soon. Please note that this method does not yet support Smart Transactions.
Swap to an exact output amount
Now, instead of only choosing how much of a token you want to swap, you can specify the exact amount of funds you want the recipient to receive. This automatically calculates and fills in the necessary amount of tokens you need to send.
This feature is currently available on MetaMask Portfolio, with MetaMask Extension and Mobile coming soon.
Enter the SwapVerse
One of the truly incredible things about MetaMask, and one of the reasons that it can offer you such an unparalleled token-swapping experience, is that it is built to be network-agnostic: as long as the blockchain network you're connecting to is Ethereum-compatible, you can configure MetaMask to work on it. So what?
So you can use MetaMask swaps on other networks, too. You don't have to be on Ethereum mainnet; you can use Swaps on Polygon, for example. As other sidechains and custom networks come online, try it out. Swaps enables you to trade tokens on any Ethereum-compatible network, right from your wallet, without having to interface directly with third-party platforms, thus lessening your exposure to potentially hackable or malicious smart contracts.
You even have the ability, through Swaps, to acquire non-Ethereum tokens on mainnet. But remember: always navigate the multiverse through bridges and portals.
FAQs
Why are some tokens missing from MetaMask Swaps?
How do I see the price at time of purchase for tokens bought through MetaMask Swaps
Why did my MetaMask swap fail?
How do I cancel a pending swap?
Why is the MetaMask Swap button unavailable / greyed out?
I did a swap, but received fewer tokens or less fiat value than I expected. Why?