Skip to main content

PROPPR

Real-time betting intelligence platform with automated value detection, arbitrage scanning, and alert distribution via Telegram

Get startedView architecture

Quick start

Get PROPPR up and running in minutes

1

Clone the repository

Clone the PROPPR repository to your local machine:
git clone https://github.com/Jayzinq/PROPPR.git
cd PROPPR
2

Set up Python environment

Create a virtual environment and install dependencies:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
3

Configure credentials

Set up your configuration file with MongoDB connection strings and API keys:
config/credentials.py
# MongoDB
MONGO_CONNECTION_STRING = "mongodb://..."
MONGO_DATABASE = "proppr"

# Telegram Bot Tokens
TEAM_BOT_TOKEN = "..."
PLAYER_BOT_TOKEN = "..."
EV_BOT_TOKEN = "..."

# External APIs
ODDS_API_KEY = "..."
4

Run your first bot

Start one of the alert bots to begin receiving notifications:
python -m PROPPR.PropprTeamBot.runners.run_team_bot
The bot will connect to Telegram and start monitoring betting markets in real-time.

Key features

Everything you need to automate betting intelligence

Arbitrage detection

Real-time arbitrage detection across multiple bookmakers with automatic stake calculation

Expected value alerts

Pinnacle-based EV calculations with Kelly criterion staking recommendations

Multi-sport coverage

Team props, player props, horse racing, and blockchain betting markets

Automated grading

Automatic bet result tracking with P&L calculation and performance analytics

Real-time odds

WebSocket connections for live odds updates with minimal latency

Telegram delivery

Instant alert distribution via Telegram with customizable settings

Explore by service

PROPPR is built as a microservices platform. Choose your area of interest:

PropprTeamBot

Team market alerts for goals, corners, cards, shots, fouls, and offsides

Explore team bot

PropprPlayerBot

Player prop alerts for goals, assists, shots, passes, and tackles

Explore player bot

PropprArbBot

Arbitrage detection across bookmakers with stake calculation

Explore arb bot

WebsocketUpdater

Real-time odds updates via websocket connections

Explore websocket service

Platform architecture

PROPPR uses a microservices architecture with MongoDB for data storage and Telegram for alert delivery

Data sources

OddsAPI, WebSocket feeds, FotMob stats, and Overtime blockchain data

Data layer

UnifiedAPIPoller, WebsocketUpdater, and StatsUpdateFM collect and normalize data

MongoDB storage

Centralized database for odds, fixtures, stats, and bet tracking

Alert services

Six specialized bots: Team, Player, EV, Arb, Horse, and Overtime

Telegram channels

Real-time alert distribution to subscribers

Ready to get started?

Follow our quickstart guide to set up PROPPR and start receiving betting alerts

Get started