Skip to content

Staking

Tool Summary
get_staking_summary Get directly held StakedSui positions and principal, now or at as_of.
get_validators List current Sui validators, or return detailed info for one address (credentials, staking stats, network addresses).
  • Title: Get staking summary
  • Profile: core (default)
  • Annotations: openWorldHint: true, readOnlyHint: true

Get directly held StakedSui positions and principal, now or at as_of. Historical budget stops return a continuation; totals stay null until replay finishes. Excludes wrapped stakes and liquid-staking tokens.

Parameter Type Required Description
address string yes Wallet address (0x…)
as_of string no ISO 8601 date or checkpoint string; holdings at the end of the last checkpoint at or before it.
max_transactions integer (1 to 10000) no Historical replay budget per direction (default 1000); also bounds object-change pages.
continuation string no Opaque historical replay state from continue_with; keep address, as_of and network unchanged.
detail summary | full no summary caps displayed positions; full returns every read position.
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’
  • Title: Get validators
  • Profile: market
  • Annotations: openWorldHint: true, readOnlyHint: true

List current Sui validators, or return detailed info for one address (credentials, staking stats, network addresses). The default summary shows name, address, stake, commission, voting power and at-risk status within a compact output budget; at-risk validators are always kept. Ranking, active_validator_count and total_stake cover the whole set; validator_count counts the rows shown. detail: full returns every full row unless limit is set. Omitted rows and fields name a same-network full call without a limit.

Parameter Type Required Description
address string no If set, return details for this one validator instead of the full list (0x…)
limit integer (1 to 150) no When listing, keep at most N validators; summary also keeps at-risk rows beyond N. The summary output budget still applies.
sort_by stake | commission no Sort field when listing: stake (default) or commission
detail summary | full no Listing detail: summary (default) caps compact rows; full returns all fields without a size cap. Ignored for an address lookup.
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’