查询单个订单
通过 orderId 或 clOrderId 查询单个订单。若订单不存在或已失效，则返回 404。
请求参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| orderId | String | 否 | 要查询的订单 ID；orderId 和 clOrderId 至少需提供其一 |
| clOrderId | String | 否 | 要查询的客户端订单 ID；orderId 和 clOrderId 至少需提供其一 |
响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | Long | 与订单提交关联的请求标识符。 |
| orderId | String | 服务器分配的唯一订单标识符。 |
| clOrderId | String | 客户端提供的订单标识符（自定义标签）。 |
| symbol | String | 交易对，格式为 BASE-QUOTE（例如 BTC-USDT）。 |
| quote | String | 交易对的计价货币。 |
| orderState | String | 当前订单状态标签（例如 active、inactive、cancelled）。 |
| orderType | Integer | 数字订单类型代码（限价、市价、锚定、TWAP）。 |
| orderSide | String | 订单方向：BUY 或 SELL。 |
| orderPrice | Double | 订单限价。市价单为零。 |
| orderValue | Double | 以用户账户货币表示的当前订单价值。 |
| timestamp | Long | 订单创建时间戳，单位为 Unix 纪元毫秒。 |
| timeInForce | String | 有效方式策略：GTC、IOC、FOK，如不适用则为 null。 |
| orderCurrency | String | 指示哪些数量字段被填充："quote"（以计价货币计价）或 "base"（以基础货币计价）。 |
| originalOrderBaseSize | Double | 以基础货币计的原始订单数量。仅当 orderCurrency 为 "base" 时填充。 |
| originalOrderQuoteSize | Double | 以计价货币计的原始订单数量。仅当 orderCurrency 为 "quote" 时填充。 |
| currentOrderBaseSize | Double | 以基础货币计的当前未成交订单数量。仅当 orderCurrency 为 "base" 时填充。 |
| currentOrderQuoteSize | Double | 以计价货币计的当前未成交订单数量。仅当 orderCurrency 为 "quote" 时填充。 |
| remainingOrderBaseSize | Double | 以基础货币计的剩余未成交数量。仅当 orderCurrency 为 "base" 时填充。 |
| remainingOrderQuoteSize | Double | 以计价货币计的剩余未成交数量。仅当 orderCurrency 为 "quote" 时填充。 |
| totalFilledBaseSize | Double | 以基础货币计的累计成交数量。 |
| avgFilledPrice | Double | 此订单所有成交的成交量加权平均成交价格。 |
| orderDetailType | String | 对订单用途或子类型进行分类的订单详情类别。 — TWAP · PARTIAL_LIQUIDATION · FORCED_MARKET_BUY · FORCED_MARKET_SELL |
| orderDetail | Object | |
| triggerOrder | Boolean | 若此为触发（条件）订单，则为 true。 |
| triggered | Boolean | 一旦触发条件已触发且底层订单已释放，则为 true。 |
| triggerUseLastPrice | Boolean | 若触发依据最新成交价格评估，则为 true；若依据标记价格评估，则为 false。仅对触发订单有意义。 |
| triggerPrice | Double | 有效触发价格。仅对触发订单有意义。 |
| triggerOriginalPrice | Double | 客户端最初提交的触发价格。仅对触发订单有意义。 |
| triggerOrderType | Integer | 数字触发订单类型代码（止损、止盈、止损限价或止盈限价）。仅对触发订单有意义。 |
| triggerStopPrice | Double | 触发订单的止损价格。仅对触发订单有意义。 |
| triggerTrailingStopDeviation | Double | 相对参考价格的追踪止损偏差。仅对追踪止损触发订单有意义。 |
| trailValue | Double | 追踪偏移幅度。仅对追踪止损订单有意义。 |
| trailValueType | String | trailValue 的解释方式（例如绝对金额或百分比）。仅对追踪止损订单有意义。 — DISTANCE · PERCENTAGE |
| pegPriceMin | Double | 锚定价格区间的下限。仅对锚定订单有意义。 |
| pegPriceMax | Double | 锚定价格区间的上限。仅对锚定订单有意义。 |
| pegPriceDeviation | Double | 锚定时应用于参考价格的偏移量。仅对锚定订单有意义。 |
| currentPegPrice | Double | 当前有效锚定价格。仅对锚定订单有意义。 |
| wrapperOrder | Boolean | 若订单是一组相关订单的封装器（例如 bracket/OCO），则为 true。 |
| activationPrice | Double | 订单变为可执行所需达到的激活价格。仅对使用激活价格功能的订单存在。 |
| activationPriceType | String | 评估 activationPrice 时所用的参考价格类型。仅对使用激活价格功能的订单存在。 — INDEX_PRICE · LAST_PRICE · MARK_PRICE |
example
GET
https://api.btse.com/spot/api/v4/trade/orderResponse (default)
{
"requestId": 5219582705252738000,
"orderId": "4eca2eb4-e6ad-4355-ae12-5ce757b105b3",
"clOrderId": null,
"symbol": "BTC-USD",
"quote": "USD",
"orderState": "ORDER_INSERTED",
"orderType": 76,
"orderSide": "BUY",
"orderPrice": 60413.8,
"orderValue": 0.604138,
"timestamp": 1784891308061,
"timeInForce": "GTC",
"orderCurrency": "base",
"originalOrderBaseSize": 0.00001,
"originalOrderQuoteSize": null,
"currentOrderBaseSize": 0.00001,
"currentOrderQuoteSize": null,
"remainingOrderBaseSize": 0.00001,
"remainingOrderQuoteSize": null,
"totalFilledBaseSize": 0,
"avgFilledPrice": 0,
"orderDetailType": null,
"orderDetail": null,
"triggerOrder": false,
"triggered": false,
"triggerUseLastPrice": false,
"triggerPrice": 0,
"triggerOriginalPrice": 0,
"triggerOrderType": 0,
"triggerStopPrice": 0,
"triggerTrailingStopDeviation": 0,
"trailValue": 0,
"trailValueType": "DISTANCE",
"pegPriceMin": 0,
"pegPriceMax": 0,
"pegPriceDeviation": 0,
"currentPegPrice": 60413.8,
"wrapperOrder": false,
"activationPrice": null,
"activationPriceType": null
}