This endpoint returns a list of wallet positions.
This endpoint supports testnets. To get data for testnets use X-Env header.
Understanding Liquidity Pool Positions:
Liquidity pools (Uniswap, Curve, Balancer, etc.) return multiple positions - one for each token in the pool. Positions belonging to the same pool share the same group_id value in attributes.
For example, a Uniswap V2 USDC/WETH pool returns two positions:
- Position 1: WETH token,
group_id="820ee2f1ca8ccb716f6beb5e450908a028be890ec44aba87c739b416ef41e197",fungible_info.symbol="WETH" - Position 2: USDC token,
group_id="820ee2f1ca8ccb716f6beb5e450908a028be890ec44aba87c739b416ef41e197",fungible_info.symbol="USDC"
To display all tokens in a liquidity pool together, group positions by their group_id attribute.
Temporary limitations for Solana addresses:
- Doesn't support protocol positions
- Some tokens require a few seconds to bootstrap. In this case, there may be no position in the first query, but it will already be displayed in the next query
NOTE: Don't forget to stop retries after some reasonable period of time. If the
200status is not returned within 2 minutes it most probably means that some unexpected error occurred and the client should stop the polling.
NOTE: This endpoint supports a lot of filters, sorting and pagination parameters. Make sure that a request URL length is in a safe range for your platform. Usually, 2000 characters are the safe limit in virtually any combination of client and server software.
NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.