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
| Param | Required | Description |
|---|---|---|
address | yes | Token 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."
}
]
}
| Field | Description |
|---|---|
bAvailable | false when the pool cannot take an order; message says why. Every pool is checked again when it is quoted. |
nLiquidityUsd | Pool liquidity in USD. |
Errors
| Status | Meaning |
|---|---|
400 | address is not a valid public key. |
403 | Target Volume is not available for this account. |
503 | The 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"