> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexiumbet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apexium API - 自动化投注执行与行情数据

> 通过一个 API 密钥，跨博彩公司、交易所和预测市场下单、跟踪和撤单，并通过同一个 API 读取您的博彩公司的行情数据。

> [!NOTE]
>
> **抢先体验。** API 将随平台一同开放。如需获取访问权限以及集成期间使用的测试环境，请联系 [contact@apexiumbet.com](mailto:contact@apexiumbet.com)。

## 什么是 Apexium API？

Apexium API 是以编程方式访问您的 [apexiumbet.com](https://apexiumbet.com) 账户的入口。您通过它执行的一切操作都发生在该账户上，使用与仪表板相同的余额、相同的博彩公司和相同的规则。

* **执行**：读取投注单中您的价格和投注额限额，预览订单，下单，跟踪其注单直至结算，并撤销仍在挂单中的订单。
* **账户**：查看您的余额、未结持仓和已实现盈亏。
* **行情数据**：读取来自 **OddsPapi v5** 的赛事、比分和赔率，范围限于您的博彩公司。

行情数据就是 OddsPapi v5 本身：相同的路径、相同的响应、相同的标识符。您在赔率中读取到的 `fixtureId` 和 `outcomeId`，就是您下单所用的标识符，因此数据与执行之间没有映射层。OddsPapi 客户端只需更改其基础 URL 和密钥；参见[行情数据与标识符](https://docs.apexiumbet.com/zh/api-reference/market-data.md)。

订单是您的指令：以一定的投注额买入（back）某个选项，价格不低于最低价格。Apexium 会将其拆分为在一家或多家博彩公司的**注单**。无论订单是通过 API 还是从仪表板下达的，您都通过相同的端点跟踪订单及其注单。

## 环境

| 环境 | 基础 URL | API 密钥 |
| - | - | - |
| **生产** | `https://api.apexiumbet.com` | `apx_live_…` |

每个端点都位于 `/v1` 下。集成期间可按需提供测试环境，它有自己的基础 URL 和密钥。密钥只能在签发它的环境中使用。

## 从哪里开始

> [card] [快速入门](https://docs.apexiumbet.com/zh/quickstart.md)
>
> 从获取密钥到下单，只需五次调用。

> [card] [认证](https://docs.apexiumbet.com/zh/api-reference/authentication.md)
>
> 获取密钥、发送密钥、轮换密钥。

> [card] [预览与下单](https://docs.apexiumbet.com/zh/guides/preview-and-place.md)
>
> 订单需要提供什么，以及您会得到什么返回。

> [card] [行情数据与标识符](https://docs.apexiumbet.com/zh/api-reference/market-data.md)
>
> OddsPapi v5 的运动、赛事、盘口和赔率，以及它们如何变成订单。

> [card] [API 参考](https://docs.apexiumbet.com/zh/api-reference/overview.md)
>
> 每个端点，均由 API 的契约和 OddsPapi v5 参考文档生成。

## 参考文档的构建方式

端点页面由 API 自身导出的 OpenAPI 契约生成，行情数据页面则由 OddsPapi v5 参考文档生成。参考文档中出现某个字段、参数或状态码，是因为 API 确实具备它。`/v1` 契约只增不减：字段、端点和枚举值只会新增，绝不会重命名或删除，因此请妥善处理未知的枚举值。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.