Polybot

Open-source Polymarket trading infrastructure and strategy reverse-engineering toolkit.

Polybot is a multi-service system for:

• automated execution (paper and live modes)
• strategy runtime and market making
• market/user trade ingestion into ClickHouse
• quantitative analysis and replication scoring

Future Work: AWARE Fund

Polybot is the execution and market-data foundation for AWARE, the next product layer (trader intelligence, PSI indices, fund mirroring, API/UI).

• Polybot repo: https://github.com/ent0n29/polybot
• AWARE repo: https://github.com/ent0n29/aware

What You Get

• Java 21 microservices for execution, strategy, ingestion, analytics
• ClickHouse + Redpanda event pipeline
• Monitoring stack (Grafana, Prometheus, Alertmanager)
• Research toolkit in research/ for snapshots, deep analysis, and replication metrics

Quick Start (Recommended)

Prerequisites

• Amazon Corretto 21 (recommended) or any Java 21+
• Maven 3.8+
• Docker Engine/Desktop with Compose plugin
• Python 3.11+ (for research scripts)

1. Clone

git clone https://github.com/ent0n29/polybot.git
cd polybot

2. Optional Environment Setup

cp .env.example .env
set -a; source .env; set +a

Note: Spring Boot does not auto-load .env; export variables in your shell when needed.

3. Start Everything

./start-all-services.sh

This script builds missing artifacts, starts infrastructure stacks, then starts all services with develop profile.

4. Verify

curl http://localhost:8080/actuator/health
curl http://localhost:8081/actuator/health
curl http://localhost:8082/actuator/health
curl http://localhost:8083/actuator/health
curl http://localhost:8084/actuator/health
curl http://localhost:8123 --data "SELECT 1"

5. Stop

./stop-all-services.sh

Operator Commands

Build and Test

mvn clean package -DskipTests
mvn test

Tail Logs

tail -f logs/executor-service.log
tail -f logs/strategy-service.log
tail -f logs/analytics-service.log
tail -f logs/ingestor-service.log
tail -f logs/infrastructure-orchestrator-service.log

Manual Startup (Alternative)

mvn clean package -DskipTests

java -jar infrastructure-orchestrator-service/target/infrastructure-orchestrator-service-0.0.1-SNAPSHOT.jar --spring.profiles.active=develop
java -jar executor-service/target/executor-service-0.0.1-SNAPSHOT.jar --spring.profiles.active=develop
java -jar strategy-service/target/strategy-service-0.0.1-SNAPSHOT.jar --spring.profiles.active=develop
java -jar ingestor-service/target/ingestor-service-0.0.1-SNAPSHOT.jar --spring.profiles.active=develop
java -jar analytics-service/target/analytics-service-0.0.1-SNAPSHOT.jar --spring.profiles.active=develop

Services and Ports

Service	Port	Purpose	Example Endpoint
executor-service	8080	order execution, paper sim, settlement endpoints	/api/polymarket/health
strategy-service	8081	strategy runtime and status	/api/strategy/status
analytics-service	8082	analytics APIs on ClickHouse data	/api/analytics/status
ingestor-service	8083	market/user-trade ingestion pipelines	/actuator/health
infrastructure-orchestrator-service	8084	lifecycle of analytics + monitoring stacks	/api/infrastructure/status
ClickHouse HTTP	8123	analytics SQL access	SELECT 1
Redpanda Kafka	9092	event streaming	Kafka bootstrap
Grafana	3000	dashboards	UI
Prometheus	9090	metrics scraping	UI
Alertmanager	9093	alert routing	UI

Configuration Essentials

Key variables are documented in .env.example.

Most relevant:

• POLYMARKET_TARGET_USER for strategy research workflows
• POLYMARKET_PRIVATE_KEY, POLYMARKET_API_KEY, POLYMARKET_API_SECRET, POLYMARKET_API_PASSPHRASE for live trading
• KAFKA_BOOTSTRAP_SERVERS, ANALYTICS_DB_URL, CLICKHOUSE_* for data pipeline
• GRAFANA_ADMIN_PASSWORD, SLACK_WEBHOOK_URL for ops/alerts

Default mode in develop profile is paper trading (hft.mode: PAPER).

Included Strategy

Polybot includes a complete-set arbitrage strategy for Polymarket Up/Down binaries.

See docs/EXAMPLE_STRATEGY_SPEC.md for implementation details.

Research Workflow

The research/ directory contains scripts for:

• snapshot extraction and reporting
• replication and similarity scoring
• backtesting and calibration
• execution quality analysis

Start with research/README.md.

Repo Layout

polybot/
├── polybot-core/
├── executor-service/
├── strategy-service/
├── ingestor-service/
├── analytics-service/
├── infrastructure-orchestrator-service/
├── research/
├── monitoring/
├── start-all-services.sh
└── stop-all-services.sh

Contributing

See CONTRIBUTING.md for setup, style, testing, and PR process.

Disclaimer

This software is for educational and research purposes only.

Trading prediction markets carries financial risk. Always validate with paper mode before any live capital.

License

MIT. See LICENSE.