Skip to content

DeFi

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’