race-monitor 0.5.0

A Python library for Race Monitor

race-monitor-py

A Python library for Race Monitor

Requirements

• Python 3.10 or later
• A Race Monitor API token — obtainable from your account at race-monitor.com

Installation

pip install race-monitor

Or with uv:

uv add race-monitor

Quick Start

Sync

from race_monitor import RaceMonitorClient

with RaceMonitorClient(api_token="YOUR_TOKEN") as client:
    race = client.race.details(race_id=12345)
    print(race["Race"]["Name"])

    if client.race.is_live(race_id=12345)["IsLive"]:
        session = client.live.get_session(race_id=12345)
        for racer_id, competitor in session["Session"]["Competitors"].items():
            print(competitor["Position"], competitor["FirstName"], competitor["LastName"])

Async

import asyncio
from race_monitor import AsyncRaceMonitorClient

async def main():
    async with AsyncRaceMonitorClient(api_token="YOUR_TOKEN") as client:
        race = await client.race.details(race_id=12345)
        print(race["Race"]["Name"])

asyncio.run(main())

API Namespaces

All endpoints are grouped into namespaces, accessible as client.<namespace>:

Namespace	Description
account	Races associated with your relaying account
common	Reference data: app sections, race types, series
live	Real-time timing data: session, competitors, lap times
race	Race details and live status
results	Post-race results and competitor details

Type Annotations

All methods return typed dicts from race_monitor.types, enabling IDE autocompletion and static type checking:

from race_monitor import RaceMonitorClient
from race_monitor.types import GetSessionResponse, LiveCompetitor

with RaceMonitorClient(api_token="YOUR_TOKEN") as client:
    session: GetSessionResponse = client.live.get_session(race_id=12345)
    competitor: LiveCompetitor = session["Session"]["Competitors"]["42"]

Documentation

• Full library API reference: https://wot-lemons.github.io/race-monitor-py
• Race Monitor API: https://www.race-monitor.com/APIDocs