> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/uof/sdk/languages/java/installation.md).

# 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:

     ```bash
     java -version
     ```
2. **Apache Maven** (build & dependency management)
   * Verify installation:

     ```bash
     mvn -version
     ```
3. **Git** (for cloning the example project)
   * Verify installation:

     ```bash
     git --version
     ```
4. **IntelliJ IDEA** (recommended IDE)
   * Community or Ultimate Edition works.
   * Download from [JetBrains](https://www.jetbrains.com/idea/).

{% stepper %}
{% step %}

### Clone the Example Project

Clone the official Unified Odds SDK example project from GitHub:

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

> 💡 If you prefer, you can also [download the project as a ZIP](https://github.com/sportradar/UnifiedOddsSdkJava/archive/refs/heads/master.zip) and extract it.
> {% endstep %}

{% step %}

### Open in IntelliJ IDEA

<figure><img src="/files/IWRmMj9e6PZUNZE4wBFs" alt=""><figcaption></figcaption></figure>

* 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.**
> {% endstep %}

{% step %}

### **Verify Maven Setup**

<figure><img src="/files/OeWf3pLY55qZRduenTsf" alt=""><figcaption></figcaption></figure>

* In IntelliJ, go to the right-hand side **Maven tool window** click → **Maven**.
* Click **Reload Project** (the refresh 🔄 button).

{% hint style="success" %}
This forces IntelliJ to re-import the `pom.xml`, download any new dependencies, and update the project structure accordingly.
{% endhint %}
{% endstep %}

{% step %}

### Update the SDK Version (Optional)

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

```xml
<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.
{% endstep %}

{% step %}

### Configure the SDK

The example project includes a starter class:

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

Edit the configuration inside it:

```java
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...
    }
}
```

{% hint style="info" %}

#### 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.
  {% endhint %}

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportradar.com/uof/sdk/languages/java/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.