Polymarket Trading Application - Claude Code Setup

This directory contains all the configuration files needed to use Claude Code for building your Polymarket trading application.

Quick Start

1. Create Your Project

mkdir polymarket-trader
cd polymarket-trader
git init

2. Copy Configuration Files

Copy all files from this directory to your project root:

# Copy everything
cp -r /path/to/polymarket-setup/* .
cp -r /path/to/polymarket-setup/.* .

Or manually copy:

CLAUDE.md → Project root
.claude/ → Project root (contains skills and commands)
.mcp.json → Project root (for MCP server integrations)

3. Launch Claude Code

claude

4. Initialize the Project

In Claude Code, run:

/project:init-polymarket

This will scaffold the entire project structure.

Directory Structure

polymarket-setup/
├── CLAUDE.md                          # Main project context for Claude
├── .mcp.json                          # MCP server configurations
├── .claude/
│   ├── commands/                      # Custom slash commands
│   │   ├── init-polymarket.md         # Initialize project structure
│   │   ├── add-feature.md             # Add new features
│   │   ├── add-strategy.md            # Create trading strategies
│   │   ├── run-backtest.md            # Execute backtests
│   │   └── debug-trading.md           # Debug trading issues
│   └── skills/                        # Custom skills
│       ├── polymarket-api/
│       │   └── SKILL.md               # Polymarket API integration guide
│       ├── trading-strategies/
│       │   └── SKILL.md               # Strategy development framework
│       └── trader-analysis/
│           └── SKILL.md               # Trader tracking & analysis
└── README.md                          # This file

Available Commands

After setup, these slash commands are available in Claude Code:

Command	Description
`/project:init-polymarket`	Scaffold the entire project
`/project:add-feature [description]`	Add a new feature
`/project:add-strategy [name]`	Create a trading strategy
`/project:run-backtest [strategy] [options]`	Run a backtest
`/project:debug-trading [issue]`	Debug trading problems

Custom Skills

The skills provide Claude with specialized knowledge:

polymarket-api

Comprehensive guide for Polymarket's CLOB API, Gamma API, and blockchain integration. Includes:

Authentication patterns
Order placement and management
WebSocket subscriptions
Price calculations
Error handling

trading-strategies

Framework for building, testing, and deploying trading strategies:

BaseStrategy class
Signal generation
Position sizing
Risk management
Backtesting framework

trader-analysis

Tools for discovering and following successful traders:

Trader metrics calculation
Scoring system
Copy trading implementation
Real-time monitoring

Using with Anthropic Skills

You can also use official Anthropic skills alongside these custom ones:

# In Claude Code
/plugin marketplace add anthropics/skills
/plugin install frontend-design@anthropic-agent-skills

Recommended official skills for this project:

frontend-design - For building the React dashboard
webapp-testing - For automated testing
mcp-builder - If you need custom MCP servers

Environment Setup

Before building, ensure you have:

Polymarket Credentials:
- Export your private key from Polymarket
- Generate API credentials using the derivation endpoint
Infrastructure:
- PostgreSQL with TimescaleDB
- Redis for caching and Celery
Node.js & Python:
- Node.js 18+
- Python 3.11+

Tips for Best Results

Start with Planning: Ask Claude to explain its approach before coding
Use Plan Mode: Press Shift+Tab twice to enter Plan Mode
Commit Often: Ask Claude to commit after each feature
Run Tests: Always verify with tests before moving on
One Feature at a Time: Focus on single features for best results

Resources

Support

For issues with:

Claude Code: Check Claude documentation
Polymarket API: Join Polymarket Discord #devs channel
This Setup: Open an issue in your project repository

Happy trading! 🚀

agentmc15-polymarket-trader-1

Popularity

What's Inside

README