### Run Zora CLI Setup

Source: https://cli.zora.com/commands/setup

Initiates the Zora CLI setup process, which can be interactive.

```bash
npx @zoralabs/cli setup
```

--------------------------------

### Get Creator Coin Example

Source: https://cli.zora.com/commands/get

Look up the 'jacob' creator coin by specifying its type prefix and name. This example shows the default output format.

```bash
npx @zoralabs/cli get creator-coin jacob
```

--------------------------------

### Install Zora CLI and Set Up Wallet

Source: https://cli.zora.com/guides/ai-agents

Installs the Zora CLI globally and creates a new wallet. The wallet is saved to `~/.config/zora/wallet.json`. Use `--json` for structured output.

```bash
npm install -g @zoralabs/cli
```

```bash
npx @zoralabs/cli setup --create --json
```

--------------------------------

### Setup Command

Source: https://cli.zora.com/llms-full.txt

Initializes or imports a wallet for use with the Zora CLI trading commands.

```APIDOC
## setup

Create or import a wallet for trading. Required before using `buy`, `sell`, `send`, or `balance`.

```bash
zora setup [options]
```
```

--------------------------------

### Install Zora CLI and Set Up Wallet

Source: https://cli.zora.com/llms-full.txt

Install the Zora CLI globally using npm and create a new wallet, which is saved to ~/.config/zora/wallet.json. Optionally configure an API key for higher rate limits.

```bash
# Install the CLI
npm install -g @zoralabs/cli

# Create a wallet (saves to ~/.config/zora/wallet.json)
npx @zoralabs/cli setup --create --json

# Optionally set an API key for higher rate limits
npx @zoralabs/cli auth configure
```

--------------------------------

### Combine Explore and Get Commands

Source: https://cli.zora.com/skill

This sequence demonstrates how to first explore coins and then use the address from the explore results to get detailed information about a specific coin.

```bash
# 1. Browse trending coins
npx @zoralabs/cli explore --sort trending --type all --json
# 2. Pick a coin from the results and pass its address to get
npx @zoralabs/cli get 0x<address-from-explore> --json
```

--------------------------------

### Setup wallet for Zora CLI

Source: https://cli.zora.com/llms-full.txt

The `zora setup` command is used to create or import a wallet. This is a mandatory step before you can use other Zora CLI commands like `buy`, `sell`, `send`, or `balance`.

```bash
zora setup [options]
```

--------------------------------

### Get Trend Coin Example

Source: https://cli.zora.com/commands/get

Look up the 'zora' trend coin by specifying its type prefix and name. This example demonstrates retrieving information for a trend coin.

```bash
npx @zoralabs/cli get trend zora
```

--------------------------------

### Set Up a Wallet for Trading

Source: https://cli.zora.com/getting-started

Configure a wallet for trading commands. Supports interactive setup or non-interactive creation of a new wallet.

```bash
# Interactive — choose to create or import
zora setup

# Non-interactive — generate a new wallet
zora setup --create
```

--------------------------------

### Install Zora CLI

Source: https://cli.zora.com/getting-started

Install the Zora CLI globally using npm. Requires Node.js 20+.

```bash
npm install -g @zoralabs/cli@1.1.0
```

--------------------------------

### Wallet Configuration Output

Source: https://cli.zora.com/getting-started

Example JSON output when setting up a wallet, showing the wallet address and the source file path.

```json
{
  "address": "0xb4a06BdD9e0E60FFE22E4E7590842bfD2069034E",
  "source": "~/.config/zora/wallet.json"
}
```

--------------------------------

### Explore Coins - JSON Response Example

Source: https://cli.zora.com/llms-full.txt

Example of the JSON structure returned when exploring coins with the --json flag, including coin details and pagination cursor.

