Best Polymarket GitHub Repositories 2026 | Trading Bots, APIs & Tools

The Polymarket ecosystem has spawned dozens of open-source tools on GitHub, from trading bots and market makers to arbitrage scanners and analytics dashboards. With 169+ monthly searches for gamma-api.polymarket.com graphql and 39+ searches for warproxxx/poly-maker, developers are actively looking for code examples and frameworks. This comprehensive 2026 guide reviews the best Polymarket GitHub repositories, analyzing code quality, features, documentation, and real-world usage.

Whether you're building a Polymarket trading bot, looking for API examples, or seeking inspiration for your own project, these repositories represent the best of the Polymarket developer ecosystem. All code has been reviewed and tested for quality, security, and functionality.

Trading Bots and Market Makers

1. warproxxx/poly-maker - Market Making Bot

Search Volume: 39+ monthly searches | Stars: 50+ | Language: Python

The most searched Polymarket trading bot on GitHub, poly-maker is a comprehensive market making framework that provides continuous liquidity to Polymarket markets. With 39+ monthly searches, this repo is the go-to reference for building market making bots.

Key Features

• Orderbook Analysis: Analyzes bid-ask spreads to identify profitable market making opportunities
• Automated Limit Orders: Places and manages limit orders on both sides of the orderbook
• Risk Management: Position limits, maximum exposure controls, and stop-loss mechanisms
• py-clob-client Integration: Uses the official py-clob-client library
• Real-time Monitoring: Tracks positions, P&L, and market conditions

Code Quality Analysis

Installation and Setup

# Clone repository
git clone https://github.com/warproxxx/poly-maker.git
cd poly-maker

# Install dependencies
pip install -r requirements.txt

# Configure environment variables
cp .env.example .env
# Edit .env with your API keys

# Run the bot
python main.py

Architecture Overview

The bot follows a modular architecture:

• Market Scanner: Identifies markets with good liquidity and spreads
• Orderbook Analyzer: Calculates optimal bid/ask prices based on current orderbook
• Order Manager: Places, updates, and cancels limit orders
• Risk Manager: Monitors positions and enforces risk limits
• Position Tracker: Tracks P&L and position sizes

2. trust412/polymarket-spike-bot-v1 - Spike Detection Bot

Search Volume: 15+ monthly searches | Stars: 30+ | Language: Python

This bot detects rapid price movements (spikes) on Polymarket and executes trades automatically. It's designed for traders who want to capitalize on sudden market movements, whether from news events, whale activity, or market inefficiencies.

Key Features

• Price Movement Detection: Monitors markets for rapid price changes
• Automated Execution: Places trades immediately when spikes are detected
• Configurable Thresholds: Set minimum spike size and volume requirements
• Multi-Market Monitoring: Tracks multiple markets simultaneously
• Risk Controls: Position size limits and maximum exposure

How It Works

The bot continuously monitors market prices via the Gamma API and WebSocket connections. When a price moves beyond configured thresholds (e.g., 5% in 1 minute), it:

1. Verifies the spike is legitimate (not a small-volume glitch)
2. Calculates optimal entry price and size
3. Places a market order via CLOB API
4. Sets a stop-loss or take-profit order
5. Monitors the position and exits when targets are met

Arbitrage Bots

3. carlosibcu/polymarket-kalshi-btc-arbitrage-bot

Search Volume: 7+ monthly searches | Stars: 20+ | Language: Python

This sophisticated arbitrage bot exploits price differences between Polymarket and Kalshi for Bitcoin price prediction markets. It's one of the few publicly available cross-platform arbitrage bots and demonstrates advanced techniques for finding and executing arbitrage opportunities.

Arbitrage Strategy

The bot implements two types of arbitrage:

Technical Implementation

The bot uses multiple APIs simultaneously:

• Polymarket Gamma API: Fetches market data and prices
• Polymarket CLOB API: Places orders on Polymarket
• Kalshi API: Fetches prices and places orders on Kalshi
• WebSocket Connections: Real-time price monitoring

