Skip to content

DeFi

Tool Summary
find_pools Find liquidity pools for a token pair across Cetus, DeepBook v2/v3, Turbos and BlueMove v1.
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 liquidity pools for a token pair across Cetus, DeepBook v2/v3, Turbos and BlueMove v1. Searches both token orders and every Turbos fee tier. Each result reports the pool’s own token order. Use get_pool_stats for reserves, fees and prices.

Parameter Type Required Description
token_a string yes First token: symbol (e.g. ‘SUI’) or full coin type
token_b string yes Second token: symbol (e.g. ‘USDC’) or full coin type
protocol string no Filter by protocol: ‘cetus’, ‘deepbook’, ‘turbos’, or ‘bluemove’. Searches all if omitted.
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…)
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’