> ## Documentation Index
> Fetch the complete documentation index at: https://402.cat/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start ⚡

> Get started with 402.cat in 5 minutes

## Get trading in 5 minutes 🚀

This guide will get you set up with httpcat-cli and ready to create and trade tokens on 402.cat. 🐈

### Step 1: Install httpcat-cli 📦

<Tabs>
  <Tab title="npm (Recommended)">
    ```bash theme={null}
    npm install -g httpcat-cli
    ```
  </Tab>

  <Tab title="npx (No Install)">
    ```bash theme={null}
    npx httpcat-cli@latest
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew tap hathbanger/httpcat
    brew install httpcat
    ```
  </Tab>
</Tabs>

### Step 2: Configure your wallet 👛

Run the setup wizard to configure your private key and network:

```bash theme={null}
httpcat config
```

You'll be prompted to:

1. Enter your private key (or generate a new one) 🔑
2. Select network: Base Sepolia (testnet) or Base (mainnet) 🌐
3. Set your preferences (ASCII art, etc.) 🎨

<Note>
  Your configuration is stored securely at `~/.config/httpcat/config.json` 🔒
</Note>

### Step 3: Fund your wallet 💰

<Tabs>
  <Tab title="Base Sepolia (Testnet)">
    Get free testnet tokens:

    1. Visit [Base Sepolia Faucet](https://faucet.quicknode.com/base/sepolia)
    2. Get test ETH for gas fees
    3. Get test USDC from [Circle Faucet](https://faucet.circle.com/)
  </Tab>

  <Tab title="Base (Mainnet)">
    You'll need:

    1. ETH for gas fees (very minimal on Base)
    2. USDC for trading and creating tokens

    Bridge from Ethereum or other chains via [Base Bridge](https://bridge.base.org)
  </Tab>
</Tabs>

Check your balance:

```bash theme={null}
httpcat balance
```

### Step 4: Create your first token 🪙

```bash theme={null}
httpcat create "My Token" "MTK" --website https://mytoken.io
```

This costs \$0.01 USDC and returns your token address (ending in `402`). 🎯

<Tip>
  Save the token address! You'll need it for trading. 💾
</Tip>

### Step 5: Trade tokens 📊

Buy tokens:

```bash theme={null}
# Testnet amounts: 0.05, 0.10, 0.20 USDC
httpcat buy 0x1234...402 0.10

# Mainnet amounts: 50, 100, 200 USDC
httpcat buy 0x1234...402 100
```

Sell tokens:

```bash theme={null}
# Sell 50% of your position
httpcat sell 0x1234...402 50%

# Sell all
httpcat sell 0x1234...402 all
```

Check your positions:

```bash theme={null}
httpcat positions
```

## Interactive Shell 🐱

Start the interactive shell for a better experience:

```bash theme={null}
httpcat
```

You'll see ASCII art cats and can use commands without the `httpcat` prefix: 😸

```
httpcat> create "Moon Cat" "MOON"
httpcat> buy MOON 0.20
httpcat> info MOON
httpcat> list --sort mcap
```

## What's Next? 🎯

<CardGroup cols={2}>
  <Card title="All CLI Commands" icon="terminal" href="/docs/cli/commands">
    Complete reference for all 18+ commands ⌨️
  </Card>

  <Card title="MCP Server" icon="robot" href="/docs/mcp/overview">
    Use httpcat with AI assistants like Claude 🤖
  </Card>

  <Card title="Bonding Curve" icon="chart-area" href="/docs/concepts/bonding-curve">
    Understand how pricing works 📈
  </Card>

  <Card title="API Reference" icon="code" href="/docs/api-reference/overview">
    Build custom applications 🛠️
  </Card>
</CardGroup>

## Testnet vs Mainnet 🔀

<AccordionGroup>
  <Accordion title="Base Sepolia (Testnet)" icon="flask">
    * **Network**: `eip155:84532`
    * **Agent URL**: `https://agent.402.cat`
    * **Buy amounts**: $0.05, $0.10, \$0.20 USDC
    * **Initial market cap**: \$6.90
    * **Graduation threshold**: \$69
    * **Perfect for**: Testing, learning, experimenting
  </Accordion>

  <Accordion title="Base (Mainnet)" icon="globe">
    * **Network**: `eip155:8453`
    * **Agent URL**: `https://agent.402.cat`
    * **Buy amounts**: $50, $100, \$200 USDC
    * **Initial market cap**: \$6,900
    * **Graduation threshold**: \$69,000
    * **Perfect for**: Real trading, token launches
  </Accordion>
</AccordionGroup>

## Need Help? 🆘

<CardGroup cols={2}>
  <Card title="CLI Configuration" icon="gear" href="/docs/cli/configuration">
    Advanced configuration options ⚙️
  </Card>

  <Card title="x402 Protocol" icon="money-bill-wave" href="/docs/concepts/x402-protocol">
    Learn about micropayments ⚡
  </Card>
</CardGroup>

<Tip>
  All commands support `--json` flag for automation and `--help` for detailed information. 💡
</Tip>