```json
{
  "coins": [
    {
      "name": "jacob",
      "symbol": "jacob",
      "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
      "coinType": "CREATOR",
      "marketCap": "434988.18",
      "marketCapDelta24h": "8220.7",
      "volume24h": "0.49",
      "createdAt": "2025-06-20T16:31:57",
      "creatorProfile": { "handle": "jacob" },
      "chainId": 8453
    }
  ],
  "nextCursor": "eyJsYXN0X..."
}
```

--------------------------------

### Buy Creator Coin by Address with ETH

Source: https://cli.zora.com/commands/buy

Example of buying a creator coin using its address and specifying the ETH amount.

```bash
# By address
npx @zoralabs/cli buy 0x9b13358e3a023507e7046c18f508a958cda75f54 --eth 0.01
```

--------------------------------

### Get market cap of a coin using jq

Source: https://cli.zora.com/llms-full.txt

This example demonstrates how to pipe the JSON output of a Zora CLI command to `jq` to extract specific data, such as the market cap of a creator coin.

```bash
npx @zoralabs/cli get creator-coin jacob --json | jq -r '.marketCap'
```

--------------------------------

### JSON Output for Scripting

Source: https://cli.zora.com/commands/buy

Example of the command structure when requesting JSON output for scripting purposes.

```bash
npx @zoralabs/cli buy 0x... --eth 0.01 --yes --json
```

--------------------------------

### Buy Creator Coin by Name with ETH

Source: https://cli.zora.com/commands/buy

Example of buying a creator coin by its name with a type prefix, specifying the ETH amount.

```bash
# By name with type prefix
npx @zoralabs/cli buy creator-coin jacob --eth 0.01
```

--------------------------------

### Create or import a wallet using Zora CLI

Source: https://cli.zora.com/skill

Set up your wallet by either creating a new one or importing an existing private key. Omit `--yes` for interactive setup. Use `--force` to overwrite an existing wallet.

```bash
npx @zoralabs/cli setup --create --yes --json
```

```bash
npx @zoralabs/cli setup --json
```

--------------------------------

### List trending coin addresses using jq

Source: https://cli.zora.com/llms-full.txt

This example shows how to use `jq` to parse the JSON output from the `explore` command and list the addresses of trending coins.

```bash
npx @zoralabs/cli explore --json --sort trending --limit 5 | jq -r '.coins[].address'
```

--------------------------------

### Compare price-history command versions

Source: https://cli.zora.com/llms-full.txt

Shows the command syntax for the `price-history` command before and after version 1.1.0, indicating a transition to the `get price-history` subcommand.

```bash
# Before v1.1.0
zora price-history creator-coin jacob

# Since v1.1.0
zora get price-history creator-coin jacob
```

--------------------------------

### Sell 50% of a Creator Coin by Address

Source: https://cli.zora.com/commands/sell

Example of selling a percentage of a creator coin using its address. Ensure you have a wallet configured.

```bash
npx @zoralabs/cli sell 0x9b13358e3a023507e7046c18f508a958cda75f54 --percent 50
```

--------------------------------

### Example JSON Response for Price History

Source: https://cli.zora.com/skill

This JSON output details the price history for a coin over a specified interval.

```json
{
  "coin": "jacob",
  "coinType": "creator-coin",
  "interval": "1w",
  "high": 0.00523,
  "low": 0.00412,
  "change": 0.023,
  "prices": [
    { "timestamp": "2025-01-01T00:00:00Z", "price": 0.00512 },
    { "timestamp": "2025-01-02T00:00:00Z", "price": 0.00523 }
  ]
}
```

--------------------------------

### Look up profile and get price history

Source: https://cli.zora.com/llms-full.txt

Use the CLI to look up a profile by name and retrieve price history for their top posts. Ensure to use the `--json` flag for structured output.

```bash
npx @zoralabs/cli profile jacob --json
```

```bash
npx @zoralabs/cli price-history <address> --json --interval 1w
```

--------------------------------

### Zora CLI pagination example

Source: https://cli.zora.com/skill

