██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
██║     ██║     ███████║██║   ██║██║  ██║█████╗  
██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝  
╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
 ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
                                                 
████████╗██████╗  █████╗ ██████╗ ███████╗██████╗ 
╚══██╔══╝██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔══██╗
   ██║   ██████╔╝███████║██║  ██║█████╗  ██████╔╝
   ██║   ██╔══██╗██╔══██║██║  ██║██╔══╝  ██╔══██╗
   ██║   ██║  ██║██║  ██║██████╔╝███████╗██║  ██║
   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚══════╝╚═╝  ╚═╝

Claude Trader

Trade Polymarket with Natural Language via Claude Code

Docs · Web UI · Examples

---

"buy 10 shares of Trump wins at 45 cents"

Natural language trading system for Polymarket integrated with Claude Code. Voice input via Whisper, web cockpit dashboard, memory/pattern system, auto-trading mode. Full API wrapper included.

---

File Map

  claude-trader/
  AGENTS.md
  CLAUDE.md
  PLAYBOOK.md
  README.md
  TRADING_MEMORY.md
  UPGRADE_PLAN.md
  _config.yml
  alerts.py
  auto.py
  cockpit.py
  cockpit_web.py
  config.py
  crypto.py
  interactive.py
  market_db.py
  polymarket_api.py
  requirements.txt
  rtds_client.py
  setup.sh
  setup_wizard.py
  trade.py
  utils.py
  voice_trade.py
  voice_trade_simple.py
  voice_trader_full.py
  docs/
    CLAUDE.md
    README.md
    TRADING_MEMORY.md
    index.html
    style.css
  examples/
    basic_trading.py
    ladder_strategy.py
    quickstart.py
    spike_detector.py
  memory/
    __init__.py
    mindmap.py
    store.py
  ... (29 more files)

---

Trade Polymarket using natural language with Claude Code.

Instead of clicking around or writing code, just tell Claude what you want:

> buy 10 shares of "Trump wins" at 45 cents
> show me the orderbook
> what's my position?
> cancel all my orders

Why this exists

I use Claude Code for development and wanted to trade Polymarket without leaving the terminal. This gives Claude the tools to understand markets and execute trades on my behalf.

Who this is for

• Claude Code users who trade prediction markets
• Developers building AI trading tools
• NOT for beginners - you should understand Polymarket first

Quick look

User: "buy 10 at 35c for the Trump market"

Claude:
┌───────────┬─────────────────────────┬─────────┐
│  Action   │        Details          │ Status  │
├───────────┼─────────────────────────┼─────────┤
│ BUY YES   │ 10 @ 35¢ ($3.50)        │ pending │
│ Market    │ Trump wins 2024         │         │
└───────────┴─────────────────────────┴─────────┘
Confirm? (y/n)

User: "yes"

Claude: ✓ Order matched

Install

git clone https://github.com/exhuman777/claude-trader.git
cd claude-trader
./setup.sh

Or manually:

python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python setup_wizard.py

Voice Trading

Trade using your voice - supports Polish and English:

python voice/voice_trader.py

Hold ENTER to speak:

• "buy 10 shares at 35 cents"
• "kup dziesięć akcji po trzydzieści pięć centów"
• "pokaż zamówienia" / "show orders"
• "anuluj wszystko" / "cancel all"

Voice is transcribed locally using Whisper - nothing leaves your machine.

What you can say

View markets:

"Load the Trump election event"
"Show me the orderbook for market 1230810"
"What are the best bid and ask?"

Trade:

"Buy 5 YES at 35 cents"
"Sell 10 at 60 cents"
"Quick buy $50 worth at market price"

Ladders:

"Set up a buy ladder from 30 to 40 cents, 5 orders, 10 shares each"
"Ladder sell from 60 to 70, 5 orders"

Manage:

"Show my open orders"
"Cancel order 0x123..."
"Cancel all orders"
"What's my USDC balance?"
"Show my positions"

Available functions

Function	Purpose
show_event(slug)	Load event from URL
place_order(id, side, price, size)	Limit order
place_ladder(...)	Multiple orders
quick_buy(id, size)	Buy at ask
quick_sell(id, size)	Sell at bid
show_orders()	Open orders
cancel_order(id)	Cancel one
cancel_all_orders()	Cancel all
get_positions()	Your positions
get_balances()	USDC balance

Interactive mode

For a guided CLI experience:

python interactive.py

Then:

trade> https://polymarket.com/event/trump-election
trade> buy 5 jan 25 at 35c
trade> ladder sell from 60 to 70 jan 31 5 orders 5 shares
trade> orders
trade> cancel all

Price format

• Prices are decimals: 0.35 = 35 cents
• Display shows: 35¢
• NEVER use percentages (35% means something different)

Automation (auto.py)

Follow whale trades:

from auto import whale_follow
whale_follow(min_usd=5000, bet=5, only_profitable=True)

Top volume betting:

from auto import top_volume_bet
top_volume_bet(bet=5, count=3)

Web Terminal

Browser-based trading with voice:

python web/server.py
# Open http://localhost:8000

Features:

• xterm.js terminal in browser
• Voice input (hold mic button or V key)
• Quick command buttons
• API endpoints sidebar
• Memory/insights commands

Files

├── polymarket_api.py   # Core API (import this)
├── interactive.py      # Interactive CLI
├── trade.py            # Direct CLI
├── auto.py             # Automation
├── voice/              # Voice trading
│   ├── recorder.py     # Push-to-talk mic recording
│   ├── transcribe.py   # Whisper PL/EN transcription
│   └── voice_trader.py # Voice→Trade pipeline
├── web/                # Web terminal
│   ├── server.py       # FastAPI + WebSocket server
│   └── static/         # Frontend assets
├── memory/             # Session memory
│   ├── store.py        # Knowledge persistence
│   └── mindmap.py      # Strategy tracking
├── cockpit.py          # Display helpers
├── setup_wizard.py     # Credential setup
├── CLAUDE.md           # AI agent instructions
└── PLAYBOOK.md         # Proven patterns

Memory System

Learns from your sessions to avoid repeating analysis:

# In terminal or web
> memory    # Show context from past sessions
> insights  # Show what worked / what to avoid

Memory tracks:

• Successful trading patterns
• Failed approaches to avoid
• Market observations
• Cached research results

Security

• Credentials stored in data/.trading_config.json (gitignored)
• Optional password encryption for private key
• Never commit secrets

Limitations

• Polymarket only
• Requires Claude Code or similar AI assistant
• You're responsible for your trades
• API rate limits apply

Related

• yesno-events - Full trading terminal with TUI
• polymarket-python - Clean API wrapper

License

MIT - Do what you want.