Get Liquidity Amounts
Get the amounts of tokens needed to provide liquidity to a pool based on the maximum you want to spend in one token. You can pass the max amount for both tokens and receive quotes for the two possible scenarios, this way you can check in a single call what option works based on the amounts your user has. E.g. your user wants to provide liquidity to the ETH-USDC pool, and they have 100 USDC and 100 ETH in their wallet. By passing both as the max amounts in `tokenXMaxAmount` you'll get two quotes. One telling how much ETH you need to provided if you send 100 USDC and another telling how much USDC you need to provide given 100 ETH. Then you can choose which one actually fits the liquidity your user has. **Note**: If only one of them is returned it means the price range is outside the current price, so only one token can be provided to create liquidity, the other will always be zero.
Authorization
x-api-key In: header
Query Parameters
Optional provider for entering a liquidity pool. If not provided, Uniswap v3 will be used.
Value in
- "UNISWAP_V3"
The blockchain network where the liquidity will be provided. Supported EVM chains:
- Arbitrum One: 42161
- Avalanche: 43114
- Base: 8453
- BNB Smart Chain: 56
- Ethereum: 1
- Gnosis: 100
- OP Mainnet: 10
- Polygon: 137
- X Layer Mainnet: 196
- Robinhood Chain: 4663
The address (in hexadecimal format) of one of the tokens of the pool.
The address (in hexadecimal format) of the other token of the pool.
Defines the fee earned by providing liquidity. Lower values are recommended for more stable tokens, while higher values are better suited for volatile assets. The values allowed depend on the provider, so check the provider docs too to know which fee tiers are allowed.
0.01 <= value <= 100The maximum amount of token0 to add to the liquidity pool, expressed as a decimal string.
"1"The maximum amount of token1 to add to the liquidity pool, expressed as a decimal string.
"1"Minimum price the liquidity will be active. If the price goes below this, the liquidity won't be active and will generate no revenues. This will allow to concentrate the liquidity to a price range, thus enhancing the gains. Price is always p = token1 / token0
0 <= value <= 3.4026e+38Maximum price the liquidity will be active. If the price goes above this, the liquidity won't be active and will generate no revenues. This will allow to concentrate the liquidity to a price range, thus enhancing the gains. Price is always p = token1 / token0
0 <= value <= 3.4026e+38The token address (in hexadecimal format) used to pay the transaction fee.
Defines how the fee will be paid: "ADD_TO_AMOUNT" adds it to the input amount, while "DEDUCT_FROM_AMOUNT" subtracts it from the input amount.
Value in
- "ADD_TO_AMOUNT"
- "DEDUCT_FROM_AMOUNT"
Optional operation type to align the gas estimate with a future add or change liquidity transaction.
"add-liquidity"Value in
- "add-liquidity"
- "change-liquidity"
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/liquidity/amounts?chainId=42161&token0=0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f&token1=0xaf88d065e77c8cc2239327c5edb3a432268e5831&poolFeePercent=1&minPrice=83475.12&maxPrice=102300.5&payGasFeeToken=0x82af49447d8a07e3bd95bd0d56f35241523fbab1&gasFeePaymentMethod=ADD_TO_AMOUNT"{ "poolPrice": "18342.234512", "amounts": { "token0MaxAmount": { "token0Amount": "2345.91", "token1Amount": "723.123" }, "token1MaxAmount": { "token0Amount": "2345.91", "token1Amount": "723.123" } }}