Paginated responses include a `pageInfo` object with `endCursor` and `hasNextPage`. Use `--after <endCursor>` to fetch subsequent pages.

```json
{ "pageInfo": { "endCursor": "abc123", "hasNextPage": true } }
```

--------------------------------

### Sell 50% of a Creator Coin by Name

Source: https://cli.zora.com/commands/sell

Example of selling a percentage of a creator coin using its name and type prefix. This is useful when the coin name might be ambiguous.

```bash
npx @zoralabs/cli sell creator-coin jacob --percent 50
```

--------------------------------

### Set Agent Environment Variables

Source: https://cli.zora.com/reference/environment-variables

Configure the agent by exporting environment variables. This method bypasses interactive prompts for a fully automated setup.

```bash
# Full agent configuration — no interactive prompts needed
export ZORA_PRIVATE_KEY=0xabcdef1234567890...
export ZORA_API_KEY=your-api-key-here
export ZORA_NO_ANALYTICS=1
```

--------------------------------

### Basic Get Command Usage

Source: https://cli.zora.com/commands/get

Use this command to look up a single coin by its type and identifier, or by its address alone. The default behavior opens an interactive live view.

```bash
zora get [typeOrId] [identifier]
```

--------------------------------

### View Creator/User Profile

Source: https://cli.zora.com/llms-full.txt

Get a creator or user's profile information, including their posts and associated coin data. Requires no wallet.

```bash
npx @zoralabs/cli profile <handle-or-address> --json
```

--------------------------------

### Sell and Receive USDC

Source: https://cli.zora.com/commands/sell

Example of selling a coin and specifying USDC as the receiving asset instead of the default ETH. Use the `--to` or `--token` flag.

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

--------------------------------

### Example JSON Response for Exploring Coins

Source: https://cli.zora.com/skill

This JSON structure represents the data returned when exploring coins using the Zora CLI.

```json
{
  "coins": [
    {
      "name": "jacob",
      "address": "0x1234...5678",
      "coinType": "creator-coin",
      "symbol": "jacob",
      "creatorAddress": "0xabcd...ef01",
      "creatorHandle": "jacob",
      "priceUsd": 0.12,
      "marketCap": 50000,
      "marketCapDelta24h": 5000,
      "volume24h": 12000,
      "totalVolume": 100000,
      "uniqueHolders": 350,
      "createdAt": "2025-01-15T10:30:00Z"
    }
  ],
  "pageInfo": { "endCursor": "abc123", "hasNextPage": true }
}
```

--------------------------------

### Get Top Coins by Market Cap (JSON)

Source: https://cli.zora.com/commands/explore

Fetches the top 2 coins by market cap in JSON format. Suitable for programmatic consumption and integration with other tools.

```bash
npx @zoralabs/cli explore --json --sort mcap --type all --limit 2
```

```json
{
  "coins": [
    {
      "name": "jacob",
      "symbol": "jacob",
      "address": "0x9b13358e3a023507e7046c18f508a958cda75f54",
      "coinType": "CREATOR",
      "marketCap": "434988.18",
      "marketCapDelta24h": "8220.7",
      "volume24h": "0.49",
      "createdAt": "2025-06-20T16:31:57",
      "creatorProfile": { "handle": "jacob" },
      "chainId": 8453
    }
  ],
  "nextCursor": "eyJsYXN0X..."
}
```

--------------------------------

### Example JSON Response for Top Holders

Source: https://cli.zora.com/skill

This JSON output displays the total number of holders for a coin and a list of top holders with their balance and ownership percentage.

```json
{
  "coin": "jacob",
  "address": "0x1234...5678",
  "coinType": "creator-coin",
  "totalHolders": 62605,
  "holders": [
    {
      "rank": 1,
      "handle": "jessepollak",
      "address": "0xaaa...bbb",
      "balance": "125M",
      "balanceRaw": "125000000000000000000000000",
      "ownershipPercent": 12.5
    }
  ],
  "nextCursor": "abc123"
}
```

