chessdotcom.endpoints.tournament_round_group_details

Get details about a tournament’s round group.

API doc: https://www.chess.com/news/view/published-data-api#pubapi-endpoint-tournament-round-group

chessdotcom.endpoints.tournament_round_group_details.get_tournament_round_group_details(url_id: str, round_num: int, group_num: int, tts=0, **request_options) → ChessDotComResponse
Parameters:

  • url_id – URL for the club’s web page on www.chess.com.

  • round_num – the round of the tournament.

  • group_num – the group in the tournament.

  • tts – the time the client will wait before making the first request.

Returns:

ChessDotComResponse object containing details about a tournament’s round group.

class chessdotcom.endpoints.tournament_round_group_details.GetTournamentRoundGroupDetailsResponse(tournament_round_group, json, text)
Variables:

  • tournament_round_group – Holds the TournamentRoundGroup object.

  • json – The JSON response from the API.

  • text – The raw response from the API.

class chessdotcom.endpoints.tournament_round_group_details.TournamentRoundGroup(players: List[TournamentPlayer], games: List[TournamentGames], fair_play_removals: List[str])
Variables:

  • players – List of TournamentPlayer objects.

  • games – List of TournamentGames objects.

  • fair_play_removals – List of usernames removed for fair play violations.

class chessdotcom.endpoints.tournament_round_group_details.TournamentPlayer(username: str | None, points: float | int | None, is_advancing: bool | None, tie_break: float | int | None)
Variables:

  • username – username of the player.

  • points – the player’s points.

  • is_advancing – whether the player is advancing to the next round.

  • tie_break – the player’s tie-break score.

class chessdotcom.endpoints.tournament_round_group_details.TournamentGames(url: str | None, pgn: str | None, time_control: str | None, end_time: int | None, rated: bool | None, fen: str | None, start_time: int | None, time_class: str | None, rules: str | None, move_by: int | None, last_activity: int | None, draw_offer: str | None, white: GamePlayer | None, black: GamePlayer | None)
Variables:

  • url – URL for the game’s web page on www.chess.com.

  • pgn – the game’s PGN.

  • time_control – the game’s time control.

  • end_time – the time the game ends.

  • rated – whether the game is rated.

  • fen – the game’s FEN.

  • start_time – the time the game starts.

  • time_class – the game’s time class.

  • rules – the game’s rules.

  • move_by – the time the player must move by.

  • last_activity – the time of the game’s last activity.

  • draw_offer – the draw offer.

  • end_datetime – the end time as a datetime object.

  • start_datetime – the start time as a datetime object.

  • last_activity_datetime – the last activity as a datetime object.

  • move_by_datetime – the move by time as a datetime object.

  • white – Holds the GamePlayer object for the white player.

  • black – Holds the GamePlayer object for the black player.

class chessdotcom.endpoints.tournament_round_group_details.GamePlayer(rating: int | None, result: str | None, id: str | None, username: str | None, uuid: str | None)
Variables:

  • rating – the player’s rating.

  • result – the player’s result.

  • id – the player’s ID.

  • username – the player’s username.

  • uuid – the player’s UUID.