Getting Started
Welcome to PolySuggest! This guide will help you get started in 5 minutes.
What is PolySuggest?
PolySuggest is a precision decision-support terminal for Polymarket traders. It combines:
- AI-driven edge detection – Find probability mismatches before markets correct
- Real-time market data – Stream prices, order book, volume from Polymarket
- Portfolio management – Track positions, correlation, risk
- Execution infrastructure – Place orders, estimate slippage, ladder trades
- Research tools – Backtesting, calibration tracking, daily reports
5-Minute Setup
1. Install
Option A: From PyPI (Recommended)
pip install polymarket-ai-market-suggestor
npm install --prefix polysuggest
Option B: From Source
cd polymarket-ai-market-suggestor
pip install -r requirements.txt
cd ../polysuggest
npm install
2. Configure
Create polymarket-ai-market-suggestor/.env:
DATABASE_URL=postgresql://user:password@localhost:5432/polysuggest
GAMMA_API_URL=https://api.gamma.polymarket.com
OPENAI_API_KEY=sk_...
3. Run
# Terminal 1: Backend
cd polymarket-ai-market-suggestor
uvicorn src.polysuggest.api.main:app --reload
# Terminal 2: Frontend
cd polysuggest
npm run dev
Access:
- Dashboard: http://localhost:3000
- API: http://localhost:8000/docs
First Commands
# Generate a suggestion
polysuggest suggest "Will Bitcoin hit $100k?"
# Find edges
polysuggest edges list --top 5
# View portfolio
polysuggest positions summary
# Place an order
polysuggest orders place --market <id> --outcome YES --size 100 --limit 0.45
Next Steps
- Development Setup – Local environment
- CLI Reference – All commands
- Architecture – System design
- Roadmap – What's next
Happy trading! 🚀