↘️How to add liquidity

In this guide, you'll find the required steps to provide liquidity to ALEX DEX pools.

When adding liquidity, you will deposit an equivalent value of both tokens into the pool. In return, you'll receive LP tokens, which represent your share of that specific liquidity pool.

Ready to start? Let's get hands-on!

Step 1

Go to https://app.alexlab.co/ and click on navbar's Swap -> Pool tab.

Step 2

All available pools will be displayed including information such as:

• Trading Pair: The token pair that constitute liquidity pools to which you can add liquidity.

• Liquidity: The total liquidity in the pool, expressed in USD value.

• Volume: The trading volume between the token pair over the last 7 days. By hovering on the trading volume for a specific row/pool, the 24-hour volume is also displayed.

• Fee Rebate: Potential LP earnings from swap fees over a year, based on the last week's average. This metric, also known as Pool APR, reflects the potential profitability of participating in a pool over a year, assuming similar trading activity continues.

Select the token pair to which you want to add liquidity from the displayed list. Note you can sort by pool metrics.

Selected STX-ALEX liquidity pool as example.

When hovering over a pool, you might notice a "+LP" button. This serves as a visual indicator for the selected pool. Clicking it will take you to the same screen as clicking anywhere on the pool's row.

Step 3

After selecting a pool, you will be taken to a control panel for that specific liquidity pool, where you can add liquidity to the token pair and view more detailed metrics[^1].

When you set the amount for one token, the corresponding amount for the other token is automatically calculated, as liquidity must be provided in equal value for both tokens.

Need tokens? Visit the Token Swaps docs section and to learn how to exchange tokens on ALEX Lab platform.

Control panel example for STX-ALEX liquidity pool. Amount is set to 4 STX and ALEX token amount is automatically determined.

Clicking the "Max" button will automatically set the amount to your total available balance.

Step 4

If you want to adjust slippage, select the "Settings" icon to open the Transaction Settings panel and set your desired tolerance. The default slippage tolerance for non-stable swap token pairs is set to 4%, meaning your transaction will revert if the exchange rate changes unfavourably by more than this percentage. The displayed number of LP tokens you will receive is approximate due to this potential variation.

Transaction Settings icon.

Transaction Settings panel example, with slippage tolerance set to 3%.

Step 5

One you decide the amount, click the "Add" button. Confirmation panel will appear. Here you can double check balances, slippage and LP tokens. If everything it's okay, click "Confirm" 😎

Step 6

After clicking "Confirm", you will need to confirm the transaction in your wallet. Here, your Stacks wallet is interacting with ALEX smart contract and is asking you for approval. Scroll through the wallet transaction window, review it and confirm the transaction. By doing this, you are allowing the wallet to sign and broadcast the transaction.

To be completely sure, you can check:

• Transaction is requested by "Alex app" (app.alexlab.co)

• The amounts you will transfer to the smart contract, covered by Stacks post conditions. Note that one transfer amount is exactly determined (STX in the example) while the other is subject to a "less than or equal to" condition. This accounts the potential slippage variation, and here you can see the exact upper bound. If these conditions are not met, the transaction will abort.

Amounts to transfer and post conditions.

Function arguments and confirmation button.

Step 7

Wait for the transaction to be confirmed on the network.

Recommended to track transaction status:

• Turn on Telegram notifications, you will get notified when the transaction is confirmed.

• Search for the transaction on the ALEX Explorer.

• Check your address activity on the wallet.

Telegram message with transaction pending status.

Telegram message with transaction success status.

Transaction pending displayed on Leather wallet.

Transaction completed, token transfers are visible.

Step 8

After successfully adding liquidity, you will be able to see your LP tokens and related details in "My Liquidity" panel.

• My LP are your LP token holdings specific to the pool you contributed to. Each pool issues its own unique LP tokens.

• The Pooled amount represents your total token holdings in the liquidity pool. Initially, reflects the amount you added and it increases over time due to accrued fees, showing your updated share of the pool's total liquidity.

• The My Pool Share shows how much of the overall pool you own, as a percentage.

• The Indicative Value reflects the value of your holdings in USD, which can change based on the price action of the underlying assets.

"My Liquidity" panel.

You can find the "My Liquidity" panel above the Liquidity Pool control panel (shown in Step 3). A summarized version is also available under the Swap -> Pool tab or at https://app.alexlab.co/pool.