| Tool |
Summary |
find_pools |
Find pools for an exact token pair across 11 Sui venues. |
get_defi_positions |
Find and value a wallet’s staked SUI with rewards, issuer-rate liquid-staking coins, CLMM/AMM liquidity, lending and balances inside owned objects. |
get_pool_stats |
Get stats for a DeFi liquidity pool on Sui given its object ID. |
- Title: Find pools
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
Find pools for an exact token pair across 11 Sui venues. Both token orders are searched. Incomplete venue searches carry a next_call that resumes from their last cursor; offset pages the pools found in one call. Totals are lower bounds until every venue completes.
| Parameter |
Type |
Required |
Description |
token_a |
string |
yes |
First token: verified symbol (e.g. ‘SUI’) or full coin type |
token_b |
string |
yes |
Second token: verified symbol (e.g. ‘USDC’) or full coin type |
protocol |
string |
no |
Filter by venue: cetus, deepbook, turbos, bluemove, bluefin, momentum, flowx_clmm, flowx_v2, magma, aftermath, kriya_v2. Searches all if omitted. |
offset |
integer (at least 0) |
no |
Start the pool list at this index (default 0). A response that leaves pools out gives the next offset in omitted.next_call. |
venue_cursor |
string |
no |
Opaque cursor from a venue’s next_call. Resumes that venue’s search; use the protocol supplied in the call. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Get DeFi positions
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
- Metadata:
anthropic/maxResultSizeChars: 500000
Find and value a wallet’s staked SUI with rewards, issuer-rate liquid-staking coins, CLMM/AMM liquidity, lending and balances inside owned objects. Positions include asset legs, valuation method and evidence tier; USD is null if any leg lacks a price, with unpriced_reason. Totals sum only priced positions. coverage lists unrecognised owned-object types and counts; unread lists failed reads. Lending includes protocol health ratios. leads flags near-borrow-limit positions and operated shared vaults with their holdings.
| Parameter |
Type |
Required |
Description |
address |
string |
yes |
Wallet address (0x…) |
owned_max_scan |
integer (1 to 50000) |
no |
Raise owned-object and position-reader scan bounds (default varies by reader, up to 5,000 objects and 200 entries per container); incomplete reads remain in unread. |
operated_recent_limit |
integer (1 to 50) |
no |
Sent transactions per operated-shared-object scan page (default 20). |
operated_candidate_limit |
integer (1 to 500) |
no |
Shared objects checked per operated scan page (default 20); raise when operated_scan says candidates_truncated. |
operated_cursor |
string |
no |
Older sent-transaction cursor from operated_scan.next_call. |
detail |
summary | full |
no |
‘summary’ (default): highest-value positions fitting about 30k characters, plus all unpriced ones; omitted counts the rest. ‘full’: every position. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Get pool stats
- Profile:
market
- Annotations:
openWorldHint: true, readOnlyHint: true
Get stats for a DeFi liquidity pool on Sui given its object ID. Auto-detects the protocol (Cetus, DeepBook, Turbos, etc.) and returns token pair, reserves, fees, and current prices.
| Parameter |
Type |
Required |
Description |
pool_id |
string |
yes |
Pool object ID (0x…) |
protocol |
string |
no |
Protocol hint (e.g. ‘cetus’, ‘deepbook’, ‘turbos’). Auto-detected if omitted. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |