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

# 订单生命周期

> 了解订单从创建、提交、撮合到链上结算的完整流程，以及订单与成交状态。

事件市场 CLOB 采用混合模式：订单撮合在链下完成以获得更高效率，最终资产交割在链上执行。下面介绍订单从创建到结算的完整生命周期。

![Image](https://mintcdn.com/dexbuilder/HmQKrNhFx36mwspk/images/image-4.png?fit=max\&auto=format\&n=HmQKrNhFx36mwspk\&q=85\&s=6064e7ab0bef5d73b0e77485638f2c13)

## 订单如何工作

CLOB 中底层都可以视为限价订单。通常所说的“市价单”，本质上是一个价格足够激进、能够立即穿过订单簿成交的限价订单。

撮合遵循价格优先、时间优先：更优价格优先成交；同一价格下，更早进入订单簿的订单优先。

## 订单有效方式

以下值用于 `order_type`；`order_mode` 使用 `LIMIT` 或 `MARKET`。

| 类型 | 行为 | 典型场景 |
| - | - | - |
| `GTC` | Good-Til-Cancelled，直到成交或主动撤销前持续有效 | 挂单、做市 |
| `GTD` | Good-Til-Date，到指定时间自动失效 | 有有效期的报价 |
| `FOK` | Fill-Or-Kill，必须立即全部成交，否则全部取消 | 全成或全撤 |
| `FAK` | Fill-And-Kill，立即成交可成交部分，其余取消 | 快速吃单 |

### Post Only

Post Only 订单保证只作为 Maker。如果提交时会立即与现有订单成交，则订单直接被拒绝，而不会主动吃掉流动性。

## 完整生命周期

**1. 创建并签名**

构造订单参数，包括 Token ID、方向（`BUY` / `SELL`）、价格、数量、过期时间和时间戳，并使用交易钱包签名。

**2. 提交到 CLOB**

CLOB 验证签名、余额与授权，并校验 tick size、最小下单数量等交易规则。不合法订单不会进入订单簿。

**3. 撮合或进入订单簿**

可立即成交的订单与现有流动性撮合；无法立即成交的订单继续留在订单簿，直到成交、撤销或过期。部分市场可能对 Taker 设置撮合延迟保护 Maker。

**4. 链上结算**

撮合完成后，结算合约验证订单并在一次原子交易中完成结果代币与 USDT 的资产交割。

**5. 确认完成**

链上交易确认后，账户余额、成交记录和持仓同步更新。

## REST 订单状态

REST 订单查询及 `status` 筛选使用以下小写值；WebSocket 订单推送使用另一套大写 UI 状态。

| 状态 | 含义 |
| - | - |
| `processing` | 订单请求处理中，包括撤单处理中 |
| `open` | 订单仍开放，包括部分成交且仍有剩余数量的订单 |
| `matched` | 订单已撮合 |
| `canceled` | 订单已取消或到期 |
| `failed` | 订单失败或被拒绝 |

## 成交状态

| 状态 | 含义 | 是否终态 |
| - | - | - |
| `MATCHED` | 链下撮合已确认，等待链上结算 | 否 |
| `MINED` | 结算交易已上链 | 否 |
| `CONFIRMED` | 结算最终确认，余额已更新 | 是 |
| `RETRYING` | 链上提交失败，系统正在重试 | 否 |
| `FAILED` | 结算最终失败 | 是 |

## Maker 与 Taker

| 角色 | 说明 |
| - | - |
| Maker | 挂单并提供流动性 |
| Taker | 主动跨过订单簿、消耗已有流动性 |

Taker 实际成交价格按照订单簿上对手方的挂单价格执行。例如买单限价为 `$0.55`，与 `$0.52` 的卖单成交时，成交价为 `$0.52`。

## 撤单

未成交订单通常可主动取消。已经完成撮合的部分无法撤回；即使剩余部分被撤销，已撮合部分仍会继续完成结算。

## 下单要求

| 要求 | 说明 |
| - | - |
| Balance | 买入需要足够 USDT，卖出需要足够结果代币 |
| Allowance | 对应合约需要获得资产转移授权 |
| API credentials | 私有交易接口需要有效认证信息 |

单笔新订单最大可用数量应扣除现有未成交订单已占用的余额：

```text theme={null}
maxOrderSize = balance − ∑(openOrderSize − filledAmount)
```

## 下一步

> [card] [市场结算](https://dexbuilder.mintlify.site/zh/event-markets/resolution.md)
>
> 了解市场如何确定结果以及获胜 Token 如何赎回。

> [card] [提交订单](https://dexbuilder.mintlify.site/zh/event-markets/place-orders.md)
>
> 查看交易接口与下单流程。


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