PROJECT: "World Sports Sniper" Algorithmic Betfair BOT

📋 We require an experienced Python developer to build, secure, and deploy a lightweight, multi-sport algorithmic betting system called World Sports Sniper (WSS) on a Linux Ubuntu VPS. The platform will query the Betfair Exchange API (using betfairlightweight) and for one of the systems, The Odds API (to verify sharp lines via Pinnacle closing data). WSS executes low-volume, high-efficiency "value sniping" strategies across 7 world sports. After comprehensively developing our strategy, we have scripts for the 7 systems and associated operations ready to go, with clear instructions prepared to hand over to the right candidate. You will be required to put the components of WSS together on a VPS, fix any errors in the code, troubleshoot any operational issues and deliver a finished product. Over the next 12 months as the systems forward test, you will be available as required to ensure the systems run as intended, with some sports not starting up again for several months. For the right person, outside of the initial 12 month project there is likely to be ongoing work maintaining, expanding, or making alterations. Please READ CAREFULLY below our candidate requirments: # You MUST - be an expert in API and have worked with Betfair before. # You MUST - have a history of positive feedback prooving you are competent and ethical. # You MUST - have high quality English speaking skills. # DESIREABLE - solid understanding of world sports. After reviewing the technical requirments BELOW, please submit your best fixed price offer to be considered. We are willing to pay %75 of your fee after WSS goes LIVE, and the remaining %25 after 12 months of clean operation across all 7 sports. If you have any questions or want to see a sample of our scripts, please don't hesitate to contact us. ─── ⏱️ CHRONOLOGICAL TECHNICAL REQUIREMENTS CHECKLIST Phase 1: Virtual Private Server VPS Environment Provisioning • Server Deployment: Deploy a clean Linux Ubuntu VPS instance 20.04 or 24.04 LTS with 1GB RAM and 1 vCPU. • Geographic Restrictions: Enforce server deployment strictly in the Australia Sydney region data centre to prevent Betfair API geo-blocking. • System Clock Synchronization: Hard-lock the VPS operating system clock strictly to UTC time parameters using timedatectl to avoid calculation errors against Betfair's native UTC payloads. • Directory Blueprint Mapping: Establish the explicit folder layout on the file system: /root/world_sports_sniper/ with dedicated subdirectories for /certs, /config, /engines, and /logs. • Software Container Environment: Provision an isolated Python Virtual Environment (venv) and install core architecture dependencies: betfairlightweight, requests, flask, Flask-BasicAuth, and cryptography. Phase 2: Central Data Layer & Configuration Management • State Database Setup: Implement a local JSON text database file to serve as the unified variable layer for the entire software stack. • State Variable Mapping: Ensure the JSON database dynamically stores, updates, and structures encryption keys, API credentials, Telegram token data, independent sports toggle switches (ON / OFF), and independent custom stake parameters per sports code. Phase 3: The 7 Core Algorithmic Sport Engines Program 7 modular, decoupled Python scripts exactly inside the engines folder. Every module must query Betfair markets precisely 2.1 to 3.1 minutes before the official match start time and apply a 100% Stake Board Depth Failsafe to eliminate partial matches. SYSTEMS: • System 1 MLB Closing Line Sniper • System 2 NFL Key-Number Sniper • System 3 NBA Half-Court Volume Engine • System 4 NRL Golden Weather Matrix • System 5 AFL Torrential Mud Matrix • System 6 NHL Empty-Net Shield • System 7 European Soccer Draw Engine Phase 4: Core Execution & Vulnerability Protection • Master Orchestrator Logic: Build the master orchestrator.py routing routine. It must sequentially unpack app_state.json variables, execute a single authenticated session login with Betfair, securely loop through active sport modules, and close the API gateway cleanly upon termination. • Regex Total Points Extraction: Implement bulletproof text parsing across all sports code lookups utilizing Python's re module to target standalone integers or floating decimals. This prevents parsing crashes caused by league codes or trailing text symbols like incl. OT. • Pinnacle API Timeout Shield: Wrap the external web request inside mlb_sniper.py with a strict 5-second timeout limit and clear error trapping. If the third-party feed drops or throws a bad gateway, the system must log a warning and skip cleanly instead of allowing the master script to hang or crash. • Betfair Duplicate Order Protection Module: Integrate an internal order memory module right before order placement across all 7 scripts. The script must execute using a standardized customer reference tag format. If the tag already exists live on the exchange, the bot must abort the transaction immediately to prevent duplicate betting caused by late match timing delays. Phase 5: Security Compliance & Interface Appliance • Flask Web Control Panel UI: Construct a lightweight local web dashboard (/ui/dashboard.py) powered by Flask that serves a clean HTML/CSS configuration interface to allow the user to Login to Betfair, input keys, view states, input uneven staking parameters, and toggle sports on or off, with a save button at the bottom. • HTTP Basic Authentication Lock: Secure the Flask application from public internet web scanners by deploying the Flask-BasicAuth wrapper. Force a strict global username and password challenge gate over port 5000. • Background UI Daemon Deployment: Configure the web panel to launch detached and run continuously using nohup in a secure background server lane. Phase 6: Telemetry, Alerting & Server Optimization • Telegram Live Notification Hook: Integrate a webhook alerting module inside notifier.py. Link it to successfully completed order packets across all engines, instantly texting formatted Markdown emoji-anchored summaries (Sport, Match, Market, Odds, Stake, and Timestamp) directly to the user's mobile device. • Daily VPS Hardware Heartbeat: Code a standalone heartbeat.py script to run completely separate from the trading routines. It must query physical server space parameters via shutil.disk_usage("/"), parse user toggle status layouts, and broadcast a clean system health telemetry summary via Telegram once a day. • Automated Log Rotation Matrix: Create a customized log rotation profile at /etc/logrotate.d/world_sports_sniper enforcing a maximum text file barrier cap of 10M, daily separation updates, and a retention depth of rotate 7 to guarantee log text files never bloat or freeze VPS memory. • Master Visual Terminal Monitor: Code an optimized bash shell script (check_all_logs.sh) that opens a multiplexed, live-scrolling terminal dashboard utilizing ANSI text color configurations to visually organize system events (Cycles, Matches, Skips, and Failsafe Alerts) in real time. Phase 7: System Scheduler & Final Commissioning • Linux Cron Scheduling Configuration: Clear background tasks and implement the master scheduling code via crontab -e. Hard-lock orchestrator.py to run precisely on the first second of every single minute, and link the heartbeat.py telemetry card to run every morning at exactly 9:00 AM. • Production Audit Compilation Test: Execute full py_compile checks across the entire file layout to verify zero python indentation or syntax errors exist. Run a complete live simulation check to confirm that the script loops log into the Betfair Exchange API gateway, handle filters in under 3 seconds, and terminate their sessions cleanly without memory leakage.