| Tool |
Summary |
analyze_token |
Get a comprehensive analysis of a Sui token in one call: metadata, current price, 24h change, total supply, and top 5 holders. |
get_transaction_history |
Read a wallet’s decoded protocols, actions and coin flows; prefer this to query_transactions for exploring activity. |
get_wallet_overview |
Overview of a Sui wallet: every coin balance, SuiNS name, staked SUI and kiosk counts, and recent transactions. |
identify_address |
Classify a Sui address as wallet, package, validator or object before choosing other tools. |
- Title: Analyze token
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
(Recommended for token research) Get a comprehensive analysis of a Sui token in one call: metadata, current price, 24h change, total supply, and top 5 holders. Accepts either a coin type (e.g. ‘0x2::sui::SUI’) or a symbol (e.g. ‘DEEP’, ‘cetus’). A symbol several coins use returns status ambiguous_symbol with candidates (verified first, then by supply) from a symbol index of every mainnet coin up to its sync date. A symbol more than 100 coins use returns its count and no candidates, since the index keeps only the count; a coin published after the sync date is found only by a bounded live scan.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Symbol (‘deep’) or full coin type (‘0x2::sui::SUI’). A symbol matches exactly, in any case; use search_token for partial names. |
include_holders |
boolean |
no |
Include top 5 holders (default: true). Set false for faster response. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Get transaction history
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
(Recommended for wallet activity) Read a wallet’s decoded protocols, actions and coin flows; prefer this to query_transactions for exploring activity. Rows use complete balance changes and commands. Newest first by default; oldest starts at the first transaction. Pass next_cursor as cursor with the same order. address_poisoning always checks the shown page only, so empty pairs clear nothing older. subject_flow is the queried wallet’s signed change per coin; token_flow is the sender’s, omitted when they are the same address. Counterparties include at most 25 value recipients; counterparty_count reports larger sets. Summary keeps ~35k characters, preserving failed and lookalike-involved rows; omitted reports the rest and detail:‘full’ lists the whole page. signed_as_alias separately lists transactions signed as another wallet’s address_alias delegate, which the main page cannot show. The delegate scan is cached for up to five minutes; alias_scan_as_of dates it and signed_as_alias_unavailable marks incomplete scans, even beside returned matches.
| Parameter |
Type |
Required |
Description |
address |
string |
yes |
Sui wallet address (0x…) |
limit |
number (1 to 50), default 10 |
no |
Number of transactions to return (default 10, max 50) |
order |
newest | oldest |
no |
‘newest’ (default) pages backward from recent activity; ‘oldest’ pages forward from the first transaction. |
cursor |
string |
no |
next_cursor from the previous page. Continues in the same direction; pass the same order. |
detail |
summary | full |
no |
‘summary’ (default) keeps ~35k chars in page order, always retaining failed and lookalike-involved rows; omitted reports the rest. ‘full’ lists every row of the page. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Get wallet overview
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
(Recommended first tool for wallets) Overview of a Sui wallet: every coin balance, SuiNS name, staked SUI and kiosk counts, and recent transactions. include_prices adds USD values, coins ranked by value, and DeFi positions (staked SUI with rewards, liquid staking, liquidity, lending, and balances inside owned objects), each totalled apart. coverage says which owned objects the total covers and lists unrecognised types with counts; leads names lending positions near their borrow limit and shared vaults the wallet operates, with what they hold. include_nfts adds NFT estimates, kept out of the total.
| Parameter |
Type |
Required |
Description |
address |
string |
yes |
Wallet address (0x…) |
include_prices |
boolean |
no |
Add USD values, DeFi positions, coverage and leads (default: false). |
include_nfts |
boolean |
no |
With include_prices, also estimate held NFTs (default: false). Takes many requests on a wallet with many objects; list_nft_collections does this alone. |
detail |
summary | full |
no |
‘summary’ (default): holdings and unrecognised object types that fit about 12k characters each, the rest in omitted. ‘full’: every row. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Identify address
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
(Recommended first step) Classify a Sui address as wallet, package, validator or object before choosing other tools. It adds contextual balance/name, module or stake information. Packages can be identified from bridge labels on their defined objects; bridge_carrier identifies bytecode calls into curated bridge exits. A wallet’s first_seen is the oldest transaction GraphQL returns where it sent or was affected, with received coins read across all balance-change pages. first_inflow means it gained coins without sending, including genesis with sender:null; genesis names no funding wallet. If no gain is found in incomplete changes, first_inflow is null. first_seen_unavailable means the first read failed. Use find_funding_sources when the first transaction was not funding.
| Parameter |
Type |
Required |
Description |
address |
string |
yes |
Sui address or object ID (0x…) |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |