鎖定訂單
接口信息
接口: POST /api/v1/orders/lock
描述: 鎖定訂單,以進行訂單填充
鑑權: API Key憑據認證
請求參數
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
| order_hash | string | 是 | 訂單哈希值 |
| taker_address | string | 是 | Taker地址 |
響應參數
| 字段 | 類型 | 說明 |
|---|---|---|
| success | boolean | 鎖定是否成功 |
| order_hash | string | 訂單哈希值 |
| locked_by | string | 鎖定者 |
| locked_at | string | 鎖定時間 |
| expires_at | string | 鎖定失效時間 |
請求示例
bash
curl -X POST "/api/v1/orders/lock" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"order_hash": "0x1234567890abcdef...",
"taker_address": "0xabcdef1234567890..."
}'響應示例
json
{
"code": 0,
"data": {
"success": true,
"order_hash": "0x1234567890abcdef...",
"locked_by": "0xabcdef1234567890...",
"locked_at": "2025-01-17T03:00:24Z",
"expires_at": "2025-01-17T04:00:24Z"
}
}注意事項
- 鎖定訂單後,其他Taker無法操作該訂單
- 鎖定有時效性,過期後自動解鎖
- 鎖定期間可以進行訂單填充操作