get

Look up a single coin by address or name. Opens an interactive tabbed live view with Price History, Trades, and Holders panels.

zora get [typeOrId] [identifier]

Arguments

Argument	Description
`typeOrId`	Type prefix (`creator-coin`, `trend`) or coin address/name when used alone
`identifier`	Coin address (`0x...`) or name — only needed when a type prefix is provided

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	—

Use a type prefix to disambiguate when a name could match multiple coin types. When using an address, the type is resolved automatically.

Live View

The default live view displays a pinned coin summary at the top and tabbed detail panels below. Switch between tabs using arrow keys or number keys:

Price History — sparkline chart with high/low/change
Trades — recent buy/sell activity
Holders — top holders with balance and ownership percentage

Key	Action
`1`/`2`/`3`	Switch tab
`←`/`→`	Previous/next tab
`r`	Refresh
`q`	Quit

Subcommands

Subcommand	Description
`get price-history`	Display price history for a coin
`get trades`	Show recent buy/sell activity
`get holders`	Show top holders of a coin

Examples

Look up the jacob creator coin

npx @zoralabs/cli get creator-coin jacob

 jacob
 creator-coin · 0x9b13358e3a023507e7046c18f508a958cda75f54
 
 Market Cap        $435.0K
 24h Volume        $0.5
 24h Change        +1.9%
 Holders           6,171
 Created           9 months ago (2025-06-20 4:31 PM)

Look up the zora trend coin

npx @zoralabs/cli get trend zora

 zora
 trend · 0x2748009c2c5d46b78a3a7bdfd5b121edfb72f519
 
 Market Cap        $6.6K
 24h Volume        $0
 24h Change        +1.8%
 Holders           22
 Created           18 days ago (2026-03-12 3:43 PM)

Look up by address

npx @zoralabs/cli get 0x9b13358e3a023507e7046c18f508a958cda75f54

JSON output

npx @zoralabs/cli get creator-coin jacob --json

{
  "name": "jacob",
  "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
  "coinType": "creator-coin",
  "marketCap": "434988.18",
  "marketCapDelta24h": "8220.7",
  "volume24h": "0.49",
  "uniqueHolders": 6171,
  "createdAt": "2025-06-20T16:31:57",
  "creatorAddress": "0x3a5df03dd1a001d7055284c2c2c147cbbc78d142",
  "creatorHandle": "jacob",
  "trades": [
    {
      "side": "BUY",
      "trader": "0xabc1...2345",
      "amount": "100.5",
      "valueUsd": "5.23",
      "txHash": "0xdef1..."
    }
  ]
}

JSON Fields

Field	Type	Description
`name`	string	Coin display name
`address`	string	Contract address on Base
`coinType`	string	`post`, `creator-coin`, or `trend`
`marketCap`	string	Market cap in USD
`marketCapDelta24h`	string	24h market cap change in USD
`volume24h`	string	24h trading volume in USD
`uniqueHolders`	number	Number of unique holder addresses
`createdAt`	string	ISO 8601 creation timestamp
`creatorAddress`	string	Creator's wallet address
`creatorHandle`	string	Creator's Zora handle
`trades`	array	Recent swap activity

get price-history

Display price history for a coin with an ASCII sparkline chart. Replaces the standalone price-history command.

zora get price-history [typeOrId] [identifier] [options]

Arguments

Argument	Description
`typeOrId`	Type prefix (`creator-coin`, `trend`) or coin address/name when used alone
`identifier`	Coin address (`0x...`) or name — only needed when a type prefix is provided

Options

Flag	Description	Default
`--interval <interval>`	Time range: `1h`, `4h`, `1d`, `1w`	`1w`
`--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

Weekly price chart for jacob creator coin

npx @zoralabs/cli get price-history creator-coin jacob

 Coin              jacob
 Type              creator-coin
 Interval          1w
 High              $0.0004846
 Low               $0.0004302
 Change            -9.9%
 
 █▇▇▇▇▆▆▆▇▇██████▆▆▅▅▅▄▂▂▁▁▁▂▃▁▂▂▂

24-hour chart for zora trend

npx @zoralabs/cli get price-history trend zora --interval 1d

JSON output

npx @zoralabs/cli get price-history creator-coin jacob --json --interval 1w

{
  "coin": "jacob",
  "type": "creator-coin",
  "interval": "1w",
  "high": 0.0004846,
  "low": 0.0004302,
  "change": -9.94,
  "prices": [
    { "timestamp": "2026-03-23T17:55:00", "price": 0.000483 },
    { "timestamp": "2026-03-24T06:31:15", "price": 0.0004791 }
  ]
}

JSON Fields

Field	Type	Description
`coin`	string	Coin display name
`type`	string	Coin type
`interval`	string	Requested time interval
`high`	number	Highest price in USD during interval
`low`	number	Lowest price in USD during interval
`change`	number	Percentage change over interval
`prices`	array	Array of `{ timestamp, price }` data points

get trades

Show recent buy/sell activity on a coin.

zora get trades [typeOrId] [identifier] [options]

Arguments

Argument	Description
`typeOrId`	Type prefix (`creator-coin`, `trend`) or coin address/name when used alone
`identifier`	Coin address (`0x...`) or name — only needed when a type prefix is provided

Options

Flag	Description	Default
`--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	—

Examples

View recent trades on jacob

npx @zoralabs/cli get trades creator-coin jacob --static

 Recent Trades — jacob
 
 #  Trader          Side  Amount      Value USD  Tx Hash
 1  0xabc1...2345   BUY   1,250.00    $5.23      0xdef1...
 2  alice.eth       SELL  500.00      $2.10      0x123a...
 3  0xfed9...8765   BUY   3,000.00    $12.60     0x456b...

JSON output

npx @zoralabs/cli get trades creator-coin jacob --json

{
  "trades": [
    {
      "side": "BUY",
      "trader": "0xabc1...2345",
      "amount": "1250.00",
      "valueUsd": "5.23",
      "txHash": "0xdef1..."
    }
  ],
  "nextCursor": "eyJsYXN0X..."
}

Interactive Controls

In live mode, navigate trades with:

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

get holders

Show top holders of a coin with balance and percentage of total supply.

zora get holders [typeOrId] [identifier] [options]

Arguments

Argument	Description
`typeOrId`	Type prefix (`creator-coin`, `trend`) or coin address/name when used alone
`identifier`	Coin address (`0x...`) or name — only needed when a type prefix is provided

Options

Flag	Description	Default
`--limit <n>`	Number of results (1-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	—

Examples

View top holders of jacob

npx @zoralabs/cli get holders creator-coin jacob --static

 Top Holders — jacob
 
 #  Handle/Address    Balance      Ownership %
 1  jacob.eth         50,000.00    12.5%
 2  0xabc1...2345     25,000.00    6.3%
 3  0xfed9...8765     10,000.00    2.5%

JSON output

npx @zoralabs/cli get holders creator-coin jacob --json

{
  "holders": [
    {
      "address": "0xabc1...2345",
      "handle": "jacob.eth",
      "balance": "50000.00",
      "ownershipPercent": "12.5"
    }
  ],
  "nextCursor": "eyJsYXN0X..."
}

Interactive Controls

In live mode, navigate holders with:

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