# Balance

> Check wallet balances (native and ERC-20 tokens) on Base, HyperEVM, or Monad.

- Skill: `fibrous-finance/balance` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fibrous-finance/balance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fibrous-finance/balance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: Fibrous-Finance (https://skillmd.com/u/fibrous-finance)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fibrous-finance/balance

---


# Check Balance

Fetch wallet holdings: native tokens 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 specifies a chain, you MUST include `--chain <name>`.
2. If the user does NOT specify a chain, default to `base` and state it: _"Checking your balance on Base."_
3. Use `--json` when the output will be consumed by another skill or pipeline.

## Chain Reference

| Chain    | Flag               | Native Token |
| -------- | ------------------ | ------------ |
| Base     | `--chain base`     | ETH          |
| HyperEVM | `--chain hyperevm` | HYPE         |
| Monad    | `--chain monad`    | MON          |

## Commands

```bash
npx fibx@latest balance [--chain <chain>] [--json]
```

## Parameters

| Parameter | Type   | Description                              | Required |
| --------- | ------ | ---------------------------------------- | -------- |
| `chain`   | string | `base`, `hyperevm`, or `monad` | No       |
| `json`    | flag   | Output as JSON                           | No       |

Default chain: `base`

## Examples

**User:** "Check my balance"

```bash
npx fibx@latest balance
```

**User:** "What's my Monad balance?"

```bash
npx fibx@latest balance --chain monad
```

## Error Handling

| Error               | Action                                                     |
| ------------------- | ---------------------------------------------------------- |
| `Not authenticated` | Run `authenticate-wallet` skill first.                     |
| `Network error`     | Retry once. If persistent, use `config` to set custom RPC. |
| `Rate limit / 429`  | Use `config` skill to set a custom RPC.                    |

## Related Skills

- Run this BEFORE `send` or `trade` to verify sufficient funds.
- Run this BEFORE `aave supply` to confirm available assets.
- Use `portfolio` for a cross-chain overview with USD valuations.
- Use `config` to set a custom RPC if you encounter rate limit errors.