> 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/bookmaker-odds/api-overview.md).

# API Overview

## HTTPS Protocol

The API is served over HTTPS and is available only from the `api.aiodds.com` domain. Access to endpoints of AiOdds APIs is restricted by password-based authentication, contact your AiOdds Business Manager to obtain and confirm your username and secret before your initial access.<br>

{% hint style="info" %}
Notes on the API behavior:
{% endhint %}

* Responses are returned in JSON format.
* All date and time values are returned as Unix timestamps.
* Domain is `api.aiodds.com`.
* Global request parameters:

| Parameter | Description                                           |
| --------- | ----------------------------------------------------- |
| user      | Unique username, contact your AiOdds Business Manager |
| secret    | User secret, contact your AiOdds Business Manager     |

* Global response structure:

| Field | Description         |
| ----- | ------------------- |
| code  | Status code         |
| msg   | Message description |
| data  | Data content        |

* Status code:

| Code | Description                    |
| ---- | ------------------------------ |
| 0    | Success                        |
| 1101 | Invalid IP address             |
| 1102 | Illegal request                |
| 1108 | Request parameter format error |

## API Frequency Limits

| API                                                                                 | Limit                   |
| ----------------------------------------------------------------------------------- | ----------------------- |
| [Search matches](/bookmaker-odds/basic-data/match.md#get-v1-match-list)             | 30 requests per 2 sec   |
| [Get match by ID](/bookmaker-odds/basic-data/match.md#get-v1-match-get)             | 100 requests per 2 sec  |
| [Get match score by ID](/bookmaker-odds/basic-data/match.md#get-v1-match-score-get) | 100 requests per 2 sec  |
| [Snapshot](/bookmaker-odds/bookmaker-odds/snapshot.md)                              | Only once needed        |
| Other APIs                                                                          | 300 requests per 60 sec |


---

# 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/bookmaker-odds/api-overview.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.