balance

Show wallet balances and coin positions. Requires a wallet.

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

{
  "spendable": [
    { "token": "ETH", "balance": "0.0542", "valueUsd": "105.23" },
    { "token": "USDC", "balance": "25.00", "valueUsd": "25.00" },
    { "token": "ZORA", "balance": "1250.00", "valueUsd": "15.63" }
  ],
  "coins": [
    {
      "name": "jacob",
      "coinType": "creator-coin",
      "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
      "balance": "20.63",
      "valueUsd": "10.01"
    }
  ]
}

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