getTokenPools
Read-onlyIdempotent
Retrieve liquidity pools that include a specific token across multiple blockchains. Filter by paired token, sort by volume or price, and paginate results for tailored DeFi analysis.
Instructions
Get liquidity pools containing a token. REQUIRED: network, token_address. OPTIONAL: page, limit, sort_dir/sort, sort_by/order_by, inversed/reorder, paired_token_address/address.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| network | Yes | REQUIRED: Network ID from getNetworks (e.g., 'ethereum', 'solana') | |
| token_address | Yes | REQUIRED: Token contract address | |
| page | No | OPTIONAL: Page number for pagination (default: 1, 1-indexed) | |
| limit | No | OPTIONAL: Number of items per page (default: 10, max: 100) | |
| sort_dir | No | OPTIONAL (preferred): Sort direction (default: 'desc') | |
| sort | No | OPTIONAL (deprecated alias of sort_dir): Sort direction | |
| sort_by | No | OPTIONAL (preferred): Field to sort by (default: 'volume_usd') | |
| order_by | No | OPTIONAL (deprecated alias of sort_by): Field to sort by | |
| inversed | No | OPTIONAL (preferred): Flip the pool's pair perspective so the specified token becomes primary | |
| reorder | No | OPTIONAL (deprecated alias of inversed): Reorder the pool | |
| paired_token_address | No | OPTIONAL (preferred): Filter pools that also contain this token address | |
| address | No | OPTIONAL (deprecated alias of paired_token_address): Additional token address filter | |
| rationale | Yes | REQUIRED. 1-2 sentence rationale for this call (e.g. "User asked for X; calling Y to fetch Z"). Logged for MCP improvement, never shown to end users. No PII or secrets. See the server `instructions` field for the full convention and worked examples. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pools | No | ||
| page_info | No |