How to Add Liquidity
This page offers step-by-step instructions on how to provide liquidity to a Maverick Pool.
When you add liquidity to Maverick for the first time, you will mint a Maverick Position NFT. This NFT stores the details of all your liquidity positions on Maverick, and is used to manage and remove that liquidity. The wallet that holds a Maverick Position NFT controls the liquidity associated with that NFT. Do not transfer or sell your Maverick Position NFT unless you want to give control of the liquidity to another wallet.
Users add liquidity to Maverick using the Pools page, which can be accessed from the menu at the top of the screen. Adding liquidity consists of three steps:
Let's look at each step in turn.
The Pools page.
Once you have navigated to the Pools page, the first step is to select the pool you want to add liquidity to. The Pools page will present a list of pools that have already been deployed. You can choose a pool from this list, or click the Create New Pool button in the upper right to deploy a new pool. In this guide we'll assume you're choosing an existing pool from the list. To deploy a new pool, follow our guide.
In order to add liquidity to a pool, you will need to hold at least one of the two pool tokens in your wallet. You can choose a pool from the list that includes tokens you already hold, or go to the Swap page to acquire tokens you will need for a pool.
The Select Pool page.
Click a pool will take you to the Select Pool screen. If you want, you can change the token pair you want to add liquidity to using the drop-down menus (1). You can also select a fee tier and bin width at which to add your liquidity. For more information on fee tiers, see the section in the FAQ.
If you want to change the fee tier and bin width, you can click the Edit button (2). This will open a modal where you can choose between pools for the selected tokens based on fee tier and bin width.
This modal lets you choose between pools based on fee tier and bin width. The checkmark indicates which pool you have selected.
The modal lets you choose between pools that have already been deployed and pools that are not yet deployed. If a pool is deployed, it means that at least one other user has added liquidity to that pool. Pools that are not deployed have no liquidity in them and therefore are not yet active. If you use this modal to select a fee tier and bin width that has not yet been deployed, you will have to deploy the pool yourself.
Since there is a wide range of possibilities for combining different fee tiers and bin widths, it is unlikely that all combinations will have been deployed. For the purposes of this guide, we will assume you want to pick from a pool that is already deployed. If you want to deploy a new pool, please see our separate section on Deploying a New Pool.
The modal sorts pools in ascending order, first by fee tier and then by bin width. You can select the fee tier and bin width you want by clicking on it. This will cause a checkmark to appear by that pool, indicating your selection. Once you've chosen the pool you want, you can click the Select button to confirm your choice and close the modal.
The UI will load information about your chosen token pair and fee tier in the windows on the right, including TVL, volume, and an overview of the current liquidity distribution in that pool. If everything looks good, click Next (3) to continue.
The Select Mode page.
On the next page, you can select the liquidity mode. If you haven't already, now would be a good time to review our section on Understanding Modes. The Select Mode page presents a brief explanation of each Mode and accompanying video, but the section here goes into a lot more detail.
Select the desired Mode for your liquidity, then click Next to continue. Alternatively, you can click Back to return to the Select Pool page and change your token pair and/or fee tier.
In the final step, you choose how much liquidity to add from your wallet, as well as how that liquidity will be distributed within the pool.
Maverick AMM provides a lot of options for configuring liquidity distributions. Here, we'll walk through the basic mechanics for adding liquidity, starting with the three movement modes and then looking at Mode Static. Again, if you need help understanding Modes, please see the relevant section in this guide.
The Add Liquidity page, with Mode Right selected. Since the bin to the left of the active bin is selected, only USDC is required.
The screenshot above shows the Add Liquidity page after a user has selected Mode Right. The two token boxes on the left (1) are used to set the overall amount of liquidity you wish to add to the pool. These are interactive with the distribution chart on the right, meaning that the AMM will automatically compute the correct ratios of the two tokens required by your current distribution.
The default state for Mode Right is to add liquidity to the bin directly to the left of the current active bin. Since this bin isn't active, it will consist entirely of the left/base token (here, USDC). This means that the current distribution will only require you to deposit USDC, so adjusting the amount of USDC in the token box on the left will have no effect on the other token box (here, USDT).
You can adjust the amount of USDC being added by grabbing the top of the bin (2) and dragging it up and down. in height corresponds to amount of liquidity in the bin, and as you move the bin heights you will see the amounts on the left change accordingly. Since the bin we're looking at contains only USDC, changing its height will only change the amount of USDC to be added.
In Mode Right, you can instead choose to add liquidity to the current active bin. To do this, click on the tab for that bin (3) and drag it up. The active bin will contain both tokens, and so once it is active you will need to deposit quantities of both. In this example, if we activated this bin we would see the amount of USDT increase in the token box on the left.
The bins for the three movement Modes behave similarly, with these important differences:
- Mode Right: starts with bin to left of active bin, active bin can be staked as well
- Mode Left: starts with bin to right of active bin, active bin can be staked as well
- Mode Both: starts with active bin, bin to right and/or left can be staked as well
Default bins were chosen for what is theoretically the ideal use-case for each Mode, but we also wanted to give users the flexibility to find other uses for all of the Modes.
The Add Liquidity page, with Mode Static selected.
The screenshot above shows the Add Liquidity page after a user has selected Mode Static. The two token boxes on the left (1) are used to set the overall amount of liquidity you wish to add to the pool. These are interactive with the distribution chart on the right, meaning that the AMM will automatically compute the correct ratios of the two tokens required by your current distribution.
You can use the Edit button (2) in the Select Distribution section to choose an initial distribution model for you to use or customize. The options are:
- Single Bin
You can also edit the Distribution Width (3) to change the overall width of your distribution across the pool's price range. By default, this is set to 0.1%, meaning that your distribution will span 0.1% of the total price range, plus the current active bin as a center point. The UI will automatically calculate the number of bins required to cover this width. The number of bins required will depend on the bin width in the pool (the wider the bins, the fewer will be required to cover the width of your distribution). A pool with a 0.01% bin width will require 11 bins to cover a distribution width of 0.1% (10 bins plus the current active bin).
Larger distribution widths will cost more gas. Please keep this in mind when adjusting your distribution width.
If you want to change the Distribution Width, edit the numeric field at (3) and then click the Update button. The distribution chart will refresh to show the new distribution.
You can tweak the shape of any of the distributions by clicking the top of a bin (e.g., at (4)) and dragging the bin up and down. Bin height corresponds to amount of liquidity in the bin, and as you move the bin heights you will see the amounts on the left (1) change accordingly. The active bin contains both tokens, so moving it will affect both token amounts. The bins to either side of the active bin are single token bins, so will only affect one of the tokens.
Once you have finished customizing the size and distribution of your position, you can click Confirm to continue.
Please note, the first time you use any token on Maverick, you will be asked to Approve that particular token. UI buttons like Swap/Confirm Amount will show as Approve [Token] until that token has been approved. Approving a token requires you to confirm the choice in a software cryptocurrency wallet pop-up. You may also need to set an appropriate spending allowance. Read more here.
The Confirm Pool modal.
Clicking the Confirm button will open the Confirm Pool modal. This modal will walk you through the final steps necessary to add liquidity to the pool. If you have yet to approve either token on Maverick, you will first be asked to approve them. In the screenshot above, USDC and LINK have already been approved, so the modal has advanced to the third step.
The modal will present a summary of your proposed transaction, including the amounts of each token to be deposited from your wallet, the chosen Fee Tier for your pool, and the Mode you are using for your liquidity. If everything looks correct, click Confirm Amount to send the transaction to MetaMask for approval. If you need to edit something, you can click the X at the top right of the modal to return to the Add Liquidity flow.
If you click Confirm Amount, a pop-up window should appear asking you to confirm the transaction in your wallet. Confirm the transaction. After a short wait, you will see a green pop-up window that reads "Add Liquidity Successful." You can now choose to review the transaction on Explorer or close the modal to be taken to the Portfolio page, where you can track all of your liquidity positions on Maverick.