Code Example: Price Comparison

async def find_arbitrage_opportunities():
    """Find price differences between Polymarket and Kalshi."""
    # Fetch BTC markets from both platforms
    poly_markets = await fetch_polymarket_btc_markets()
    kalshi_markets = await fetch_kalshi_btc_markets()
    
    opportunities = []
    
    for poly_market in poly_markets:
        # Match by price bracket
        kalshi_match = find_matching_kalshi_market(
            poly_market, kalshi_markets
        )
        
        if kalshi_match:
            poly_price = float(poly_market['outcome_prices'][0])
            kalshi_price = float(kalshi_match['price'])
            
            spread = abs(poly_price - kalshi_price)
            
            # Minimum 2% spread after fees
            if spread > 0.02:
                opportunities.append({
                    'poly_market': poly_market,
                    'kalshi_market': kalshi_match,
                    'spread': spread,
                    'profit_pct': (spread * 100) - (0.6)  # Fees: 0.3% each side
                })
    
    return sorted(opportunities, key=lambda x: x['profit_pct'], reverse=True)

API Clients and Wrappers

4. polymarket/py-clob-client - Official Python Client

Stars: 100+ | Language: Python | Status: Officially maintained

The official Python client for Polymarket's CLOB API, maintained by Polymarket themselves. This is the recommended library for building Python trading bots and tools.

Key Features

• Complete API Coverage: All CLOB API endpoints supported
• Authentication: L1 and L2 authentication methods
• Type Safety: Strong typing with type hints
• Documentation: Comprehensive docs and examples
• Active Development: Regularly updated with new features

Installation

# Install from PyPI
pip install py-clob-client

# Or from source
git clone https://github.com/polymarket/py-clob-client.git
cd py-clob-client
pip install -e .

For complete usage examples, see our py-clob-client examples guide and Python tutorial.

5. Community API Wrappers

Several community-maintained wrappers provide additional features:

Analytics and Data Tools

6. Portfolio Trackers

Several open-source portfolio trackers help monitor positions across markets:

• Real-time P&L tracking across all active positions
• Historical performance analysis and statistics
• Market alerts for price movements and new markets
• Export capabilities for tax reporting and analysis

While specific repos vary, most use the Gamma API to fetch market data and CLOB API to track positions. See our portfolio tracker guide for recommendations.

How to Choose the Right Repository

With dozens of repositories available, here's how to select the best one for your needs:

For Trading Bots

• Start with poly-maker if you want market making - it's the most complete and well-documented
• Use spike-bot as reference for price monitoring and automated execution
• Study arbitrage bot for cross-platform strategies and advanced techniques

For API Integration

• Python: Use official py-clob-client + Gamma API directly
• JavaScript: Use fetch/axios with our JavaScript tutorial
• Rust: See our Rust API guide for examples

For Learning

• Read multiple repos to understand different approaches
• Start simple: Begin with basic API examples before advanced bots
• Test thoroughly: Always test on small amounts before deploying capital

Security Best Practices

When using or forking these repositories, follow these security guidelines:

Contributing to Open Source

These repositories thrive on community contributions. Ways to contribute:

• Report bugs: File issues with detailed reproduction steps
• Suggest features: Propose improvements that would benefit the community
• Submit PRs: Fix bugs, add features, improve documentation
• Write documentation: Help others understand and use the tools
• Share results: Document your usage and results (anonymized)

Additional Resources

Beyond these repositories, check out these comprehensive guides:

• Complete Python Tutorial - Step-by-step bot building guide
• JavaScript API Tutorial - Node.js and browser examples
• CLOB API Reference - Complete endpoint documentation
• Gamma API Guide - Market data API reference
• Trading Bot Guide - Complete bot development walkthrough
• Arbitrage Strategies - Finding and executing arbs

See What Whales Are Trading Right Now

Get instant alerts when top traders make moves. Track P&L, win rates, and copy winning strategies.

Free forever. No credit card required.