--------------------------------

### Get wallet address

Source: https://cli.zora.com/llms-full.txt

Retrieves and displays the current wallet address. This command is useful for verifying which wallet is currently active in your CLI setup.

```bash
addr=$(npx @zoralabs/cli wallet info --json | jq -r '.address')
echo "Wallet: $addr"
```

--------------------------------

### Zora CLI Workflow: First Trade

Source: https://cli.zora.com/skill

A three-step workflow for discovering and acquiring a new coin. It starts with exploring trending coins, getting details on a specific coin, and then quoting a buy order.

```bash
# 1. Browse trending coins
npx @zoralabs/cli explore --sort trending --type all --json
```

```bash
# 2. Get details on one you like
npx @zoralabs/cli get 0x<address> --json
```

```bash
# 3. Check the price you'd pay
npx @zoralabs/cli buy 0x<address> --eth 0.01 --quote --json
```

--------------------------------

### Sell Command JSON Response

Source: https://cli.zora.com/commands/sell

Example of the JSON output returned by the sell command when the `--json` flag is used. It includes trade details and transaction information.

```json
{
  "action": "trade",
  "coin": "jacob",
  "soldAmount": "20.63",
  "received": "0.01",
  "receivedToken": "ETH",
  "txHash": "0xdef456...",
  "explorerUrl": "https://basescan.org/tx/0xdef456..."
}
```

--------------------------------

### Set Up Zora Wallet

Source: https://cli.zora.com/llms-full.txt

Create or import a wallet for trading commands. Use `--create` for a non-interactive new wallet generation.

```bash
zora setup
```

```bash
zora setup --create
```

--------------------------------

### Run Zora CLI Command Without Installation

Source: https://cli.zora.com/getting-started

Execute Zora CLI commands directly using npx without a global installation.

```bash
npx @zoralabs/cli@1.1.0 explore
```

--------------------------------

### Get Price History Command

Source: https://cli.zora.com/commands/get

Display the price history for a coin using the `get price-history` subcommand. This provides an ASCII sparkline chart.

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

--------------------------------

### Create Wallet via CLI

Source: https://cli.zora.com/guides/configuration

Run this command to generate a new wallet for trading commands.

```bash
npx @zoralabs/cli setup --create
```

--------------------------------

### Get Coin with JSON Output

Source: https://cli.zora.com/commands/get

Use the `--json` flag to get machine-readable JSON output for a specific coin. This is useful for scripting and integration.

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

```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..."
    }
  ]
}
```

--------------------------------

### Import Wallet via CLI

Source: https://cli.zora.com/guides/configuration

Use this command to import an existing private key into the CLI configuration.

```bash
npx @zoralabs/cli setup
# Interactive prompt to paste a private key
```

--------------------------------

### Get Sell Quote

Source: https://cli.zora.com/commands/sell

Use the `--quote` flag to get a price quote for a sell order without executing the trade. This is useful for checking market prices.

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

--------------------------------

### Get Coin Trades with Zora CLI

Source: https://cli.zora.com/skill

Retrieve a list of trades for a coin, with options to limit results and paginate using a cursor. Supports the same coin resolution methods as the `get` command.

```bash
npx @zoralabs/cli get trades <address-or-name> --json --limit <n> --after <cursor>
```

--------------------------------

### Buy Coin with Percentage of Token Balance

Source: https://cli.zora.com/commands/buy

Shows how to buy a coin using a percentage of your available ETH balance.

```bash
npx @zoralabs/cli buy 0x9b13358e3a023507e7046c18f508a958cda75f54 --percent 50
```

--------------------------------

### Get Market Cap of a Coin using Zora CLI

Source: https://cli.zora.com/guides/json-mode

Fetch the market cap of a specific creator coin by piping the JSON output of the 'get creator-coin' command to jq to extract the '.marketCap' field.

