FAQs

❓ 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.