# 下单与订单管理

## 基本概念

下单前，需要理解几个关键参数：

### Sides

STRIKE 使用 [4-sided 订单簿](/zh/zhi-neng-he-yue/orderbook.md)。每一侧决定会锁定哪种抵押资产，以及成交后你会收到什么。

| Side      | 你的操作      | 锁定的抵押资产                                 | 成交后收到  |
| --------- | --------- | --------------------------------------- | ------ |
| `Bid`     | 买入 YES 代币 | `lots × tick/100 × LOT_SIZE` USDT       | YES 代币 |
| `Ask`     | 买入 NO 代币  | `lots × (100-tick)/100 × LOT_SIZE` USDT | NO 代币  |
| `SellYes` | 卖出 YES 代币 | YES 代币（由订单簿托管）                          | USDT   |
| `SellNo`  | 卖出 NO 代币  | NO 代币（由订单簿托管）                           | USDT   |

### Ticks

Tick 范围为 1-99，表示一个 YES 代币以美分计价的价格。以 tick 70 提交 bid，表示你愿意为一个 YES 代币支付 $0.70（隐含价格在到期时高于 STRIKE 的概率为 70%）。

### Lots

每个 lot 等于 `LOT_SIZE = 1e16 wei = $0.01` 的抵押资产。100 lots 以 tick 50 下单会锁定 `100 × 0.50 × $0.01 = $0.50` USDT。

### 订单类型

| Type                     | 行为                                                |
| ------------------------ | ------------------------------------------------- |
| `GoodTilCancelled` (GTC) | 未成交部分会滚入下一个 [batch](/zh/xie-yi/batch-auctions.md) |
| `GoodTilBatch` (GTB)     | 如果未成交，会在当前 batch 结束时过期                            |

### 抗 MEV 价格保护

你的 tick **就是** 你的价格保护。在批量拍卖中，同一个 batch 内的所有成交都会以统一清算价格结算。你的订单永远不会以差于 tick 的价格成交；如果清算价格超过你的 limit，订单就不会成交。

这与 AMM slippage 有本质区别。由于订单会被一起收集并清算，不存在提交和执行之间价格变化带来的风险。请将 tick 设置为你愿意接受的最差价格。

例如，当前 best ask 为 tick 55，而你愿意为一个 YES 代币最多支付 60 cents，则可以以 tick 60 提交 bid。你会支付清算价格（可能是 55、57 或任何不高于 60 的价格），不会支付更高价格。

## OrderParam 构造函数

`OrderParam` 提供默认使用 GTC 的便捷构造函数：

```rust
use strike_sdk::prelude::*;

// GTC orders (default)
let bid = OrderParam::bid(50, 100);          // bid at tick 50, 100 lots
let ask = OrderParam::ask(60, 100);          // ask at tick 60, 100 lots
let sell_yes = OrderParam::sell_yes(55, 50); // sell YES at tick 55, 50 lots
let sell_no = OrderParam::sell_no(45, 50);   // sell NO at tick 45, 50 lots

// For GTB orders, use the full constructor
let gtb_bid = OrderParam::new(Side::Bid, OrderType::GoodTilBatch, 50, 100);
```

## 提交订单

使用 `client.orders().place()` 在一笔交易中提交一个或多个订单：

```rust
let market = client.indexer().get_active_markets().await?
    .into_iter()
    .next()
    .expect("no active markets");

let orders = client
    .orders()
    .place_market(&market, &[OrderParam::bid(40, 100), OrderParam::ask(60, 100)])
    .await?;

for o in &orders {
    println!(
        "order {} | {:?} | orderbook market {}",
        o.order_id, o.side, o.orderbook_market_id
    );
}
```

这会使用市场的 `orderbook_market_id` 调用链上的 `OrderBook.placeOrders()`。返回的 `Vec<PlacedOrder>` 包含从交易回执中 `OrderPlaced` 事件解析得到的订单 ID。

## 取消订单

取消一个或多个订单：

```rust
// Cancel multiple
let ids: Vec<_> = orders.iter().map(|o| o.order_id).collect();
client.orders().cancel(&ids).await?;

// Cancel a single order
client.orders().cancel_one(order_id).await?;
```

`cancel()` 调用 `OrderBook.cancelOrders()`（批量）。`cancel_one()` 调用 `OrderBook.cancelOrder()`（单笔）。两者都会解锁抵押资产或返还由订单簿托管的代币。

## 替换订单（原子化取消 + 下单）

替换订单会在一笔交易中原子化取消现有订单并提交新订单：

```rust
let old_ids = vec![order1.order_id, order2.order_id];
let new_params = vec![OrderParam::bid(45, 100), OrderParam::ask(55, 100)];

let new_orders = client
    .orders()
    .replace_market(&old_ids, &market, &new_params)
    .await?;
```

这会调用 `OrderBook.replaceOrders()`。净抵押资产结算意味着你只需存入或取回差额，适合在不释放并重新锁定抵押资产的情况下调整报价。

## PlacedOrder

`place()` 和 `replace()` 返回的类型：

```rust
pub struct PlacedOrder {
    pub order_id: U256,
    pub side: Side,
    pub market_id: u64,              // legacy alias of orderbook_market_id
    pub orderbook_market_id: u64,
}
```

订单 ID 从交易回执中触发的 `OrderPlaced` 与 `OrderResting` 事件解析得到。

> **休眠订单**：当订单 tick 距离上一次清算价格较远（超过 20 ticks）时，合约会将它加入休眠列表，而不是放入活跃批次。休眠订单会触发 `OrderResting`，而不是 `OrderPlaced`。SDK 会同时跟踪两者，调用方无需处理这个差异。当价格靠近后，休眠订单会自动进入 batch。

## 卖出结果代币

卖出已持有的 YES 或 NO 代币时，使用 `SellYes`/`SellNo` side。提交订单时，订单簿会托管你的代币；如果订单取消或未成交，代币会返还给你。

卖出前，需要授权订单簿转账你的结果代币：

```rust
// Approve OrderBook to transfer your outcome tokens (one-time)
let order_book = client.config().addresses.order_book;
client.tokens().set_approval_for_all(order_book, true).await?;

// Place a sell order
let orders = client
    .orders()
    .place_market(&market, &[OrderParam::sell_yes(55, 50)])
    .await?;
```

更多代币操作请参见[金库与结果代币](/zh/sdk/vault-and-tokens.md)。


---

# Agent Instructions: 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:

```
GET https://docs.strike.pm/zh/sdk/orders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.