订单列表

基于游标分页查询用户订单列表，支持按交易对、状态、方向和时间范围筛选。

接口信息

• 方法: GET
• 路径: /api/v1/orders
• 鉴权: 需要签名认证（详见 公共模块 · 签名说明）

请求参数

参数	位置	类型	必填	说明
symbol	query	string	否	交易对，如 BTC_USDT
status	query	integer	否	状态：1=新建，2=部分成交，3=全部成交，4=已撤销
side	query	integer	否	方向：1=买入，2=卖出，0=不限
start_time	query	integer	否	开始时间（毫秒时间戳）
end_time	query	integer	否	结束时间（毫秒时间戳）
cursor	query	integer	否	游标（订单 ID），首次查询不传
limit	query	integer	否	每页数量，默认 20，最大 100

请求示例

GET /api/v1/orders?symbol=BTC_USDT&status=3&limit=20

响应字段

字段	类型	说明
code	integer	状态码
message	string	返回消息
data.has_more	boolean	是否有更多
data.next_cursor	integer	下一页游标
data.orders	array	订单列表（字段参考"订单详情"）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "has_more": false,
    "next_cursor": 1234567890123456800,
    "orders": [
      {
        "id": "1234567890123456789",
        "client_order_id": "my-order-001",
        "symbol": "BTC/USDT",
        "side": 1,
        "type": 1,
        "status": 2,
        "price": "30000",
        "qty": "0.1",
        "quote_qty": "0",
        "filled_qty": "0.05",
        "filled_quote": "1500",
        "avg_price": "30000",
        "total_fee": "0.0001",
        "fee_asset": "BTC",
        "cancel_reason": "USER",
        "created_at": 1704067200000,
        "updated_at": 1704067200000,
        "user_id": "user123"
      }
    ]
  }
}