# FAQs

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

### ❓ What is the Bot Score API?

The Bot Score API is an advanced tool developed by Sportradar to detect and score bot activity on betting platforms. It helps bookmakers identify and manage automated betting behaviors to maintain fair play and integrity.

### ❓ How does the Bot Score API work?

The API uses sophisticated AI algorithms to analyze betting patterns and behaviors. It assigns a Bot Score to each account based on the likelihood of automated betting activities. Higher scores indicate a higher probability of bot activity.

### ❓ What data is required to use the Bot Score API?

To query the API, you need the following:

* `bookmaker`: Insight Tech / MTS-assigned bookmaker ID
* `sub-bookmaker`: Specific entity under the bookmaker (or `*` for all)
* `customer`: The unique ID of the customer\
  Endpoints also support score filters and pagination via `startKey` or `lastEvaluatedKey`.

### ❓ What are the rate limits for the API?

To ensure stability, the API enforces the following limits:

| Limit Type      | Value            |
| --------------- | ---------------- |
| Requests/second | 10               |
| Daily quota     | 200,000 requests |
| Minute quota    | 500 requests     |

Exceeding these will result in a `429 Too Many Requests` response.

### ❓ How can I handle rate limiting in my application?

Implement exponential backoff strategies to handle rate limiting gracefully. This involves gradually increasing the wait time between retries after each rate-limited response.

### ❓ Can I adjust my quota limits?

Yes, quota limits can be adjusted based on your subscription plan and usage requirements. Contact Sportradar support to discuss your needs and request quota adjustments.

### ❓ How long does it take for a new account to receive a Bot Score?

A new account will only receive a Bot Score once there is sufficient historical data available – typically after a minimum number of betting transactions or sessions have been observed. Accounts with limited or irregular activity may not be scored immediately.

### ❓ Can I receive real-time updates when an account’s score crosses a threshold?

The Bot Score API is pull-based, but you can configure monitoring systems to poll for changes and trigger alerts when thresholds are breached (e.g. > 0.90). Real-time alerting is planned and will be implemented as an API and within the Alerting UI.

### ❓ What should I do when an account has a high Bot Score?

Sportradar does not take action on your behalf. It is up to each operator to determine the appropriate response, which may include:

* Increased monitoring
* Betting restrictions
* Identity verification
* Manual review

Bot Scores are decision support tools, not enforcement mechanisms.

### ❓ Who do I contact for support?

For access issues, integration help, or data questions, contact:

* Your OAM
* Your assigned CI engineer
* Or submit a ticket via Sportradar support.


---

# Agent Instructions: 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/itservices/models/bot-score-api/faqs.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.