| name | balance |
| description | Check Starknet wallet token balances — STRK, ETH, and all ERC-20 tokens. Use this skill when the user asks about their balance, holdings, funds, tokens, wallet contents, or wants to know how much of something they have. Also use before any transaction to verify sufficient funds. Trigger whenever the user says "check my balance", "how much ETH do I have", "what's in my wallet", "do I have enough", "show my tokens", or any variation about checking available assets — even if they don't use the word "balance". |
| license | MIT |
| compatibility | Requires Node.js 18+ and npx. |
| metadata | {"version":"0.1.0","author":"ahmetenesdur","category":"wallet-data"} |
| allowed-tools | ["Bash(npx starkfi@latest balance)","Bash(npx starkfi@latest balance *)","Bash(npx starkfi@latest status)"] |
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
- If the user asks to check a specific token, use
--token <symbol>.
- If no token is specified, run
balance without flags to show all balances.
- Use
--json when 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
npx starkfi@latest balance [--json]
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.
- Run this BEFORE
dca to verify sufficient sell token balance for the total DCA amount.
- Run this BEFORE
confidential conf-fund to verify sufficient tokens for funding the confidential account.
- Run this BEFORE
troves deposits to verify sufficient tokens for the vault strategy.
- Run this BEFORE
lst liquid staking to confirm available STRK.
- Use
portfolio for a complete view including staking, lending, vault, and LST positions with USD values.