balance

Show wallet balances and coin positions. Requires a wallet. Reports your smart wallet balances when one is configured, otherwise your EOA.

zora balance [options]

Subcommands

Subcommand	Description
`balance spendable`	Show wallet token balances (ETH, USDC, ZORA)
`balance coins`	Show coin positions

Running balance with no subcommand shows both.

Options

Flag	Description	Default
`--live`	Interactive live-updating display	default
`--static`	Static snapshot	—
`--refresh <seconds>`	Auto-refresh interval in live mode (min 5)	`30`
`--json`	Machine-readable JSON output	—

Examples

Show full balance

npx @zoralabs/cli balance --static

 Wallet Balances
 
 Token   Balance        Value
 ETH     0.0542         $105.23
 USDC    25.00          $25.00
 ZORA    1,250.00       $15.63
 
 Coin Positions
 
 #  Name     Address           Type          Balance      Value
 1  jacob    0x9b13...5f54     creator-coin  20.63        $10.01
 2  zora     0x2748...f519     trend         1,500.00     $11.10

Show only spendable tokens

npx @zoralabs/cli balance spendable --static

Show only coin positions

npx @zoralabs/cli balance coins --static

Live auto-refreshing view

npx @zoralabs/cli balance --live --refresh 10

In live mode, use arrow keys to select rows and press Enter or c to copy a coin address.

JSON output

npx @zoralabs/cli balance --json

{
  "wallet": [
    {
      "name": "Ether",
      "symbol": "ETH",
      "address": null,
      "balance": "0.0542",
      "priceUsd": 1664.27,
      "usdValue": 90.2
    },
    {
      "name": "ZORA",
      "symbol": "ZORA",
      "address": "0x1111111111166b7FE7bd91427724B487980aFc69",
      "balance": "1250.00",
      "priceUsd": 0.0082,
      "usdValue": 10.25
    }
  ],
  "coins": [
    {
      "rank": 1,
      "name": "jacob",
      "symbol": "jacob",
      "type": "creator-coin",
      "coinType": "CREATOR",
      "chainId": 8453,
      "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
      "creatorHandle": "jacob",
      "previewImage": "https://...",
      "balance": "20.63",
      "usdValue": 10.01,
      "priceUsd": 0.000485,
      "marketCap": 435000,
      "marketCapDelta24h": 8220.7,
      "marketCapChange24h": 0.019,
      "volume24h": 0.49,
      "totalVolume": 12345.6
    }
  ]
}

The spendable token list is under the wallet key (not spendable). coins[].type is the lowercase display form (creator-coin, post, trend) while coins[].coinType is the raw API enum (CREATOR, CONTENT, TREND). Numeric fields are JSON numbers; usdValue, priceUsd, marketCap* may be null. The base balance --json returns both wallet and coins; balance spendable --json returns only { "wallet": [...] }; balance coins --json returns { "coins": [...], "pageInfo": { ... } }.

balance coins

Show coin positions with sorting and pagination.

zora balance coins [options]

Options

Flag	Description	Default
`--sort <sort>`	Sort by: `usd-value`, `balance`, `market-cap`, `price-change`	`usd-value`
`--limit <n>`	Number of results (max 20)	`10`
`--after <cursor>`	Pagination cursor from a previous result	—
`--live`	Interactive live-updating display	default
`--static`	Static snapshot	—
`--refresh <seconds>`	Auto-refresh interval in live mode (min 5)	`30`
`--json`	Machine-readable JSON output	—

Interactive Controls

Key	Action
`↑`/`↓`	Navigate rows
`Enter`/`c`	Copy coin address
`←`/`→`	Previous/next page
`r`	Refresh
`q`	Quit