I. General Questions
What is Matcha Auto?
Matcha Auto is a new, proprietary transaction mode in which Matcha submits the transactions and handles the gas on users behalf. Matcha Auto offers the same great prices our app has always offered, while adding an extra layer of benefits. Here are a few reasons why you should use Matcha Auto:
Faster trade confirmation: Trades are 2x more likely to confirm on next block, improving trade execution. This is beneficial on all trades, but especially when users really need a trade to go through at that given time and market price.
Reduced failed trades by 85%: 98.5% success rate vs ~90% industry. Matcha also covers resubmission costs. Users can trade and forget, Matcha ensures the trade will go through.
Matcha handles the gas: Users can trade without holding native tokens, Matcha optimizes gas settings and uses the token they are selling or buying to fund the transaction. Users won’t need to fund wallets with native tokens just to perform a swap.
How can I use Matcha Auto?
Matcha Auto is enabled by default. You have the option of disabling it when you are at the transaction module widget making a Market Order swap (see image):
Click on the drop down arrow below the You Receive token amount in the trade module.
Click the toggle to switch from Auto to Standard.
If you want to go back to Auto, click the toggle again.
II. Technical Questions
How does Matcha Auto work?
Matcha Auto works by utilizing 0x’s Tx Relay API. The API enables meta-transactions on Matcha, which allows the app to submit the trade and handle the gas fees on behalf of users.
Meta-transactions refer to a mechanism that enables users to perform transactions on a blockchain network without directly paying the associated transaction fees in the native cryptocurrency. Instead, the transaction fees are paid by a third party or a relayer.
This is incredibly powerful as it allows users to engage in DeFI without needing to maintain a balance of native token. Users can trade on multiple chains without worrying about carrying necessary funds for each chain, removing a barrier to entry and onboarding more users to the world of web3.
To learn more about meta-transactions, check out these pages:
What tokens can I trade with Matcha Auto?
You can trade any ERC-20 tokens on Ethereum and Polygon, except native tokens for their respective blockchains (ETH and MATIC).
Can I still trade Native tokens with Matcha Auto?
Unfortunately, you cannot sell native tokens with Matcha Auto; you must wrap the native token or use Standard mode to sell native tokens (e.g. turn ETH into WETH). However, you can buy native tokens with Matcha Auto.
Why is the transaction fee one of the tokens I’m trading?
Any trade on the blockchain requires some sort of gas/fee to cover the cost of making the trade. Historically, native tokens would be spent as gas for the transaction.
With Matcha Auto, the intermediary that is facilitating the trade is spending their native token and in return, will take some portion of either the token you are paying with or the token you are receiving (see below for more details on this).
When you click on the Fee info button, you will see a modal like the one here:
Here is a breakdown of that modal:
You receive - this is the amount of the token you are purchasing before any fee has been deducted from the trade. You can think of this as the subtotal on a restaurant bill.
Gas cost - this is the fee that is normally paid with native token. With Matcha Auto, the gas cost is free!
Fee - this fee is the amount of the token that is taken by the intermediary from the overall transaction to facilitate the trade. Note: this fee also includes a 0.15% fee of the trade Matcha charges to facilitate the trade.
Total you receive - this is the final amount of the token you are purchasing that you will receive after the fee is administered. You can think of this as the final total on your restaurant bill.
How does Matcha Auto determine what token to use to cover the fee?
Depending on whether you are inputting a value in the You Receive token or in the Pay with token field, the token that will be taken to cover the gas fee will be from the opposite token input:
💰 Token Input | 🪙 Fee Token |
Pay with | You receive |
You receive | Pay with |
Can I select what token to use to cover the fee?
Unfortunately, you cannot. However, Matcha Auto does that for you so you don’t have to!
III. Troubleshooting
Why did I get a warning saying “Fees exceed the size of the trade”?
You received this message to inform you that network fees are significantly greater than how much you are trading. We will not let you make that trade without adjusting the amount of your trade first.
For example, if you are trading 10 $USDC for 10 $USDT on Ethereum with Matcha Auto, and the network fee is $20 to execute the trade, then we will require you to adjust your trade amounts.
Why is it saying "Insufficient Balance" when I have enough of my "Pay with" Token?
If you have sufficient balance in your wallet to sell this token, then the most likely reason why you are seeing this message (and cannot proceed) is because you input the amount you want to purchase in the You receive field.
This is happening because, based on where you input the value (in this case, You receive), our system will use part of the token you are selling as the fee to cover the cost of gas.
Because it's using the Pay with token for gas, it's subtracting the amount of token from your wallet to cover that gas cost.
If that amount for the gas, plus the amount you want to sell is greater than (or equal to) the amount in your wallet, our system will see that you don't have sufficient funds and will prevent you from trading.
In order to bypass this, simply input the value in the sell token (Pay with) field and you should be able to proceed.
I want to use Matcha Auto but it says it's not available for small trade sizes. What's the minimum trade size to use Matcha Auto?
Matcha Auto will not be available if you are attempting to make a trade where the network fee amount is greater than the trade size. For example, if you are trying to trade 1 USDC for 1 USDT, and the fee on Mainnet is $3, then Matcha Auto will not be available as an option and you will be prompted to increase the amount you want to trade.
We hope you enjoy using Matcha Auto in your trading adventures! For further questions, feel free to chat with our Support team by clicking the messenger icon in the bottom right hand corner.
Additional Resources: