24 lines
870 B
Markdown
24 lines
870 B
Markdown
# order.ts
|
||
|
||
**路径**：`src/api/order.ts`
|
||
|
||
## 功能用途
|
||
|
||
订单相关 API：获取订单列表、取消订单，以及将 `ClobOrderItem` 映射为展示项（History、Open Orders）。`PageResult`、`ApiResponse` 来自 `@/api/types`，通过 `buildQuery` 构建请求参数。
|
||
|
||
## 使用方式
|
||
|
||
```typescript
|
||
import { getOrderList, mapOrderToOpenOrderItem, mapOrderToHistoryItem, cancelOrder } from '@/api/order'
|
||
```
|
||
|
||
## 数据单位约定
|
||
|
||
- **price**：整数，已乘 10000（bps），`priceCents = price / 100`
|
||
- **originalSize / sizeMatched**：按 6 位小数传（1_000_000 = 1 share），展示时除以 `ORDER_SIZE_SCALE` 转为实际份额
|
||
|
||
## 扩展方式
|
||
|
||
1. 新增订单状态或筛选参数时，更新 `GetOrderListParams` 与 `getOrderList`
|
||
2. 展示格式变更时，调整 `mapOrderToOpenOrderItem`、`mapOrderToHistoryItem` 的格式化逻辑
|