Guide: How to Provide Liquidity
Use a supported wallet.
See Wallet Support for a full list.
Get the correct Pool Address.
Go to Pools & Pool Addresses and copy the "Add/Remove Liquidity" address listed for the pool you'd like to use.
Get liquidity provider tokens quote (optional).
Go to the Liquidity page and click the "Test it" button for the "Get LP deposit quote" API.
Enter the two token symbols of the pool you'd like to add to, in the space for tokenA and tokenB and click "Send".
In the response you'll see fields instrument_1_to_deposit and instrument_2_to_deposit. These show the amounts of token A and B to send to the Pool Address in order to add liquidity, in the correct ratio, without exceeding either limit specified in the request.
Increase or decrease the instrument1amount and instrument2amount parameter values until you reach an acceptable amount of tokens in the response of the API, matching your available tokens on-hand to deposit.
Which token is instrument_1 and which is instrument_2?
It doesn't matter which order you specify for tokenA and tokenB in the request – the API will return the same result. This is because instrument_1 and 2 are predefined on the pool, and do not correlate directly to the order of tokens as entered in the request.
Generally you can tell which token is instrument_1 and which is 2 by the ratio of the amounts required to be deposited. The instrument with the smaller amount is the more expensive token, and vise versa.
The lp_tokens_to_mint field of the API response shows how many LP tokens are currently expected* in return if you deposit both assets in the amounts shown.
*Important
Quoted amounts are not a guaranteed promise of return. Factors like protocol use, among others, may result in receiving a different number of tokens than quoted.
Excess Tokens
If you send too much or too little of either token, Tradecraft will accept the amounts available in the correct ratio, and automatically return the rest to you.
Send both tokens to the Pool Address & receive LP tokens.
From your wallet, offer a transfer of both tokens to the Liquidity Address from step 2.
In less than a minute you should receive new liquidity provider (LP) tokens, named "TC SYMBOL/SYMBOL LP". Remember to approve the incoming transfer.
These LP tokens represent your share of the liquidity pool, and if sent back to the Magic Address, will initiate the return of your share of the pool's underlying tokens.
Congratulations, you are now a liquidity provider!
Need help? Check out our Frequently Asked Questions.
Last updated
Was this helpful?