> For the complete documentation index, see [llms.txt](https://developer.aiodds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.aiodds.com/welcome.md).

# Welcome

> ***AiOdds empowers sportsbook operators with real-time betting data, seamless delivery infrastructure, and intelligent trading workflows.*** 
>
> ***Explore the platform, discover the product path that fits your needs, and start building an integration that moves as fast as the market.***

{% hint style="warning" %}

#### ***Reminder***

***Here is the legacy version of AiOdds:*** [***https://docs.aiodds.com/#intro***](https://docs.aiodds.com/#intro)

***This legacy version will be discontinued on July 31, 2026. To ensure uninterrupted access and a better experience, please migrate to this new documentation as soon as possible.***
{% endhint %}

### What AiOdds includes

AiOdds brings its core capabilities together through a set of connected product areas:

| Product Area                                                   | Use it for                                                                           |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| [Bookmaker Odds](https://developer.aiodds.com/bookmaker-odds/) | Consume sports, tournaments, fixtures, markets, and odds.                            |
| [Ai Trading](https://developer.aiodds.com/trading-odds/)       | Generate and manage proprietary odds through trading rules and workflows.            |
| [Customer Console](https://www.aiodds.com/monitoring)          | Monitor live data, review access, open tickets, and access Betting Engagement tools. |

### How integrations usually work

Most teams use API for the initial data load and MQTT over WebSocket for live updates. This gives you a stable baseline and low-latency changes.

Run API and WebSocket consumers on your backend. Keep credentials server-side. Store AiOdds identifiers in your own models and cache frequently changing data where needed.

| Layer              | Use it for                                                                   | Data Format                               |
| ------------------ | ---------------------------------------------------------------------------- | ----------------------------------------- |
| API                | Initial sync, reference data, validation, and controlled lookups.            | JSON                                      |
| WebSocket          | Incremental odds, match, score, and settlement updates.                      | <p>MQTT over WebSocket</p><p>Protobuf</p> |
| Snapshot           | Recovery and full refresh flows after interruptions.                         | Protobuf                                  |
| Monitoring console | Operational validation of markets, bookmakers, movement, and suspended odds. | Customer console UI                       |

{% hint style="info" %}
For production, implement request retries, reconnect and resubscribe logic, and alerting for stale data, parsing errors, and connection failures. **Use MQTT v5 when possible.**
{% endhint %}

### Start here

Choose the section that matches your stage.

* New to AiOdds?
  * [Product Overview](/explore/products-overview.md) · [Data Coverage](/explore/data-coverage-dimensions.md) · [Data Format](/explore/data-format.md) · [Core Concepts](/explore/core-concepts.md)\
    Understand what AiOdds provides, what sports and markets are covered, what data is provided, and the key terms used across the docs.
* Ready to connect?
  * [Permissions](/get-started/permissions.md) · [Quickstart](/get-started/quickstart.md) · [First Integration](/get-started/first-integration.md)\
    Set up access, confirm permissions, and make your first successful connection.
* Running in live operations?
  * [Monitor Live Odds](/operation/monitor-live-odds.md) · [Go-Live Checklist](/operation/go-live-checklist.md) · [FAQ](/operation/faq.md)\
    Validate live data, prepare your integration for launch, and resolve common operational questions.

### Coverage

AiOdds covers pre-match and in-play sportsbook workflows across major sports and esports. Coverage includes sports, tournaments, fixtures, markets, bookmaker odds, live updates, and trading workflows.

### Support

For account access, IP allowlisting, credentials, subscription questions, or commercial changes, contact your AiOdds Business Manager or use the customer console support channels.

For more details, contact [Support](/support.md).


---

# 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, and the optional `goal` query parameter:

```
GET https://developer.aiodds.com/welcome.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.