Liquidity Pool
Inspect, burn or reclaim the pool liquidity a launch holds on Uniswap (EVM) and Meteora DAMM (Solana) launches.
On Uniswap V2, V3 and V4 launches (EVM chains), the dev wallet receives the pool liquidity: LP tokens on V2, a position NFT on V3 and V4. These endpoints read that holding, lock it for good, or pull the token and native back to the dev wallet. Other EVM platforms lock or burn liquidity themselves and answer 400.
On Solana, the same routes manage the position a Meteora DAMM launch opened, with different response fields (see each endpoint's notes). Other Solana platforms answer 400. The web app only uses these endpoints on Uniswap launches.
The LP info object
The dev wallet's liquidity in the launch's Uniswap pool and what it would redeem. Amounts are raw units (wei for the native side), as decimal strings. On Uniswap V3 and V4, lp_balance is the position's liquidity and lp_total_supply the pool's active liquidity.
Attributes
-
okbooleanAlwaystrue. -
pairstringV2 pair address. On V3, the pool address, or the zero address when no pool is found. On V4, the Uniswap V4 PositionManager address. -
lp_balancestringLP held by the dev wallet. -
lp_total_supplystringTotal LP supply of the pair. -
token_reservestringToken reserve of the pool. -
native_reservestringNative reserve of the pool. -
token_redeemablestringTokens the dev's LP would redeem. -
native_redeemablestringNative the dev's LP would redeem.
Retrieve LP info
/launch/lp/info/{launch_id} Returns the dev wallet's liquidity in the launch's pool and what it would redeem.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example202000000000318
Returns 200 OK · application/json
Returns an LP info object.
-
okbooleanAlwaystrue. -
pairstringV2 pair address. On V3, the pool address, or the zero address when no pool is found. On V4, the Uniswap V4 PositionManager address. -
lp_balancestringLP held by the dev wallet. -
lp_total_supplystringTotal LP supply of the pair. -
token_reservestringToken reserve of the pool. -
native_reservestringNative reserve of the pool. -
token_redeemablestringTokens the dev's LP would redeem. -
native_redeemablestringNative the dev's LP would redeem.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 400 | bad_request | EVM: the launch is still a draft (imported launches pass). Launch the token with Launch a token first. |
| 400 | bad_request | EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself. Use these endpoints only on Uniswap V2, V3 and V4 launches; there is no liquidity to manage on other EVM platforms. |
| 400 | bad_request | EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it. Use a launch whose dev wallet Proxima holds the key for. |
| 400 | bad_request | Uniswap V2: the token has no pair against the wrapped native token yet. Retry once trading has opened on Uniswap V2. |
| 400 | bad_request | Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim. Treat the liquidity as already burned, reclaimed or moved out of the dev wallet; there is nothing left to manage. |
| 400 | bad_request | Uniswap V4: the position NFT is no longer in the dev wallet; after Burn LP it is held by 0x…dEaD. Treat the liquidity as burned if <owner> is the dead address; otherwise move the position back to the dev wallet. |
| 400 | bad_request | Uniswap V4: the position was closed, for example by Reclaim LP. Treat the liquidity as reclaimed; there is nothing left to manage. |
| 400 | bad_request | Uniswap V4: no position mint to the dev wallet was found after the token's creation block. Check that trading was opened from this launch's dev wallet; there is no position for Proxima to manage. |
| 422 | upstream_failure | Uniswap V4: an RPC read failed. message names the read (v4 position read, v4 position search, v4 pool read, v4 pool reserves, v4 position fees); the body adds service: "evm_rpc". Retry in a few seconds. |
| 400 | bad_request | Solana: the launch is not a Meteora DAMM launch. On Solana, use these endpoints only for Meteora DAMM launches. |
| 400 | bad_request | Solana: the launch is still a draft. Launch the token with Launch a token first. |
| 400 | bad_request | Solana: the launch has no position Proxima opened, as with an imported pool. Manage the pool from the wallet that created it; Proxima only manages positions it opened. |
| 404 | not_found | Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it. Treat the liquidity as reclaimed; there is nothing left to manage. |
| 422 | upstream_failure | Solana: reading the position or the pool from the RPC failed. The body adds service: "rpc". Retry in a few seconds. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.launch.lp.getLpInfo(launchId) src/lib/proxima/endpoints/launch/lp.ts
Burn LP
/launch/lp/burn/{launch_id} Permanently locks the dev wallet's liquidity by sending it to the dead address.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Read Retrieve LP info first: if the dev no longer holds the liquidity (
lp_balanceof0, or a400saying so), the first call landed. A repeat after it landed is refused with400.
On V2 the LP tokens go to 0x…dEaD; on V3 and V4 the position NFT is locked. Takes no body.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example202000000000318
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
tx_hashstringTransaction hash. -
lp_burnedstringLP amount burned.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 400 | bad_request | EVM: the launch is still a draft (imported launches pass). Launch the token with Launch a token first. |
| 400 | bad_request | EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself. Use these endpoints only on Uniswap V2, V3 and V4 launches; there is no liquidity to manage on other EVM platforms. |
| 400 | bad_request | EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it. Use a launch whose dev wallet Proxima holds the key for. |
| 400 | bad_request | Uniswap V2: the token has no pair against the wrapped native token yet. Retry once trading has opened on Uniswap V2. |
| 400 | bad_request | Uniswap V2: the dev wallet holds no LP tokens, for example after a burn or a reclaim. Read Retrieve LP info: the LP was already burned, reclaimed or moved, so there is nothing to burn. |
| 400 | bad_request | Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim. Treat the liquidity as already burned, reclaimed or moved out of the dev wallet; there is nothing left to manage. |
| 400 | bad_request | Uniswap V4: the position NFT is no longer in the dev wallet; after Burn LP it is held by 0x…dEaD. Treat the liquidity as burned if <owner> is the dead address; otherwise move the position back to the dev wallet. |
| 400 | bad_request | Uniswap V4: the position was closed, for example by Reclaim LP. Treat the liquidity as reclaimed; there is nothing left to manage. |
| 400 | bad_request | Uniswap V4: no position mint to the dev wallet was found after the token's creation block. Check that trading was opened from this launch's dev wallet; there is no position for Proxima to manage. |
| 422 | upstream_failure | Uniswap V4: an RPC read failed. message names the read (v4 position read, v4 position search, v4 pool read, v4 pool reserves, v4 position fees); the body adds service: "evm_rpc". Retry in a few seconds. |
| 422 | upstream_failure | EVM: the transaction could not be sent or failed on-chain. The body adds service: "evm_tx_engine". Read Retrieve LP info before calling again: the transaction may have landed. |
| 400 | bad_request | Solana: the launch is not a Meteora DAMM launch. On Solana, use these endpoints only for Meteora DAMM launches. |
| 400 | bad_request | Solana: the launch is still a draft. Launch the token with Launch a token first. |
| 400 | bad_request | Solana: the launch has no position Proxima opened, as with an imported pool. Manage the pool from the wallet that created it; Proxima only manages positions it opened. |
| 404 | not_found | Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it. Treat the liquidity as reclaimed; there is nothing left to manage. |
| 400 | bad_request | Solana: the position's liquidity is already all locked or withdrawn. Stop here: nothing is left to lock. |
| 422 | upstream_failure | Solana: reading the position or the pool from the RPC failed. The body adds service: "rpc". Retry in a few seconds. |
| 422 | upstream_failure | Solana: the transaction could not be sent. The body adds service: "tx_engine". Read Retrieve LP info before calling again. |
| 422 | upstream_failure | Solana: the transaction did not land. Read Retrieve LP info to confirm nothing moved, then call again. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.lp.burnLp(launchId) src/lib/proxima/endpoints/launch/lp.ts
Reclaim LP
/launch/lp/reclaim/{launch_id} Removes the dev wallet's liquidity and returns the token and native to the dev wallet.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Read Retrieve LP info first: if the dev no longer holds the liquidity, the first call landed and a repeat is refused with
400. On Solana a failed call may have withdrawn part of it; calling again reclaims what is left.
Expected amounts come from a snapshot read before the transaction and can drift slightly by the time it lands. Takes no body.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example202000000000318
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
tx_hashstringTransaction hash. -
lp_reclaimedstringLP amount removed. -
expected_token_outstringTokens expected back, raw units. -
expected_native_outstringNative expected back, wei.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 400 | bad_request | EVM: the launch is still a draft (imported launches pass). Launch the token with Launch a token first. |
| 400 | bad_request | EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself. Use these endpoints only on Uniswap V2, V3 and V4 launches; there is no liquidity to manage on other EVM platforms. |
| 400 | bad_request | EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it. Use a launch whose dev wallet Proxima holds the key for. |
| 400 | bad_request | Uniswap V2: the token has no pair against the wrapped native token yet. Retry once trading has opened on Uniswap V2. |
| 400 | bad_request | Uniswap V2: the dev wallet holds no LP tokens, for example after a burn or a reclaim. Read Retrieve LP info: the LP was already burned, reclaimed or moved, so there is nothing to reclaim. |
| 400 | bad_request | Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim. Treat the liquidity as already burned, reclaimed or moved out of the dev wallet; there is nothing left to manage. |
| 400 | bad_request | Uniswap V3 and V4: the position holds no liquidity. Stop here: nothing is left to reclaim. |
| 400 | bad_request | Uniswap V4: the position NFT is no longer in the dev wallet; after Burn LP it is held by 0x…dEaD. Treat the liquidity as burned if <owner> is the dead address; otherwise move the position back to the dev wallet. |
| 400 | bad_request | Uniswap V4: the position was closed, for example by Reclaim LP. Treat the liquidity as reclaimed; there is nothing left to manage. |
| 400 | bad_request | Uniswap V4: no position mint to the dev wallet was found after the token's creation block. Check that trading was opened from this launch's dev wallet; there is no position for Proxima to manage. |
| 422 | upstream_failure | Uniswap V4: an RPC read failed. message names the read (v4 position read, v4 position search, v4 pool read, v4 pool reserves, v4 position fees); the body adds service: "evm_rpc". Retry in a few seconds. |
| 422 | upstream_failure | EVM: the transaction could not be sent or failed on-chain. The body adds service: "evm_tx_engine". Read Retrieve LP info before calling again: the transaction may have landed. |
| 400 | bad_request | Solana: the launch is not a Meteora DAMM launch. On Solana, use these endpoints only for Meteora DAMM launches. |
| 400 | bad_request | Solana: the launch is still a draft. Launch the token with Launch a token first. |
| 400 | bad_request | Solana: the launch has no position Proxima opened, as with an imported pool. Manage the pool from the wallet that created it; Proxima only manages positions it opened. |
| 404 | not_found | Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it. Treat the liquidity as reclaimed; there is nothing left to manage. |
| 400 | bad_request | Solana: the position has no unlocked liquidity and no fees to claim. Stop here: the liquidity and fees were already reclaimed. |
| 422 | upstream_failure | Solana: reading the position or the pool from the RPC failed. The body adds service: "rpc". Retry in a few seconds. |
| 422 | upstream_failure | Solana: a transaction could not be sent. The reclaim sends up to three transactions in a row (withdraw, claim fees, close), so the ones before it may have landed. The body adds service: "tx_engine". Read Retrieve LP info before calling again. |
| 422 | upstream_failure | Solana: a transaction did not land; the ones sent before it may have. Read Retrieve LP info to see what is left, then call again to reclaim the rest. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.lp.reclaimLp(launchId) src/lib/proxima/endpoints/launch/lp.ts