Skip to main content

GET /target-volume/pools/:address

List the token's pools and whether each can take a Target Volume order.

Read from the chain on every call; can take a few seconds.

Use case​

Let the user pick a pool before asking for targets.

Path params​

ParamRequiredDescription
addressyesToken mint.

Response 200​

{
"pools": [
{
"sPoolId": "…",
"ePoolChosen": "PUMPSWAP",
"sPoolType": "…",
"sQuoteSymbol": "SOL",
"nLiquidityUsd": 84210.5,
"bAvailable": true
},
{
"sPoolId": "…",
"ePoolChosen": "RAYDIUM",
"sPoolType": "…",
"sQuoteSymbol": "USDC",
"nLiquidityUsd": 1200,
"bAvailable": false,
"message": "This pool has too little liquidity. Pick another pool."
}
]
}
FieldDescription
bAvailablefalse when the pool cannot take an order; message says why. Every pool is checked again when it is quoted.
nLiquidityUsdPool liquidity in USD.

Errors​

StatusMeaning
400address is not a valid public key.
403Target Volume is not available for this account.
503The chain could not be read in time; retry.

Example​

curl "$BASE_URL/target-volume/pools/$MINT" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID"