Quick Start ⚡

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 📦

npm (Recommended)
npx (No Install)
Homebrew

npm install -g httpcat-cli

npx httpcat-cli@latest

brew tap hathbanger/httpcat
brew install httpcat

Step 2: Configure your wallet 👛

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

httpcat config

You’ll be prompted to:

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

Your configuration is stored securely at ~/.config/httpcat/config.json 🔒

Step 3: Fund your wallet 💰

Base Sepolia (Testnet)
Base (Mainnet)

Get free testnet tokens:

Visit Base Sepolia Faucet
Get test ETH for gas fees
Get test USDC from Circle Faucet

Check your balance:

httpcat balance

Step 4: Create your first token 🪙

httpcat create "My Token" "MTK" --website https://mytoken.io

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

Save the token address! You’ll need it for trading. 💾

Step 5: Trade tokens 📊

Buy tokens:

# 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:

# Sell 50% of your position
httpcat sell 0x1234...402 50%

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

Check your positions:

httpcat positions

Interactive Shell 🐱

Start the interactive shell for a better experience:

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? 🎯

All CLI Commands

Complete reference for all 18+ commands ⌨️

MCP Server

Use httpcat with AI assistants like Claude 🤖

Bonding Curve

Understand how pricing works 📈

API Reference

Build custom applications 🛠️

Testnet vs Mainnet 🔀

Base Sepolia (Testnet)

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

Base (Mainnet)

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

Need Help? 🆘

CLI Configuration

Advanced configuration options ⚙️

x402 Protocol

Learn about micropayments ⚡

All commands support --json flag for automation and --help for detailed information. 💡

Getting Started

httpcat-cli

MCP Server

Core Concepts

Get trading in 5 minutes 🚀

Step 1: Install httpcat-cli 📦

Step 2: Configure your wallet 👛

Step 3: Fund your wallet 💰

Step 4: Create your first token 🪙

Step 5: Trade tokens 📊

Interactive Shell 🐱

What’s Next? 🎯

All CLI Commands

MCP Server

Bonding Curve

API Reference

Testnet vs Mainnet 🔀

Need Help? 🆘

CLI Configuration

x402 Protocol

​Get trading in 5 minutes 🚀

​Step 1: Install httpcat-cli 📦

​Step 2: Configure your wallet 👛

​Step 3: Fund your wallet 💰

​Step 4: Create your first token 🪙

​Step 5: Trade tokens 📊

​Interactive Shell 🐱

​What’s Next? 🎯

All CLI Commands

MCP Server

Bonding Curve

API Reference

​Testnet vs Mainnet 🔀

​Need Help? 🆘

CLI Configuration

x402 Protocol

Get trading in 5 minutes 🚀

Step 1: Install httpcat-cli 📦

Step 2: Configure your wallet 👛

Step 3: Fund your wallet 💰

Step 4: Create your first token 🪙

Step 5: Trade tokens 📊

Interactive Shell 🐱

What’s Next? 🎯

Testnet vs Mainnet 🔀

Need Help? 🆘