TournaChess

USCF Integration

TournaChess connects directly to the USCF API to provide automatic rating lookups, title display, membership validation, and pairing intelligence for USCF-rated sections.

Automatic Rating Lookups

When a player enters their USCF ID during registration, TournaChess automatically looks up their current USCF rating from the USCF API. The rating is retrieved in real time and stored with the registration, so it is immediately available for pairings and display.

If a player has linked their USCF ID to their TournaChess profile, the lookup happens automatically whenever they register for a rated tournament -- no need to re-enter the ID each time.

Periodic Rating Sync

TournaChess automatically refreshes USCF rating data periodically so that the ratings in your tournament reflect the most recent official values. If a player's rating changes between registration and the start of your event, the updated rating will be reflected in your entry list and pairings. A tournament director can force a manual refresh of all USCF ratings from the tournament management page if needed.

Rating Display

USCF ratings appear throughout the tournament experience: entry lists, pairings, standings, and projector views. Players and tournament directors can see the field strength at a glance without consulting any external tools.

Player Title Display

If a player holds a chess title recognized by USCF or FIDE -- such as NM (National Master), FM (FIDE Master), IM (International Master), or GM (Grandmaster) -- the title is displayed next to their name throughout the platform. Titles appear in entry lists, pairings, standings, and projector views. Title information is retrieved automatically during the rating lookup.

USCF ratings display

Membership Validation

Running a USCF-rated tournament means ensuring that all participants have valid USCF memberships. TournaChess automates this process so you can focus on running the event rather than manually checking membership cards.

How Validation Works

When a player registers for a USCF-rated, USCF+FIDE dual-rated, or USCF+NWSRS dual-rated section, TournaChess checks their USCF membership status automatically. The system retrieves the player's membership expiration date from the USCF database and compares it against the tournament dates to determine whether the membership is valid for the duration of the event.

USCF Rule Compliance

TournaChess follows USCF rules when validating memberships. The rules state that a player's membership must be valid through the end of the tournament, not just the current date. In practice, this means:

  • A player whose membership expires after the tournament's end date is shown as valid.
  • A player whose membership expires during the tournament (before the last day) is shown as invalid, because their membership does not cover the entire event.
  • A player whose membership expires on the last day of the tournament is still valid -- they are covered for the full event.

This date-aware validation prevents the common mistake of accepting a player whose membership looks current today but will expire before the tournament finishes.

Visual Indicators

Membership status is shown with color-coded icons next to each player's USCF ID in the registration list:

  • Green checkmark: Membership is valid through the end of the tournament. No action needed.
  • Orange icon: The USCF ID was found but the player does not have an active membership on file. They may have created an ID but never purchased a membership.
  • Red X: Membership has expired or will expire before the tournament ends. The player needs to renew before they can participate in rated play.

These indicators are visible on the registrations tab of your tournament management page, giving you a quick overview of your field's membership status.

Membership validation

Note: If a player's USCF ID is not found in the US Chess database at all, the indicator shows a red X with a tooltip explaining that the ID was not found. Double-check the number with the player and update it in their registration.

Batch Validation

Before starting a tournament, you can review all registered players' membership statuses at once from the registrations tab. The visual indicators appear next to every player with a USCF ID, so you can scan the list and identify anyone who needs to renew before the first round.

Rating Calculations

TournaChess calculates performance metrics for each player during and after the tournament, giving players insight into how they performed relative to their rating.

Performance Ratings

A performance rating represents the rating level at which a player performed during the tournament, based on their results against their specific opponents.

Performance ratings correctly exclude forfeits and byes from the calculation. Only games where the player actually faced an opponent are included, so a forfeit win against a no-show does not inflate the performance rating, and a forfeit loss does not deflate it.

For tournaments with unrated players, TournaChess uses a two-pass algorithm: the first pass estimates unrated opponents at a default rating, and the second pass recalculates using each unrated player's first-pass performance rating for more accurate results.

Estimated Post-Event Ratings

Players can see their projected rating change based on their results so far. This is only an approximation of the official USCF calculation, but it gives players a sense of how their performance will affect their rating once USCF processes the results.

Per-Section Statistics

Each section has its own rating statistics visible in the standings view, including average rating and rating range. This helps you understand the competitive balance of each section.

Per-Player Statistics

Individual performance metrics are available in the standings table. For each player, TournaChess displays:

  • Pre-tournament rating: The player's official rating at the start of the event.
  • Performance rating: The rating level at which they performed based on opponents and results.
  • Estimated post-event rating: The projected new rating after USCF processes the results.

