https://github.com/chainstacklabs/polymarket-alpha-bot
Seek alpha in Polymarket events
https://github.com/chainstacklabs/polymarket-alpha-bot
polymarket prediction trading
Last synced: about 2 months ago
JSON representation
Seek alpha in Polymarket events
- Host: GitHub
- URL: https://github.com/chainstacklabs/polymarket-alpha-bot
- Owner: chainstacklabs
- License: apache-2.0
- Created: 2026-01-07T08:54:46.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-01-25T20:54:08.000Z (2 months ago)
- Last Synced: 2026-01-26T12:08:34.376Z (2 months ago)
- Topics: polymarket, prediction, trading
- Language: Python
- Homepage:
- Size: 2.16 MB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Chainstack is the leading suite of services connecting developers with Web3 infrastructure
• Homepage •
Supported protocols •
Chainstack blog •
Blockchain 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`).
## 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](https://docs.astral.sh/uv/)
- **Node.js 18+** via [fnm](https://github.com/Schniz/fnm), nvm, or brew
## Quick Start
```bash
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):
```bash
make install # Install deps
make dev # Start both servers
```
**Without make**:
```bash
# 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.