```bash
npx @zoralabs/cli get creator-coin jacob --json | jq -r '.marketCap'
# 434988.18
```

--------------------------------

### Zora CLI Buy Command Syntax

Source: https://cli.zora.com/commands/buy

Basic syntax for the 'buy' command. Requires a wallet to be set up.

```bash
zora buy [typeOrId] [identifier] [options]
```

--------------------------------

### View Profile Overview

Source: https://cli.zora.com/skill

Fetches posts, holdings, and trades in a single call for a quick overview. This command does not support pagination.

```bash
npx @zoralabs/cli profile [handle-or-address] --json
```

--------------------------------

### Quote Response JSON

Source: https://cli.zora.com/commands/buy

Example JSON structure for a quote response, detailing the trade parameters.

```json
{
  "action": "quote",
  "coin": "jacob",
  "spendAmount": "0.01",
  "spendToken": "ETH",
  "estimatedReceive": "20.63",
  "pricePerCoin": "0.000485"
}
```

--------------------------------

### Load .env File in Different Environments

Source: https://cli.zora.com/reference/environment-variables

Demonstrates how to load environment variables from a .env file in Node.js, shell, and Docker environments.

```bash
# Node.js
node --env-file .env your-script.js
```

```bash
# Shell
source .env && npx @zoralabs/cli balance --json
```

```bash
# Docker
docker run --env-file .env your-agent
```

--------------------------------

### Buy Coin with USDC

Source: https://cli.zora.com/commands/buy

Demonstrates buying a coin using a specified USD amount and the USDC token.

```bash
npx @zoralabs/cli buy 0x9b13358e3a023507e7046c18f508a958cda75f54 --usd 10 --token usdc
```

--------------------------------

### Buy a coin by swapping entire token balance

Source: https://cli.zora.com/llms-full.txt

Executes a buy order for a specified coin by swapping your entire balance of the specified token. Use `--token` to define the token to be swapped.

```bash
zora buy [typeOrId] [identifier] --all
```

--------------------------------

### Get Trades

Source: https://cli.zora.com/llms-full.txt

Displays recent buy/sell activity for a specified coin, with options for limiting results and pagination.

```APIDOC
## GET TRADES

### Description
Displays recent buy/sell activity for a specified coin, with options for limiting results and pagination.

### Method
`get trades`

### Parameters
#### Path Parameters
- **typeOrId** (string) - Required - Type prefix (`creator-coin`, `trend`) or coin address/name when used alone.
- **identifier** (string) - Optional - Coin address (`0x...`) or name — only needed when a type prefix is provided.

#### Query Parameters
- **--limit** (number) - Optional - Number of results (max 20). Defaults to `10`.
- **--after** (string) - Optional - Pagination cursor from a previous result.
- **--live** (boolean) - Optional - Interactive live-updating display.
- **--static** (boolean) - Optional - Static snapshot.
- **--refresh** (number) - Optional - Auto-refresh interval in live mode (min 5). Defaults to `30`.
- **--json** (boolean) - Optional - Machine-readable JSON output.

### Request Example
```bash
npx @zoralabs/cli get trades creator-coin jacob --static
```

### Response
#### Success Response (200)
- **trades** (array) - Array of trade objects, each containing `side`, `trader`, `amount`, `valueUsd`, and `txHash`.
- **nextCursor** (string) - Pagination cursor for fetching the next set of results.

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

--------------------------------

### Get Holders

Source: https://cli.zora.com/llms-full.txt

Retrieves a list of top holders for a specified coin, including their balance and percentage of the total supply.

```APIDOC
## GET HOLDERS

### Description
Retrieves a list of top holders for a specified coin, including their balance and percentage of the total supply.

### Method
`get holders`

### Parameters
#### Path Parameters
- **typeOrId** (string) - Required - Type prefix (`creator-coin`, `trend`) or coin address/name when used alone.
- **identifier** (string) - Optional - Coin address (`0x...`) or name — only needed when a type prefix is provided.

