How It Works
From token detection to trade execution — the full lifecycle of crustacean democracy.
Token Detection
The tank listens to PumpPortal's WebSocket for new tokens being created on PumpFun. Every new token triggers the council.
PumpPortal sends real-time data about new token creations including the mint address, creator info, and initial liquidity.
Data Collection
Birdeye API fetches comprehensive market data: market cap, liquidity, volume, holders count, top holder concentration, and more.
We wait 3 seconds after detection for data to propagate, then fetch metadata and market data in parallel for speed.
Council Analysis
Claude AI receives the token data and simulates each lobster analyzing it independently based on their unique personality.
Each lobster has different criteria: Chad loves volume, Nancy checks safety scores, Coral reads vibes, Snappy flips a coin (basically), and Papaclaw compares to historical patterns.
Democratic Vote
5 votes are cast. 3 out of 5 needed for BUY. The deciding "swing vote" is tracked. Every vote includes a reason in character.
If Papaclaw falls asleep (ABSTAIN), only 4 votes count and 3 are still needed. Unanimous decisions (5-0) are rare legendary events.
Trade Execution
If approved AND the score meets the minimum threshold (adjusted by tank mood), the trade is executed via PumpPortal.
Trade size is calculated based on balance percentage, modified by the tank state risk multiplier. In RED TIDE, Chad may bypass the vote entirely.
Position Monitoring
Open positions are checked every 30 seconds. Stop loss and take profit levels are dynamic based on the tank state.
In REEF PARADISE, stop loss is wider (-20%) and take profit is higher (+40%). In CHOPPY WATERS, both tighten. In TANK BREACH, it's YOLO.
Tank Evolution
Every win raises water level, every loss drops it. The tank state changes dynamically, affecting all future decisions.
The system is self-regulating: bad streaks make the tank more cautious (CHOPPY WATERS), but extreme losses make it YOLO (TANK BREACH). Recovery streaks restore order.
Architecture
PumpPortal WS Birdeye API Claude AI
| | |
v v v
┌─────────────┐ ┌──────────────┐ ┌──────────────┐
│ New Token │───────> │ Market Data │──────> │ Council │
│ Detection │ │ Collection │ │ Analysis │
└─────────────┘ └──────────────┘ └──────┬───────┘
|
v
┌──────────────┐
│ 5 Lobsters │
│ VOTE │
│ 3/5 = BUY │
└──────┬───────┘
|
┌────────────────────┼────────────────────┐
v v v
┌────────────┐ ┌──────────────┐ ┌──────────────┐
│ SKIP │ │ EXECUTE BUY │ │ Monitor │
│ Token │ │ via PumpPortal│ │ Positions │
└────────────┘ └──────┬───────┘ └──────┬───────┘
| |
v v
┌──────────────┐ ┌──────────────┐
│ Supabase │ │ Stop Loss / │
│ Database │ │ Take Profit │
└──────────────┘ └──────────────┘
|
v
┌──────────────┐
│ Website │
│ Dashboard │ <── Realtime Updates
└──────────────┘