Unified Feed and API Specifics

This section provides details about Unified Feed and API Specifics for Sportradar's Virtual Sports.

Replay and integration environments

Note: Games are not available on the replay environment.

All Game (including all available modes) work on the Integration environment.

Producer, competitors and tournaments IDs are the same. A season, stage or match that was played on our integration environment cannot be obtained from or reproduced on the production environment and vice-versa.

Note: Even-though the producers and tournaments are the same, matches and stages differ between integration and production.

Virtual Sports URNs

Sports entities that belong to games (seasons, matches, stages, etc.) use specific URN prefixes, so they can be easily identified, e.g. vf:match:xxxxxxxxxxxx.

Virtual Sports URNs are:

  • for Virtual Football: "vf"

  • for Virtual Basketball League: "vbl"

  • for Virtual Dogs (powered by Kiron):"vdr"

  • for Virtual Horses (powered by Kiron):"vhc"

  • for Sim-Play Tennis & Sim-Play ATP Legends: "vti"

  • for Sim-Play Baseball: "vbi"

  • for Sim-Play Cricket:"vci"

Season schedule

Season schedule for pre-match virtual sports

Because of fast bet cycles, Sports API endpoint for getting schedules for a specific date (or methods getCompetitionsFor on SportsInfoManager interface in Java and GetSportEventsByDateAsync on SportDataProvider interface in .NET) do not include virtual seasons and matches.

Schedule for a season needs to be obtained per season directly.

Instead of informing you about the upcoming seasons and matches on the API, we send a fixture_change information for every upcoming season (see next chapter).

Season schedule for Sim-Play products

To inform you about the upcoming matches, Sim-Play producers are sending fixture change messages for each match upon its start.

Fixture Change messages

To inform you about the upcoming seasons, virtual producers are sending fixture change messages for each season upon its start, so you can check the schedule for it and fetch all belonging fixtures.

Markets

Unified Odds Feed uses a unified list of markets which also contains Game markets. Most of the markets are shared with the regular producers (e.g. 1x2 market has ID 1 for all producers).

Subscribing to a tournament

Some of our games also come in different modes (e.g. Virtual Football Euro Cup, Virtual Football League Mode, etc.).

Each of those modes needs to be enabled for your account in our backend. Modes are represented by tournaments in UOF.

Once a mode is configured on our side, the account is subscribed to the tournament.

Note: Note the difference in data between integration and production environments (see Replay and Integration environments).

Recovery windows

Due to faster data, maximum recovery windows are different than in our "regular" producers. Normally the maximum recovery window is 3 hours, however, it might differ on the producer level.

Maximum recovery windows can always be checked on the Available Producers endpoint on the API or via ProducerManager (Java) / ProducersProvider (.NET) interfaces in the SDK.

Note: The SDK handles recovery procedures automatically.

Last updated

Was this helpful?