Pools

Get all pools with pagination

get

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.

Query parameters
poolTypestring · enumRequired

Type of pool to filter (all, concentrated)

Possible values:
poolSortFieldstring · enumRequired

Field to sort pools by (default, liquidity)

Example: liquidityPossible values:
sortTypestring · enumRequired

Sort direction (asc or desc)

Possible values:
pageSizeinteger · min: 1 · max: 100Required

Number of results per page (1-100)

Example: 100
pageinteger · min: 1Required

Page number (starts at 1)

Example: 1
user_walletany ofOptional

Solana wallet address to include user's open positions in the response

stringOptional
or
nullOptional
mint0any ofOptional

Filter pools by first token address

stringOptional
or
nullOptional
mint1any ofOptional

Filter pools by second token address

stringOptional
or
nullOptional
Responses
200

Successful Response

application/json
get
/api/pools/

Get pools by owner wallet

get

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.

Path parameters
owner_walletstringRequired

Owner wallet address

Example: EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMt
Responses
200

Successful Response

application/json
get
/api/pools/by_owner/{owner_wallet}/

Get pools by IDs

get

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.

Query parameters
user_walletany ofOptional

Solana wallet address to include user's positions in the specified pools

stringOptional
or
nullOptional
idsstringRequired

Comma-separated list of pool addresses (Solana public keys)

Example: 5RECZxSW21joX632Bq7kDMnouqHJYsCx5hMwikfw4Bhb,84mG1tFYrT5bQ8P2dtfWzBsNEN3T8SxgSAaUXW345Vjm
Responses
200

Successful Response

application/json
get
/api/pools/by_ids/

Create pool mock preview

post

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.

Body
config_indexintegerRequired

CLMM configuration index to use for the pool

Example: 16
mint0stringRequired

First token address (Solana public key)

Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
mint1stringRequired

Second token address (Solana public key)

Example: Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
pricenumberRequired

Initial price for the pool (mint0/mint1 or mint1/mint0 depending on is_base_0)

Example: 1
is_base_0booleanRequired

Whether mint0 is the base token for price calculation. If true, price = mint0/mint1

Example: true
Responses
200

Successful Response

application/json
post
/api/create_pool_mock/

Create new pool

post

Create new pool

Creates a new liquidity pool with specified token pair and initial price. Returns transaction for user to sign.

Body
config_indexinteger · int32Required

Pool configuration index

Example: 16
mint0stringRequired

First pool token address

Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
mint1stringRequired

Second pool token address

Example: Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
open_timeinteger · int64Required

Pool opening time (Unix timestamp)

Example: 1710326400
pricenumber · doubleRequired

Initial pool price (token1/token0)

Example: 1
user_walletstringRequired

User wallet address

Example: EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMt
Responses
200

Create pool

application/json
post
/api/create_pool/

Create pool and open position

post

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.

Body
config_indexinteger · int32Required

Configuration index

Example: 16
input_amountinteger · int64Required

Input token amount

Example: 1
is_base_0booleanRequired

Whether token 0 is the base token

mint0stringRequiredExample: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
mint1stringRequiredExample: Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
open_timeinteger · int64Required

Opening time (Unix timestamp)

Example: 1710326400
pricenumber · doubleRequired

Price value

Example: 1
slippage_bpsinteger · int64Required

Slippage in basis points

Example: 50
tick_lower_pricenumber · doubleRequired

Lower price boundary

Example: 0.9
tick_upper_pricenumber · doubleRequired

Upper price boundary

Example: 1.1
user_walletstringRequiredExample: EQdJjaPwUL6X3GjUp3ZQ1T3QA4XL9g9v3Z6rSUMGALMt
with_metadatabooleanRequired

Whether to include metadata

Responses
200

Create pool and Open position

application/json
post
/api/create_pool_and_open_position/

Get pool liquidity range

get

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.

Path parameters
pool_idstringRequired

Pool ID (Pubkey)

Example: 3uejj4gprhzYDCfmz1DYcvnZzCukujVAUJa68bctU4nJ
Responses
200

Pool liquidity range

application/json
get
/api/pool/{pool_id}/liquidity_range

Get pool state

get

Get pool state

Returns the current state and configuration of a specific pool.

Path parameters
pool_idstringRequiredExample: 3uejj4gprhzYDCfmz1DYcvnZzCukujVAUJa68bctU4nJ
Responses
200

PPool

application/json
get
/api/ppool/{pool_id}/

Last updated