Check Balance
Fetch wallet holdings on Starknet: STRK, ETH, and all ERC-20 tokens with non-zero balances.
Prerequisites
- Active session required. If not authenticated, run
authenticate-walletskill first.
Rules
- If the user asks to check a specific token, use
--token <symbol>. - If no token is specified, run
balancewithout flags to show all balances. - Use
--jsonwhen the output will be consumed by another skill or pipeline. - Run this BEFORE
send,trade,multi-swap, or any transactional skill to verify sufficient funds.
Commands
# All token balances
npx starkfi@latest balance [--json]
# Specific token balance
npx starkfi@latest balance --token <symbol> [--json]Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
--token | string | Token symbol (e.g. STRK, ETH, USDC) | No |
--json | flag | Output as JSON | No |
Examples
User: "Check my balance"
npx starkfi@latest balanceUser: "How much STRK do I have?"
npx starkfi@latest balance --token STRKUser: "Get my balances as JSON"
npx starkfi@latest balance --jsonError Handling
| Error | Action |
|---|---|
Not authenticated | Run authenticate-wallet skill first. |
Network error | Retry once. If persistent, use config skill to set custom RPC. |
Related Skills
- Run this BEFORE
sendortradeto verify sufficient funds. - Run this BEFORE
stakingto confirm available STRK/BTC tokens. - Run this BEFORE
lendingsupply operations to confirm available assets. - Run this BEFORE
dcato verify sufficient sell token balance for the total DCA amount. - Run this BEFORE
confidentialconf-fundto verify sufficient tokens for funding the confidential account. - Run this BEFORE
trovesdeposits to verify sufficient tokens for the vault strategy. - Run this BEFORE
lstliquid staking to confirm available STRK. - Use
portfoliofor a complete view including staking, lending, vault, and LST positions with USD values.