跳到主要内容

获取订单

GET🔒 Trading
⚡ Query: 15 req/s per endpoint · 30 req/s per user
提示

立即试用 — 在 API 浏览器中测试此端点

返回挂单。当提供 orderId 或 clOrderId 时，返回该单个订单；否则返回调用方的挂单，并可选择按交易对过滤。

请求参数​

名称类型是否必填描述
orderIdString否用于查询单个订单的服务器分配订单 ID。
clOrderIdString否用于查询单个订单的客户端分配订单 ID。
symbolString否用于过滤挂单的交易对。当提供 orderId 或 clOrderId 时被忽略。
includeCancelledBoolean否若为 true，结果中包含已撤销订单。仅在按 orderId 或 clOrderId 查询时生效。

响应内容​

名称类型描述
orderIdString服务器分配的订单 ID。
clOrderIdString从下单时回传的客户端分配订单 ID。
symbolString交易对。
orderSideString订单方向：BUY 或 SELL。
typeInteger订单类型代码。
orderPriceDouble订单的限价。
originalOrderSizeInteger下单时的原始订单数量（合约张数）。
currentOrderSizeInteger成交和修改后的当前剩余订单数量（合约张数）。
totalFilledSizeInteger累计成交数量（合约张数）。
remainingSizeInteger剩余未成交数量（合约张数）。
averageFillPriceDouble迄今为止各笔成交的平均成交价。
orderStateString可读的订单状态名称。
timestampLong最近一次状态变更的服务器时间戳，单位为自 epoch 起的毫秒数。
reduceOnlyBoolean若订单只能减少现有仓位，则为 true。
positionModeString此订单适用的仓位模式（单向或对冲）。 — ONE_WAY · HEDGE · ISOLATED
positionDirectionString订单影响的仓位方向：LONG 或 SHORT。
positionIdString订单所绑定仓位的标识符。
closeOrderBoolean若订单为平仓订单，则为 true。
pegPriceMinDouble挂钩订单价格区间的下限。
pegPriceMaxDouble挂钩订单价格区间的上限。
pegPriceDeviationDouble应用于挂钩参考价格的偏移量。
currentPegPriceDouble当前挂钩工作价格。
triggerOrderBoolean若此订单为尚未触发的条件触发订单，则为 true。
triggeredBoolean一旦触发条件已触发，则为 true。
triggerPriceDouble已配置的触发价格。
triggerOriginalPriceDouble任何修改之前最初提交的触发价格。
triggerOrderTypeInteger触发后将提交的订单类型代码。
triggerTrailingStopDeviationDouble触发的移动止损行为的跟踪距离。
triggerStopPriceDouble触发订单激活后使用的止损价格。
triggerUseLastPriceBoolean若使用最新成交价作为触发参考则为 true，否则使用标记价格。
trailValueDouble止损相对于所达到的最优参考价格保持的跟踪距离。
trailValueTypeStringtrailValue 的解释方式（绝对价格偏移或百分比）。 — DISTANCE · PERCENTAGE
activationPriceDouble跟踪或计划逻辑激活的价格。
activationPriceTypeString用于评估激活价格的参考价格类型。 — INDEX_PRICE · LAST_PRICE · MARK_PRICE
cancelDurationLong根据有效期推导出的撤单时长（毫秒）。GTC 时为零。
timeInForceString应用于订单的有效期策略（例如 GTC、IOC、FOK）。
stealthDouble在订单簿上显示的订单数量比例；其余部分被隐藏。
contractSizeDouble此交易对的合约面值（每张合约对应的标的单位数）。
wrapperOrderBoolean若订单是派生子订单的包装单（例如激活包装单），则为 true。
ocoPeerOrderIdString若此订单是 OCO 对的一部分，则为对端 OCO 分支的订单 ID。
orderDetailTypeString细粒度的订单明细类型分类。 — TWAP · PARTIAL_LIQUIDATION · FORCED_MARKET_BUY · FORCED_MARKET_SELL
originalOrderValueDouble下单时的名义价值，由原始数量、合约面值和参考价格计算得出。
currentOrderValueDouble当前名义价值，由剩余数量、合约面值和当前工作价格计算得出。

takeProfitOrder:

名称类型描述
orderIdString附加触发订单的服务器分配订单 ID。
sideString触发分支的订单方向：BUY 或 SELL。
triggerPriceDouble此触发生效的价格。
triggerUseLastPriceBoolean若使用最新成交价作为触发参考则为 true，否则使用标记价格。

stopLossOrder:

名称类型描述
orderIdString附加触发订单的服务器分配订单 ID。
sideString触发分支的订单方向：BUY 或 SELL。
triggerPriceDouble此触发生效的价格。
triggerUseLastPriceBoolean若使用最新成交价作为触发参考则为 true，否则使用标记价格。
example
GEThttps://api.btse.com/futures/api/v3/trade/orders

Response (default)

[
  {
    "orderId": "0251ea47-88b5-48c0-aeb3-b38774fd1f90",
    "clOrderId": "",
    "symbol": "BTC-PERP",
    "orderSide": "BUY",
    "type": 76,
    "orderPrice": 56439.4,
    "originalOrderSize": 1,
    "currentOrderSize": 1,
    "totalFilledSize": 0,
    "remainingSize": 1,
    "averageFillPrice": 0,
    "orderState": "STATUS_ACTIVE",
    "timestamp": 1784882344358,
    "reduceOnly": false,
    "positionMode": "ONE_WAY",
    "positionDirection": null,
    "positionId": "BTC-PERP-USDT",
    "closeOrder": false,
    "pegPriceMin": 0,
    "pegPriceMax": 0,
    "pegPriceDeviation": 1,
    "currentPegPrice": 56439.4,
    "triggerOrder": false,
    "triggered": false,
    "triggerPrice": 0,
    "triggerOriginalPrice": 0,
    "triggerOrderType": 0,
    "triggerTrailingStopDeviation": 0,
    "triggerStopPrice": 0,
    "triggerUseLastPrice": false,
    "trailValue": 0,
    "trailValueType": "DISTANCE",
    "activationPrice": null,
    "activationPriceType": null,
    "takeProfitOrder": null,
    "stopLossOrder": null,
    "cancelDuration": 0,
    "timeInForce": "GTC",
    "stealth": 1,
    "contractSize": 0.00001,
    "wrapperOrder": false,
    "ocoPeerOrderId": null,
    "orderDetailType": null,
    "originalOrderValue": 0.564394,
    "currentOrderValue": 0.564394
  }
]