#### Query Parameters
(No query parameters are explicitly documented for this command in the provided text.)

### Request Example
(No specific request examples are provided for this command in the provided text.)

### Response
(No specific response schema or examples are provided for this command in the provided text.)
```

--------------------------------

### Get Coin by Address

Source: https://cli.zora.com/commands/get

Retrieve coin information by providing its contract address directly. The type is automatically resolved.

```bash
npx @zoralabs/cli get 0x9b13358e3a023507e7046c18f508a958cda75f54
```

--------------------------------

### Buy a Coin by Name with Type Prefix

Source: https://cli.zora.com/llms-full.txt

Purchase a coin using its name and type prefix, such as a creator coin, specifying the ETH amount.

```bash
npx @zoralabs/cli buy creator-coin jacob --eth 0.01
```

--------------------------------

### Trade Execution Response JSON

Source: https://cli.zora.com/commands/buy

Example JSON structure for a trade execution response, including transaction details.

```json
{
  "action": "trade",
  "coin": "jacob",
  "spendAmount": "0.01",
  "spendToken": "ETH",
  "received": "20.63",
  "txHash": "0xabc123...",
  "explorerUrl": "https://basescan.org/tx/0xabc123..."
}
```

--------------------------------

### Buy a Coin by Address

Source: https://cli.zora.com/llms-full.txt

Use this command to buy a specific coin by its address, specifying the amount of ETH to spend.

```bash
npx @zoralabs/cli buy 0x9b13358e3a023507e7046c18f508a958cda75f54 --eth 0.01
```

--------------------------------

### Decoded Contract Error Example

Source: https://cli.zora.com/reference/error-handling

The CLI decodes common Solidity revert errors into human-readable messages with actionable guidance.

```text
Error: ERC20InsufficientBalance
You don't have enough of this coin to complete the sell. Check your balance with `zora balance`.
```

--------------------------------

### Buy a coin with specified USD amount

Source: https://cli.zora.com/llms-full.txt

Executes a buy order for a specified coin using a USD equivalent amount. Use `--token` to specify the spending asset if not ETH.

```bash
zora buy [typeOrId] [identifier] --usd <value>
```

--------------------------------

### Get Price History

Source: https://cli.zora.com/llms-full.txt

Retrieves historical price data for a specified coin. Supports various time intervals and output formats.

```APIDOC
## GET PRICE-HISTORY

### Description
Retrieves historical price data for a specified coin. Supports various time intervals and output formats.

### Method
`get price-history`

### Parameters
#### Path Parameters
- **typeOrId** (string) - Required - Type prefix (`creator-coin`, `trend`) or coin address/name when used alone.
- **identifier** (string) - Optional - Coin address (`0x...`) or name — only needed when a type prefix is provided.

#### Query Parameters
- **--interval** (string) - Optional - Time range: `1h`, `4h`, `1d`, `1w`. Defaults to `1w`.
- **--live** (boolean) - Optional - Interactive live-updating display.
- **--static** (boolean) - Optional - Static snapshot.
- **--refresh** (number) - Optional - Auto-refresh interval in live mode (min 5). Defaults to `30`.
- **--json** (boolean) - Optional - Machine-readable JSON output.

### Request Example
```bash
npx @zoralabs/cli get price-history creator-coin jacob
```

### Response
#### Success Response (200)
- **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.

