Skip to content

chainstacklabs/polymarket-alpha-bot

Repository files navigation

Labs

Chainstack is the leading suite of services connecting developers with Web3 infrastructure

HomepageSupported protocolsChainstack blogBlockchain API reference
Start for free

Alphapoly - Polymarket alpha detection platform

Find covering portfolios across correlated prediction markets using predefined rules and LLM decisions. The system detects relationships between markets, classifies them to identify hedging pairs, and tracks their prices. The platform offers a smooth UI for entering detected pairs when profit opportunities exist and tracking your positions.

For a good experience, you'll need to add an LLM from OpenRouter and an RPC node (see .env.example).

Dashboard Screenshot

How It Works

  1. Groups - Fetches multi-outcome markets from Polymarket (e.g., "Presidential Election Winner")
  2. Implications - LLM extracts logical relationships between groups
  3. Portfolios - Finds position pairs that hedge each other with high coverage probability
  4. Positions - Tracks your purchased position pairs

Prerequisites

  • Python 3.12+ with uv
  • Node.js 18+ via fnm, nvm, or brew

Quick Start

cp .env.example .env

# With make
make install && make dev

# Without make
cd backend && uv sync
cd frontend && npm install
cd backend && uv run python -m uvicorn server.main:app --port 8000 &
cd frontend && npm run dev

Dashboard: http://localhost:3000 · API: http://localhost:8000/docs

Commands

With make (auto-detects fnm/nvm/volta):

make install    # Install deps
make dev        # Start both servers

Without make:

# Backend
cd backend && uv sync
cd backend && uv run python -m uvicorn server.main:app --reload --port 8000

# Frontend
cd frontend && npm install
cd frontend && npm run dev

Disclaimer: This software is provided as-is for educational and research purposes only. It is not financial advice. Trading prediction markets involves risk—you may lose money. Use at your own discretion.

About

Find alpha, manage positions in Polymarket

Topics

Resources

License

Stars

Watchers

Forks