跳到主要内容

订单管理 (Orders)

本文档介绍如何在 ZTDX 进行下单、查询及撤单操作。所有订单接口均需 身份验证。

1. 创建订单 (Create Order)​

创建一个新的限价或市价订单。下单需要对订单参数进行 EIP-712 签名。

端点: POST /api/v1/orders

请求参数:

参数类型必填说明
symbolstring是交易对，如 BTCUSDT
sidestring是方向：long (做多) / short (做空)
order_typestring是类型：limit (限价) / market (市价)
pricestring限价必填委托价格
amountstring是委托数量 (Base Asset)
leveragenumber是杠杆倍数 (1-50)
timestampnumber是Unix 时间戳（秒）
signaturestring是订单 EIP-712 签名

签名格式:

Create Order on ZTDX

Symbol: BTCUSDT
Side: long
Type: limit
Price: 97000.00
Amount: 0.1
Leverage: 10
Timestamp: 1702400000
Address: 0x...

返回示例:

{
  "order_id": "uuid-string",
  "status": "open",
  "filled_amount": "0",
  "remaining_amount": "0.1",
  "average_price": null,
  "created_at": "2024-12-12T10:00:00Z"
}

2. 撤销单个订单 (Cancel Order)​

通过订单 ID 撤回尚未成交的订单。

端点: DELETE /api/v1/orders/:order_id

请求体:

{
  "signature": "0x...",
  "timestamp": 1702400000
}

3. 批量撤单 (Batch Cancel)​

一次性撤销多个订单，提高操作效率。

端点: POST /api/v1/orders/batch

请求参数:

{
  "order_ids": ["uuid-1", "uuid-2"],
  "signature": "0x...",
  "timestamp": 1702400000
}

返回示例:

{
  "cancelled": ["uuid-1", "uuid-2"],
  "failed": []
}

4. 查询订单列表 (Get Orders)​

获取当前活跃或历史订单。

端点: GET /api/v1/account/orders

查询参数:

参数类型说明
statusstring状态过滤：open, filled, cancelled
symbolstring交易对过滤