Pools
Retrieves a paginated list of liquidity pools with comprehensive metrics and filtering options.
Each pool includes: token pair information with metadata, current price and liquidity (TVL), fee rate and configuration, volume/APR/fee APR metrics (24h, 7d, 30d), price ranges, farm information, and user positions (if wallet provided).
Returns paginated response with pool count, data array, and hasNextPage indicator.
Type of pool to filter (all, concentrated)
Field to sort pools by (default, liquidity)
liquidityPossible values: Sort direction (asc or desc)
Number of results per page (1-100)
100Page number (starts at 1)
1Solana wallet address to include user's open positions in the response
Filter pools by first token address
Filter pools by second token address
Successful Response
Validation Error
Retrieves all liquidity pools where the specified wallet has active positions.
Useful for portfolio dashboards and position management interfaces to quickly find all pools a user is participating in without iterating through all positions.
Returns clmm array (concentrated liquidity pools) and farm array (farm pools) with IDs and program IDs.
Owner wallet address
EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMtSuccessful Response
Bad Request
Validation Error
Retrieves detailed information for specific pools by their addresses.
Use cases: fetch details for a specific set of pools, get current state of pools user is watching, batch pool data retrieval for analytics.
Returns array of complete pool objects (same data as /api/pools/) matching the requested IDs, including user positions if user_wallet provided.
Solana wallet address to include user's positions in the specified pools
Comma-separated list of pool addresses (Solana public keys)
5RECZxSW21joX632Bq7kDMnouqHJYsCx5hMwikfw4Bhb,84mG1tFYrT5bQ8P2dtfWzBsNEN3T8SxgSAaUXW345VjmSuccessful Response
Bad Request
Validation Error
Generates a mock preview of a pool with specified parameters without creating it on-chain.
Use cases: preview pool parameters before creation, estimate initial pool state, validate configuration compatibility with token pair, UI preview for pool creation form.
Returns mock pool object with calculated pool address, token pair configuration, initial price and tick, fee structure, and all pool metadata as if it existed.
Note: This does NOT create an actual on-chain pool. Use /api/create_pool/ to create actual pools.
CLMM configuration index to use for the pool
16First token address (Solana public key)
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vSecond token address (Solana public key)
Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYBInitial price for the pool (mint0/mint1 or mint1/mint0 depending on is_base_0)
1Whether mint0 is the base token for price calculation. If true, price = mint0/mint1
trueSuccessful Response
Validation Error
Create new pool
Creates a new liquidity pool with specified token pair and initial price. Returns transaction for user to sign.
Pool configuration index
16First pool token address
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vSecond pool token address
Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYBPool opening time (Unix timestamp)
1710326400Initial pool price (token1/token0)
1User wallet address
EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMtCreate pool
Internal server error.
Create pool and open position
Creates a new liquidity pool and opens an initial position in a single operation. Returns transaction for user to sign.
Configuration index
16Input token amount
1Whether token 0 is the base token
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vEs9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYBOpening time (Unix timestamp)
1710326400Price value
1Slippage in basis points
50Lower price boundary
0.9Upper price boundary
1.1EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMtWhether to include metadata
Create pool and Open position
Internal server error.
Get pool liquidity range
Returns liquidity distribution across ticks for the specified pool. Analyzes all positions in the pool and collects liquidity information for each tick.
Pool ID (Pubkey)
3uejj4gprhzYDCfmz1DYcvnZzCukujVAUJa68bctU4nJPool liquidity range
Bad request
Internal server error.
Get pool state
Returns the current state and configuration of a specific pool.
3uejj4gprhzYDCfmz1DYcvnZzCukujVAUJa68bctU4nJPPool
Bad request. (invalid pubkey)
Internal server error.
Last updated