Skip to main content

PolySuggest: Polymarket Precision Terminal

Transform PolySuggest from a market ideation tool into the most precise decision-support terminal for Polymarket traders.

What is PolySuggest?​

PolySuggest is an AI-powered platform that combines:

  • Real-time market data from Polymarket
  • AI-driven edge detection (model vs market price mismatches)
  • Probability calibration with confidence intervals
  • Position management and portfolio risk tracking
  • Execution infrastructure for placing and managing trades

Who is it for?​

  • Solo traders who need real-time edges, P&L tracking, and alerts
  • Prop trading desks who need portfolio management and API access
  • Advanced retail traders who want institutional-grade decision support

Core Features​

1. Edge Detection​

Identifies probability mismatches between AI models and market prices, enabling traders to find +EV opportunities.

2. Real-Time Market Data​

Streaming order book data, liquidity metrics, and price history from Polymarket via the Gamma API.

3. Probability Calibration​

Bayesian inference produces fair probability estimates with credible intervals, validated against historical resolution data.

4. Portfolio Management​

Track positions across multiple markets, compute correlation-adjusted risk, and receive hedge suggestions.

5. Execution Engine​

Place limit orders, estimate slippage, ladder orders for optimal execution, and track fills.

6. Research Velocity​

From trend discovery → hypothesis → execution in under 15 minutes.

Architecture​

Frontend (Next.js 16)
  ↓
API (FastAPI + WebSockets)
  ↓
  ├─ Market Data (Gamma API client)
  ├─ AI/ML (Bayesian inference, multi-model ensemble)
  ├─ Portfolio Tracking (PostgreSQL)
  └─ Task Queue (Celery for backtests, model training)
  ↓
Databases
  ├─ PostgreSQL (positions, orders, trades)
  ├─ TimescaleDB (OHLCV, order book snapshots)
  ├─ Chroma (vector embeddings for semantic search)
  └─ Redis (cache, real-time alerts)

Quick Start​

Installation​

Option A: From PyPI (Recommended)

pip install polymarket-ai-market-suggestor
npm install

Option B: From Source

# Clone repository
git clone https://github.com/BeachTexture/PolySuggest.git
cd polysuggest

# Python CLI
pip install -r polymarket-ai-market-suggestor/requirements.txt

# Next.js frontend
cd polysuggest && npm install

For details, see the PyPI package.

First Steps​

  1. Generate suggestions from trends:

    polysuggest suggest "Will Bitcoin hit $100k by EOY?"

  2. Fetch live market data:

    polysuggest data fetch --market <market_id>

  3. Detect edges:

    polysuggest edges --top 10

  4. Track your positions:

    polysuggest positions --summary

Roadmap​

  • Phase 1 (4-6 weeks): MVP Market Intelligence Hub
  • Phase 2 (6-8 weeks): Edge Engine & Probability Calibration
  • Phase 3 (8-12 weeks): Portfolio & Execution
  • Phase 4 (12+ weeks): Research & ML

See the Roadmap for detailed implementation plans.

Documentation​

Success Metrics (Year 1)​

  • 500+ active users
  • 50+ paid subscribers
  • 65%+ calibration accuracy
  • Featured in 3+ major crypto publications

Ready to get started? Check out the Getting Started Guide.