These columns appear in the standings table for USCF-rated and dual-rated sections, giving players immediate feedback on their tournament performance.

Performance ratings

Compliance with USCF Pairing Rules

USCF does not have a formal software validation or certification process for pairing programs. TournaChess implements USCF Swiss pairing rules as defined in the US Chess Federation's Official Rules of Chess. Our implementation is backed by an extensive validation test suite covering hundreds of test cases, including:

  • Rule book examples: Pairing scenarios drawn directly from the Official Rules of Chess.
  • Targeted rule tests: Cases generated to exercise specific pairing rules and edge cases.
  • Cross-referenced sample tournaments: A collection of complete tournaments whose results have been verified against other established pairing programs.

We are not aware of any outstanding issues with our USCF pairing implementation. If you encounter a pairing result that appears incorrect, please contact us so we can investigate and address it promptly.

Results Export

For USCF-rated and USCF+NWSRS dual-rated sections, TournaChess supports two export formats:

  • USCF Export -- Generates DBF files packaged in a ZIP archive. This is the standard format accepted by the USCF online submission portal.
  • SJSON Export -- Generates a file that SwissSys can load for validation.

For USCF+FIDE dual-rated sections, see the FIDE Integration guide for additional export options and USCF submission requirements.

Export results

Tip: Before exporting, make sure your tournament's USCF configuration is complete. Go to your tournament settings and fill in the USCF-specific fields: affiliate ID, chief TD USCF ID, city, state, and ZIP code. These fields are required for a valid USCF submission.

Submitting to USCF

TournaChess generates the export file; you handle the submission:

  1. Export your results from TournaChess.
  2. Log in to the USCF Tournament Submission portal at US Chess.
  3. Upload the exported files following USCF's submission instructions.
  4. USCF processes the results and updates player ratings.

TournaChess does not submit results to USCF on your behalf. The export produces a file in the exact format USCF expects, so the upload is straightforward.

Importing USCF Events

If you have already run a tournament rated by USCF and want to bring its results into TournaChess -- for Grand Prix tracking, historical records, or to have all your club's events in one place -- you can import a completed USCF event directly from the USCF ratings site.

What Gets Imported

TournaChess pulls everything it needs from the USCF API to reconstruct the tournament:

  • Tournament details: Event name, dates, location, affiliate information, and organizing officials (chief TD and assistant TDs).
  • Sections: Each section in the USCF event becomes a section in TournaChess, with its rating system (regular, quick, blitz, or dual) and time control preserved.
  • Players: All players are imported as guest players with their USCF IDs, pre-tournament ratings, and state of residence.
  • Rounds and games: Every round is recreated with full game records including board assignments, colors, and results (wins, losses, draws, forfeits, and byes).
  • Standings: Player standings are calculated with win/loss/draw/bye statistics and performance ratings.

The imported tournament is created in Completed status, ready for viewing and Grand Prix inclusion.

How to Import

  1. Find the event on the USCF ratings site. Copy the event URL from your browser's address bar. It will look like https://ratings.uschess.org/event/202401234.
  2. In TournaChess, go to your club's tournaments page.
  3. Click Import from USCF.
  4. Paste the event URL and click Import.

The import may take a moment for large tournaments while TournaChess fetches all the player and game data.

Import USCF event

Duplicate Detection

If you try to import an event that has already been imported into your club, TournaChess will warn you and show a link to the existing tournament. You can choose to proceed with a second import or cancel and view the existing one instead.

After the Import

The imported tournament appears in your club's tournament list like any other completed event. You can:

  • View standings and pairings for any round.
  • Include it in a Grand Prix series for cumulative scoring across events.
  • Share the tournament page with players so they can review their results.

Limitations

  • Completed events only: The USCF API provides data for rated events that have been processed. Events that have not yet been rated by USCF are not available for import.

Tip: The import button is also available in the Quick Actions sidebar on your club's homepage.

Frequently Asked Questions

What if a player does not have a USCF ID?

Players without a USCF ID can still register for unrated sections. For USCF-rated sections, they need to obtain a USCF membership and ID before participating. Direct them to the US Chess website to purchase a membership.

Why does the estimated post-event rating differ from what USCF calculates?

TournaChess implements a simplified approximation of the USCF rating calculation. TournaChess does not have all of the details that USCF uses to do its calculation. The formula used by TournaChess is a simplified version for approximation purposes. The actual USCF calculation is more sophisticated and may yield different results. The estimated post-event rating is meant to give players a general sense of how they performed, but the official USCF rating change may differ once USCF processes the results.

Still have questions? Visit our Contact page to get in touch with TournaChess support.