sui_get_balance
Retrieve the total balance of a coin type for a Sui address. Supports native SUI and custom coins like USDC.
Instructions
Get the aggregated coin balance for an address, optionally for a specific coin type (defaults to 0x2::sui::SUI).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"address": "<address>"
},
"name": "sui_get_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | 0x-prefixed Sui address. | |
| coin_type | No | Move type for the coin, e.g. 0x2::sui::SUI or 0x...::usdc::USDC. Defaults to native SUI. | |
| network | No | Sui network. Defaults to the server's configured default. |