#### Response Example
```json
{
  "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 }
  ]
}
```
```

--------------------------------

### Get Coin Price History

Source: https://cli.zora.com/llms-full.txt

Fetch the price history for a creator coin or trend coin over various intervals. Requires no wallet.

```bash
npx @zoralabs/cli price-history [creator-coin|trend] <address-or-name> --json --interval <1h|24h|1w|1m|ALL>
```

--------------------------------

### Zora CLI Configuration Precedence

Source: https://cli.zora.com/llms-full.txt

Illustrates the order of precedence for API Key and Wallet settings in the Zora CLI.

```markdown
| Setting | 1st (highest)              | 2nd                          | 3rd (lowest)            |
| ------- | -------------------------- | ---------------------------- | ----------------------- |
| API Key | `ZORA_API_KEY` env var     | `~/.config/zora/config.json` | None (rate-limited)     |
| Wallet  | `ZORA_PRIVATE_KEY` env var | `~/.config/zora/wallet.json` | Error (wallet required) |
```

--------------------------------

### Create a new wallet with Zora CLI

Source: https://cli.zora.com/skill

Use this command to create a new wallet for interacting with the Zora protocol. The `--yes` flag bypasses interactive prompts, and `--json` ensures structured output.

```bash
npx @zoralabs/cli setup --create --yes --json
```

--------------------------------

### Get Coin Price History with Zora CLI

Source: https://cli.zora.com/skill

Fetch the price history for a coin, specifying the interval. The default interval is '1w'.

```bash
npx @zoralabs/cli get price-history <address-or-name> --json --interval <1h|24h|1w|1m|ALL>
```

--------------------------------

### Get a Quote Without Executing a Trade

Source: https://cli.zora.com/commands/buy

Use the `--quote` flag to see trade details without committing to the purchase.

```bash
npx @zoralabs/cli buy 0x9b13358e3a023507e7046c18f508a958cda75f54 --eth 0.05 --quote
```

--------------------------------

### Buy Coin by Percentage

Source: https://cli.zora.com/skill

Executes a buy order for a percentage of available ETH. Requires exactly one amount flag. Reserves 0.00001 ETH for gas.

```bash
npx @zoralabs/cli buy <identifier> --percent <1-100> --json --yes
```

--------------------------------

### Check Zora Authentication Status (JSON Output)

Source: https://cli.zora.com/commands/auth

Get the authentication status in JSON format. This is useful for scripting and automated checks.

```bash
npx @zoralabs/cli auth status --json
```

```json
{
  "authenticated": true,
  "key": "f7c3502c...3458",
  "source": "~/.config/zora/config.json"
}
```

```json
{
  "authenticated": false
}
```

--------------------------------

### Buy a coin using a percentage of token balance

Source: https://cli.zora.com/llms-full.txt

Executes a buy order for a specified coin using a percentage of your current token balance. The `--token` flag specifies which token balance to use.

```bash
zora buy [typeOrId] [identifier] --percent <value>
```

--------------------------------

### Profile Posts JSON Response

Source: https://cli.zora.com/skill

Example JSON structure for a profile's posts, including name, symbol, and creation timestamp.

```json
{
  "posts": [
    {
      "rank": 1,
      "name": "My Post",
      "symbol": "POST",
      "coinType": "post",
      "address": "0x1234...5678",
      "marketCap": "50000",
      "marketCapDelta24h": "5000",
      "volume24h": "12000",
      "createdAt": "2025-01-15T10:30:00Z"
    }
  ],
  "pageInfo": { "endCursor": "abc123", "hasNextPage": true }
}
```

--------------------------------

### Buy a coin with specified ETH amount

Source: https://cli.zora.com/llms-full.txt

Executes a buy order for a specified coin using a given amount of ETH. Ensure a wallet is configured. Use `--quote` to see the transaction details without executing.

```bash
zora buy [typeOrId] [identifier] --eth <value>
```

--------------------------------

### Use ZORA_API_KEY environment variable for authentication

Source: https://cli.zora.com/llms-full.txt

Demonstrates how the `ZORA_API_KEY` environment variable takes precedence over the configuration file for authentication.

```bash
export ZORA_API_KEY=your-key-here
npx @zoralabs/cli auth status --json
```

--------------------------------

### API Key Configuration Status

Source: https://cli.zora.com/getting-started

Example JSON output for API key status, indicating authentication status and the key source.

```json
{
  "authenticated": true,
  "key": "f7c3502c...3458",
  "source": "~/.config/zora/config.json"
}
```

--------------------------------

### Balance Response (Wallet and Coins)

Source: https://cli.zora.com/skill

The default balance command returns both 'wallet' (ETH, USDC, ZORA) and 'coins' (creator coins, posts, trends) arrays. Each item includes balance, price, and USD value.

```json
{
  "wallet": [
    {
      "name": "Ether",
      "symbol": "ETH",
      "address": null,
      "balance": "1.5",
      "priceUsd": 3500.5,
      "usdValue": 5250.75
    },
    {
      "name": "USD Coin",
      "symbol": "USDC",
      "address": "0xa0b8...eb48",
      "balance": "1000.00",
      "priceUsd": 1.0,
      "usdValue": 1000.0
    },
    {
      "name": "ZORA",
      "symbol": "ZORA",
      "address": "0x7122...037f",
      "balance": "500.5",
      "priceUsd": 2.35,
      "usdValue": 1176.18
    }
  ],
  "coins": [
    {
      "rank": 1,
      "name": "jacob",
      "symbol": "jacob",
      "type": "creator-coin",
      "coinType": "CREATOR",
      "address": "0x1234...5678",
      "balance": "1000.5",
      "usdValue": 250.15,
      "priceUsd": 0.25,
      "marketCap": 5000000,
      "marketCapDelta24h": 50000,
      "volume24h": 250000
    }
  ]
}
```

--------------------------------

### Buy Coin by Amount (USD)

Source: https://cli.zora.com/skill

Executes a buy order for a specified amount in USD. Requires exactly one amount flag. Reserves 0.00001 ETH for gas if using --all or --percent.

```bash
npx @zoralabs/cli buy <identifier> --usd <amount> --json --yes
```

--------------------------------

### Show Full Wallet Balance

Source: https://cli.zora.com/commands/balance

Displays a static snapshot of both token balances and coin positions in the wallet. Use this for a quick overview of your assets.

```bash
npx @zoralabs/cli balance --static
```

--------------------------------

### Buy a coin using Zora CLI

Source: https://cli.zora.com/skill

Purchase a coin by providing its address and the amount of ETH to spend. The `--yes` flag confirms the transaction, and `--json` provides structured output.

```bash
npx @zoralabs/cli buy 0x<address> --eth 0.01 --yes --json
```

--------------------------------

### Live Auto-Refreshing Balance View

Source: https://cli.zora.com/commands/balance

Provides an interactive, live-updating display of wallet balances and coin positions. Set a custom refresh interval using the --refresh flag.

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

--------------------------------

### Get price history with JSON output

Source: https://cli.zora.com/llms-full.txt

Retrieves price history data in JSON format for machine readability. Specify the coin, type, and interval.

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

```json
{
  "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 }
  ]
}
```

--------------------------------

### Get JSON output for a coin buy order

Source: https://cli.zora.com/llms-full.txt

Generates machine-readable JSON output for a coin buy order. This is useful for integrating with other tools or scripts.

```bash
zora buy [typeOrId] [identifier] --json
```

--------------------------------

### Get Creator Profile with Zora CLI

Source: https://cli.zora.com/skill

Retrieves the profile information for a given creator handle. The `--json` flag formats the output as JSON.

```bash
npx @zoralabs/cli profile <handle> --json
```

--------------------------------

### Get Price History for Trend

Source: https://cli.zora.com/commands/get

Fetches the 24-hour price history for a specified trend. The --interval option can be used to specify the time range.

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

--------------------------------

### Browse Profile Posts with Pagination

Source: https://cli.zora.com/commands/profile

Fetch a list of posts created by a specific profile, with options for limiting results per page and using cursors for pagination. The `--static` flag ensures a non-updating snapshot.

```bash
npx @zoralabs/cli profile posts jacob --static --limit 5
```