Installation

This guide explains how to install the prerequisites, set up the SDK in IntelliJ IDEA, and configure your first project.

Prerequisites

Before you start, make sure the following tools are installed:

1. Java Development Kit (JDK)

   • Version: Java 8 or higher (LTS versions recommended).

   • Verify installation:

     java -version

2. Apache Maven (build & dependency management)

   • Verify installation:

     mvn -version

3. Git (for cloning the example project)

   • Verify installation:

     git --version

4. IntelliJ IDEA (recommended IDE)

   • Community or Ultimate Edition works.

   • Download from JetBrains.

1

Clone the Example Project

Clone the official Unified Odds SDK example project from GitHub:

git clone https://github.com/sportradar/UnifiedOddsSdkJava.git
cd UnifiedOddsSdkJava

💡 If you prefer, you can also download the project as a ZIP and extract it.

2

Open in IntelliJ IDEA

• Launch IntelliJ IDEA.

• Go to: File → New → Project from Existing Sources…

• Select the pom.xml file inside the cloned repository.

• Choose Maven as the project type.

IntelliJ will automatically import dependencies and set up the project.

3

Verify Maven Setup

• In IntelliJ, go to the right-hand side Maven tool window click → Maven.

• Click Reload Project (the refresh 🔄 button).

This forces IntelliJ to re-import the pom.xml, download any new dependencies, and update the project structure accordingly.

4

Update the SDK Version (Optional)

The SDK version is controlled in the pom.xml file. To use a specific version:

<dependency>
  <groupId>com.sportradar</groupId>
  <artifactId>unifiedfeed-sdk</artifactId>
  <version>2.0.59.0</version>
</dependency>

Change the version number and reload Maven to apply the update.

5

Configure the SDK

The example project includes a starter class:

src/main/java/.../UofSdkExamples.java

Edit the configuration inside it:

import com.sportradar.unifiedodds.sdk.OddsFeed;
import com.sportradar.unifiedodds.sdk.OddsFeedConfiguration;
import java.util.Locale;
import java.util.Arrays;
import java.util.List;

public class BasicOddsFeedExampleMain {
    public static void main(String[] args) {
        // Example: disable certain producers if needed
        List<Integer> DisabledProducerList = Arrays.asList(3, 5);

        OddsFeedConfiguration config = OddsFeed
            .getOddsFeedConfigurationBuilder()
            .setAccessToken("abcd1234lubljanajebulana")   // Replace with your access token
            .selectIntegration()                          // Integration environment for testing
            .setSdkNodeId(42)                             // Unique ID for this SDK instance
            .setDefaultLocale(Locale.ENGLISH)             // Language for translations
            .setDisabledProducers(DisabledProducerList)   // Optional
            .build();

        // Initialize SDK with the above configuration...
    }
}

Key Parameters

• Access Token: Your Sportradar API token.

• Environment:

  • .selectIntegration() → Test environment

  • .selectProduction() → Live environment

• SDK Node ID: Must be unique per SDK instance.

• Locale: Choose the default language (e.g. Locale.ENGLISH).

• Disabled Producers: (Optional) IDs of producers to exclude.