sell

Sell a coin. Requires a wallet. Sells from your smart wallet when one is configured, otherwise your EOA.

zora sell [typeOrId] [identifier] [options]

Arguments

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

Options

Flag	Description	Default
`--amount <value>`	Sell specific number of coins	—
`--usd <value>`	Sell USD equivalent worth of coins	—
`--percent <value>`	Sell percentage of coin balance	—
`--all`	Sell entire coin balance	—
`--to <asset>`	Receive asset: `eth`, `usdc`, `zora`	`eth`
`--token <asset>`	Alias for `--to`	—
`--slippage <pct>`	Slippage tolerance percent	`1`
`--quote`	Print quote and exit without trading	—
`--yes`	Skip confirmation prompt	—
`--debug`	Print full request/response JSON	—
`--json`	Machine-readable JSON output	—

Examples

Sell 50% of jacob position

# By address
npx @zoralabs/cli sell 0x9b13358e3a023507e7046c18f508a958cda75f54 --percent 50
 
# By name with type prefix
npx @zoralabs/cli sell creator-coin jacob --percent 50

 Sell jacob (creator-coin)
 
 Selling           10.31 jacob (50%)
 Estimated receive 0.005 ETH
 Receive as        ETH
 
 Confirm? (y/n)

Sell entire position

npx @zoralabs/cli sell 0x9b13358e3a023507e7046c18f508a958cda75f54 --all

Sell and receive USDC instead of ETH

npx @zoralabs/cli sell 0x9b13358e3a023507e7046c18f508a958cda75f54 --all --to usdc

Sell a specific amount

npx @zoralabs/cli sell 0x9b13358e3a023507e7046c18f508a958cda75f54 --amount 100

Get a sell quote

npx @zoralabs/cli sell 0x9b13358e3a023507e7046c18f508a958cda75f54 --all --quote

JSON output

npx @zoralabs/cli sell 0x... --all --yes --json

Quote response (--quote --json):

{
  "action": "quote",
  "coin": "JACOB",
  "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
  "sell": {
    "amount": "20.63",
    "raw": "20630000000000000000",
    "symbol": "JACOB"
  },
  "estimated": {
    "amount": "0.01",
    "raw": "10000000000000000",
    "symbol": "ETH"
  },
  "slippage": 1
}

Sell execution response (--yes --json):

{
  "action": "sell",
  "coin": "JACOB",
  "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
  "sold": {
    "amount": "20.63",
    "raw": "20630000000000000000",
    "symbol": "JACOB"
  },
  "received": {
    "amount": "0.01",
    "raw": "10000000000000000",
    "symbol": "ETH",
    "source": "quote"
  },
  "tx": "0xdef456..."
}