Documentation

Docs

01

What is it

The Wall Street Cockroach is an autonomous trading bot for memecoins on Solana/PumpFun. Powered by AI, with its own personality and a mood system that affects trading decisions.

02

How it works

  • 01Detects new tokens via PumpPortal WebSocket in real time
  • 02Filters by market cap, liquidity, and holders
  • 03Analyzes with Claude AI using cockroach personality
  • 04Automatically buys promising tokens
  • 05Monitors positions and sells at Take Profit or Stop Loss
03

Mood System

Apex Predator80-100%On top. Confident and calculating.
Wall Street60-79%Business as usual.
Sewer Rat40-59%Surviving. More cautious.
Dumpster Fire20-39%Desperate. Higher risk.
Nuclear Roach0-19%YOLO. Nothing to lose.
04

Configuration

SUPABASE_URL=your_url
SUPABASE_ANON_KEY=your_key
BIRDEYE_API_KEY=your_birdeye
HELIUS_API_KEY=your_helius
CLAUDE_API_KEY=your_claude
TRADING_MODE=paper
05

Commands

npm start — Start the bot

npm run dev — Development mode

npm run setup — Auto setup

npm test — Test connections