How to Run a Latency Report

Follow these steps to install the tool, run a latency measurement, and send us the results.

1. Install the project

1. Install uv (skip this if you already have it):

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Download the project archive, latency-monitor-main.zip, then unzip it:

   unzip latency-monitor-main.zip
   cd latency-monitor-main
   

3. Install the project's dependencies:

   uv sync
   

2. Add your API key

1. Copy the example environment file to .env:

   cp .env.example .env
   

2. Open .env in a text editor and set your API key:

   OPTICODDS_API_KEY=your-api-key-here
   

3. Run the script

Run the script with uv run, e.g.:

uv run pinnacle_latency.py --sport soccer --duration 120

• The run stops automatically after --duration seconds (default 60), or you can press Ctrl+C to stop early.
• See the README for all available options (--sport, --league, --fixture_id, --live, --duration, etc.).

When it finishes, two CSV files will be created in the output/ folder:

• pinnacle_latency_<timestamp>.csv — the full event report
• pinnacle_latency_<timestamp>_stats.csv — the latency summary statistics

4. Send us the results

Email both files from the output/ folder to clients@opticodds.com:

• pinnacle_latency_<timestamp>.csv
• pinnacle_latency_<timestamp>_stats.csv

That's it — thank you!