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-wallet skill first.

Rules

1. If the user asks to check a specific token, use --token <symbol>.
2. If no token is specified, run balance without flags to show all balances.
3. Use --json when the output will be consumed by another skill or pipeline.
4. 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 balance

User: "How much STRK do I have?"

npx starkfi@latest balance --token STRK

User: "Get my balances as JSON"

npx starkfi@latest balance --json

Error 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 send or trade to verify sufficient funds.
• Run this BEFORE staking to confirm available STRK/BTC tokens.
• Run this BEFORE lending supply operations to confirm available assets.
• Use portfolio for a complete view including staking and lending positions with USD values.