> ## 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 订单及其注单从下单到结算所经历的状态，以及如何通过版本号检测变化。

**订单**是您的指令。它的**注单**是在各博彩公司下达的那部分投注额。订单状态由其注单推导而来，因此只需读取订单就能跟踪它。

## 订单状态

| 状态 | 含义 | 终态 |
| - | - | - |
| `PENDING` | 已发送给博彩公司，尚无成交 | 否 |
| `PARTIALLY_FILLED` | 部分投注额已成交，其余仍在处理中 | 否 |
| `FILLED` | 全部投注额已成交，或订单接受成交的部分已全部成交 | 是 |
| `EXPIRED` | 全部投注额成交之前，`expiresAt` 已过。`filledStake` 显示已成交的部分。 | 是 |
| `CANCELLED` | 在完成之前被您或博彩公司撤销。`filledStake` 显示此前已成交的部分。 | 是 |
| `REJECTED` | 没有任何成交：所有注单均被拒绝 | 是 |

`PENDING` 和 `PARTIALLY_FILLED` 是**进行中**状态：这些订单仍可能变化，并且适用[撤单](https://docs.apexiumbet.com/zh/guides/cancellation.md)。

`FILLED` 也包括部分成交的情况。一个立即成交否则撤销（immediate-or-cancel）的订单（`acceptPartialStake: true`，无 `expiresAt`），若 200 中成交了 120，则状态为 `FILLED`，`filledStake` 为 120.00。将 `filledStake` 与 `requestedStake` 比较，即可知道成交了多少。

## 注单状态

| 状态 | 含义 |
| - | - |
| `PENDING` | 已发送给博彩公司，尚无响应 |
| `WAITING` | 博彩公司已收到，但尚未确认，例如在滚球延迟期间 |
| `PARTIALLY_PLACED` | 注单的部分投注额已被接受，例如在交易所 |
| `PLACED` | 博彩公司已接受 |
| `REJECTED` | 被博彩公司拒绝；`declineReason` 说明原因 |
| `CANCELLED` | 在被接受之前已撤销，或在博彩公司处已到期 |
| `SETTLED` | 已由博彩公司判定；参见 `settlement` |

已下达的注单随后会结算。在此之前，其 `settlement.status` 为 `UNSETTLED`，之后为 `WON`、`LOST`、`VOID`、`HALF_WON`、`HALF_LOST`、`PUSH`、`CASHOUT` 之一。`settlement.amount` 是您在该注单上的盈亏。

## 跟踪变化

每个订单都有一个 `version`，订单或其任一注单每发生一次变化，它就加一。要跟踪订单，请读取它，并把 `version` 与您上次看到的值比较；它变了，就说明发生了变化。

* **单个订单。** `GET /v1/orders/{id}` 或 `GET /v1/orders/by-client-id/{clientOrderId}`。
* **进行中的订单。** `GET /v1/orders?status=PENDING&status=PARTIALLY_FILLED`。
* **结算。** `GET /v1/bets?settledFrom=…` 列出自某个时间以来已结算的注单。

## 订单上的金额

| 字段 | 含义 |
| - | - |
| `requestedStake` | 您请求的投注额 |
| `filledStake` | 目前已被博彩公司接受的投注额 |
| `remainingStake` | 仍在处理的投注额；订单进入终态后为 `0.00` |
| `averageFilledPrice` | 已成交注单按投注额加权的价格；没有成交时为 `null` |


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