Skip to content

查询当前委托

查询当前委托

查询用户的当前未完成订单列表。

HTTP 请求

GET
/api/perp-trade-api/curr-info/orders

请求频率限制:

  • 建议不超过 10 次/秒

认证要求:

  • 需要 JWT Token
  • 需要 X-Wallet-Address 请求头

请求头

名称 类型 必填 描述
Authorization string JWT Token,格式:Bearer {token}
X-Wallet-Address string 钱包地址

请求参数

名称 类型 必填 描述
symbol string 交易对,如 ETH-PERP,不传则查询所有交易对
pageNum integer 页码,默认为 1
pageSize integer 每页大小,默认为 20

响应字段说明

返回分页响应,包含:

名称 类型 描述
total long 总记录数
pageNum integer 当前页码
pageSize integer 每页大小
list array 订单列表

每个订单包含:

名称 类型 描述
id long 订单 ID
clientId string 客户端 ID
orderStatus string 订单状态
hash string 订单哈希
symbol string 交易对
orderType string 订单类型
creator string 用户地址
side string 买卖方向
price string 价格
quantity string 数量
leverage string 杠杆
fee string 手续费
filledFee string 已成交手续费
createdAt long 创建时间(毫秒)
updatedAt long 更新时间(毫秒)
filledQty string 已成交数量
avgFillPrice string 平均成交价格
openQty string 未成交数量
orderValue string 委托价值
triggerConditionType string 触发条件类型
triggerPrice string 触发价格
triggerDirection integer 触发方向
reduceOnly boolean 是否只减仓
planOrderType string 计划订单类型
planType string 计划类型
planBatchId long 计划批次号

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 10,
    "pageNum": 1,
    "pageSize": 20,
    "list": [
      {
        "id": 123456,
        "clientId": "my-order-001",
        "orderStatus": "NEW",
        "hash": "0xabc123...",
        "symbol": "ETH-PERP",
        "orderType": "LIMIT",
        "creator": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
        "side": "BUY",
        "price": "2500",
        "quantity": "1",
        "leverage": "5",
        "fee": "0",
        "filledFee": "0",
        "createdAt": 1700000000000,
        "updatedAt": 1700000000000,
        "filledQty": "0",
        "avgFillPrice": "0",
        "openQty": "1",
        "orderValue": "2500",
        "reduceOnly": false,
        "planOrderType": "open"
      }
    ]
  }
}