Skip to main content

​
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 📦

​
Step 2: Configure your wallet 👛

Run the setup wizard to configure your private key and network: 
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.) 🎨
Your configuration is stored securely at ~/.config/httpcat/config.json 🔒

​
Step 3: Fund your wallet 💰

Get free testnet tokens:
  1. Visit Base Sepolia Faucet
  2. Get test ETH for gas fees
  3. 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 🔀

  • Network: eip155:84532
  • Agent URL: https://agent.402.cat
  • Buy amounts: 0.05,0.05, 0.10, $0.20 USDC
  • Initial market cap: $6.90
  • Graduation threshold: $69
  • Perfect for: Testing, learning, experimenting
  • Network: eip155:8453
  • Agent URL: https://agent.402.cat
  • Buy amounts: 50,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. 💡