跳到主要内容

查询订单列表

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

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

列出调用方的挂单，可选择按交易对、一组订单 ID 或客户端订单 ID 进行筛选。

请求参数​

名称类型是否必填描述
symbolString否用于筛选的交易对
orderIdsString[]否用于筛选的订单 ID
clOrderIdString否用于筛选的客户端订单 ID

响应内容​

名称类型描述
requestIdLong与订单提交关联的请求标识符。
orderIdString服务器分配的唯一订单标识符。
clOrderIdString客户端提供的订单标识符（自定义标签）。
symbolString交易对，格式为 BASE-QUOTE（例如 BTC-USDT）。
quoteString交易对的计价货币。
orderStateString当前订单状态标签（例如 active、inactive、cancelled）。
orderTypeInteger数字订单类型代码（限价、市价、锚定、TWAP）。
orderSideString订单方向：BUY 或 SELL。
orderPriceDouble订单限价。市价单为零。
orderValueDouble以用户账户货币表示的当前订单价值。
timestampLong订单创建时间戳，单位为 Unix 纪元毫秒。
timeInForceString有效方式策略：GTC、IOC、FOK，如不适用则为 null。
orderCurrencyString指示哪些数量字段被填充："quote"（以计价货币计价）或 "base"（以基础货币计价）。
originalOrderBaseSizeDouble以基础货币计的原始订单数量。仅当 orderCurrency 为 "base" 时填充。
originalOrderQuoteSizeDouble以计价货币计的原始订单数量。仅当 orderCurrency 为 "quote" 时填充。
currentOrderBaseSizeDouble以基础货币计的当前未成交订单数量。仅当 orderCurrency 为 "base" 时填充。
currentOrderQuoteSizeDouble以计价货币计的当前未成交订单数量。仅当 orderCurrency 为 "quote" 时填充。
remainingOrderBaseSizeDouble以基础货币计的剩余未成交数量。仅当 orderCurrency 为 "base" 时填充。
remainingOrderQuoteSizeDouble以计价货币计的剩余未成交数量。仅当 orderCurrency 为 "quote" 时填充。
totalFilledBaseSizeDouble以基础货币计的累计成交数量。
avgFilledPriceDouble此订单所有成交的成交量加权平均成交价格。
orderDetailTypeString对订单用途或子类型进行分类的订单详情类别。 — TWAP · PARTIAL_LIQUIDATION · FORCED_MARKET_BUY · FORCED_MARKET_SELL
orderDetailObject
triggerOrderBoolean若此为触发（条件）订单，则为 true。
triggeredBoolean一旦触发条件已触发且底层订单已释放，则为 true。
triggerUseLastPriceBoolean若触发依据最新成交价格评估，则为 true；若依据标记价格评估，则为 false。仅对触发订单有意义。
triggerPriceDouble有效触发价格。仅对触发订单有意义。
triggerOriginalPriceDouble客户端最初提交的触发价格。仅对触发订单有意义。
triggerOrderTypeInteger数字触发订单类型代码（止损、止盈、止损限价或止盈限价）。仅对触发订单有意义。
triggerStopPriceDouble触发订单的止损价格。仅对触发订单有意义。
triggerTrailingStopDeviationDouble相对参考价格的追踪止损偏差。仅对追踪止损触发订单有意义。
trailValueDouble追踪偏移幅度。仅对追踪止损订单有意义。
trailValueTypeStringtrailValue 的解释方式（例如绝对金额或百分比）。仅对追踪止损订单有意义。 — DISTANCE · PERCENTAGE
pegPriceMinDouble锚定价格区间的下限。仅对锚定订单有意义。
pegPriceMaxDouble锚定价格区间的上限。仅对锚定订单有意义。
pegPriceDeviationDouble锚定时应用于参考价格的偏移量。仅对锚定订单有意义。
currentPegPriceDouble当前有效锚定价格。仅对锚定订单有意义。
wrapperOrderBoolean若订单是一组相关订单的封装器（例如 bracket/OCO），则为 true。
activationPriceDouble订单变为可执行所需达到的激活价格。仅对使用激活价格功能的订单存在。
activationPriceTypeString评估 activationPrice 时所用的参考价格类型。仅对使用激活价格功能的订单存在。 — INDEX_PRICE · LAST_PRICE · MARK_PRICE
example
GEThttps://api.btse.com/spot/api/v4/trade/orders

Response (default)

[
  {
    "requestId": 4268545858604010500,
    "orderId": "4eca2eb4-e6ad-4355-ae12-5ce757b105b3",
    "clOrderId": null,
    "symbol": "BTC-USD",
    "quote": "USD",
    "orderState": "STATUS_ACTIVE",
    "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
  }
]