下单 (TRADE)
下单 (TRADE)。
查询参数
symbol交易对，例如 BTCUSDT。
side买卖方向，取值：BUY、SELL。
positionSide持仓方向，取值：LONG、SHORT。
type订单类型，取值：LIMIT、MARKET。
quantity下单数量，必须大于 0。
newClientOrderId客户自定义订单号（1-36 位，匹配 ^[\.A-Z:/a-z0-9_-]{1,36}$）。
timeInForce有效方式，type = LIMIT 时必填，取值：GTC、IOC、FOK、POST_ONLY。
price限价订单价格，type = LIMIT 时必填。
tpTriggerPrice预设止盈触发价。
slTriggerPrice预设止损触发价。
TpWorkingType止盈触发价计算基准，取值：CONTRACT_PRICE、MARK_PRICE，默认 CONTRACT_PRICE。
SlWorkingType止损触发价计算基准，取值：CONTRACT_PRICE、MARK_PRICE，默认 CONTRACT_PRICE。
reduceOnly是否只减仓。
下单 (TRADE) › 响应
成功响应
orderId系统生成的订单 ID。
clientOrderId回显的 newClientOrderId。
success是否受理成功。
errorCode当 success = false 时返回错误码；成功时为空。
errorMessage当 success = false 时返回错误信息；成功时为空。
批量下单 (TRADE)
批量下单 (TRADE)。
撤单 (TRADE)
撤单 (TRADE)。
查询参数
orderId目标订单 ID，当未提供 origClientOrderId 时必填。
origClientOrderId客户自定义订单号（1-36 位），当未提供 orderId 时必填。
撤单 (TRADE) › 响应
成功响应
orderId被撤销的订单 ID。
origClientOrderId客户订单号（如提交时提供）。
success是否撤单成功。
errorCode当 success = false 时的错误码。
errorMessage当 success = false 时的错误信息。
批量撤单 (TRADE)
批量撤单 (TRADE)。
查询参数
orderIdList最多 10 个订单 ID；当 origClientOrderIdList 留空时必填。
origClientOrderIdList最多 10 个客户端订单号，匹配 ^[\.A-Z:/a-z0-9_-]{1,36}$；当 orderIdList 留空时必填。
批量撤单 (TRADE) › 响应
成功响应
orderId被撤销的订单 ID。
origClientOrderId客户订单号（如提交时提供）。
success是否撤单成功。
errorCode当 success = false 时的错误码。
errorMessage当 success = false 时的错误信息。
一键市价平仓 (TRADE)
一键市价平仓 (TRADE)。
下条件单 (TRADE)
下条件单 (TRADE)。
查询参数
symbol交易对，例如 BTCUSDT。
side买卖方向，BUY 或 SELL。
positionSide持仓方向，LONG 或 SHORT。
type条件单类型，STOP、TAKE_PROFIT、STOP_MARKET、TAKE_PROFIT_MARKET、TRAILING_MARKET。
quantity下单数量，必须大于 0。
clientAlgoId客户自定义条件单 ID（1-36 位，匹配 ^[\.A-Z:/a-z0-9_-]{1,36}$）。
price执行价格，当 type 为 STOP 或 TAKE_PROFIT 时必填。
triggerPrice触发价格，当 type 为 STOP、TAKE_PROFIT、STOP_MARKET 或 TAKE_PROFIT_MARKET 时必填。
presetTakeProfitPrice预设止盈触发价。
presetStopLossPrice预设止损触发价。
TpWorkingType止盈触发价类型：CONTRACT_PRICE 或 MARK_PRICE，默认 CONTRACT_PRICE。
SlWorkingType止损触发价类型：CONTRACT_PRICE 或 MARK_PRICE，默认 CONTRACT_PRICE。
activatePrice追踪止损激活价格，仅当 type = TRAILING_MARKET 时有效；不传则按 workingType 使用当前市场价格。
callbackRate追踪止损回调比例，仅当 type = TRAILING_MARKET 时必填，取值范围 [0.001, 0.9999]。
workingType追踪委托激活和回调使用的价格类型：CONTRACT_PRICE、MARK_PRICE，默认 CONTRACT_PRICE。
reduceOnly是否只减仓。
下条件单 (TRADE) › 响应
成功响应
orderId系统生成的订单 ID。
clientOrderId回显的 newClientOrderId。
success是否受理成功。
errorCode当 success = false 时返回错误码；成功时为空。
errorMessage当 success = false 时返回错误信息；成功时为空。
撤销条件单 (TRADE)
撤销条件单 (TRADE)。
下止盈止损条件单 (TRADE)
下止盈止损条件单 (TRADE)。
查询参数
symbol交易对。
clientAlgoId客户自定义条件单 ID（1-36 位，匹配 ^[\.A-Z:/a-z0-9_-]{1,36}$）。
planType条件单类型：TAKE_PROFIT、STOP_LOSS。
triggerPrice触发价格，必须大于 0。
positionSide持仓方向：LONG、SHORT。
executePrice执行价格，为 0 或省略表示以市价执行。带单类型 API key 只支持市价平仓，必须传 0 或省略。
quantity委托数量。为 0 或省略表示设置全部仓位止盈止损。带单类型 API key 必须设置全部仓位平仓，必须传 0 或省略。
triggerPriceType触发价类型：CONTRACT_PRICE、MARK_PRICE，默认 CONTRACT_PRICE。
reduceOnly是否只减仓。
下止盈止损条件单 (TRADE) › 响应
成功响应
success是否提交成功。
orderId成功时返回的条件单 ID。
errorCode当 success = false 时的错误码。
errorMessage当 success = false 时的错误信息。
修改止盈止损条件单 (TRADE)
修改止盈止损条件单 (TRADE)。
查询订单详情 (USER_DATA)
查询订单详情 (USER_DATA)。
查询参数
orderId目标订单 ID。
查询订单详情 (USER_DATA) › 响应
成功响应
avgPrice平均成交价。
clientOrderId客户自定义订单号。
cumQuote已成交计价资产数量。
executedQty已成交基础资产数量。
orderId系统订单 ID。
origQty原始下单数量。
price下单价格。
reduceOnly是否仅减仓。
side买卖方向，取值见订单方向。
positionSide持仓方向，取值见持仓模式。
status订单状态，取值见订单状态。
stopPrice触发价/止损价（如适用）。
symbol交易对。
time下单时间（毫秒）。
timeInForce有效方式，取值见时间有效方式。
type订单类型，取值见订单类型。
updateTime最近更新时间（毫秒）。
workingType触发价类型，取值见触发价格类型。
查询当前委托 (USER_DATA)
查询当前委托 (USER_DATA)。
查询参数
symbol按交易对过滤。
orderId仅返回订单 ID 大于该值的记录。
startTime起始时间（毫秒）。
endTime结束时间（毫秒）。
limit分页大小，1-100，默认 100。
page分页索引，从 0 开始，默认 0。
查询当前委托 (USER_DATA) › 响应
成功响应
avgPrice平均成交价。
clientOrderId客户自定义订单号。
cumQuote已成交计价资产数量。
executedQty已成交基础资产数量。
orderId系统订单 ID。
origQty原始下单数量。
price下单价格。
reduceOnly是否仅减仓。
side买卖方向，取值见订单方向。
positionSide持仓方向，取值见持仓模式。
status订单状态，取值见订单状态。
stopPrice触发价/止损价（如适用）。
symbol交易对。
time下单时间（毫秒）。
timeInForce有效方式，取值见时间有效方式。
type订单类型，取值见订单类型。
updateTime最近更新时间（毫秒）。
workingType触发价类型，取值见触发价格类型。
priceProtectpriceMatchselfTradePreventionModegoodTillDate查询当前追踪委托 (USER_DATA)
查询当前追踪委托 (USER_DATA)。
查询参数
symbol按交易对过滤。
orderId仅返回订单 ID 大于该值的记录。
startTime起始时间（毫秒）。
endTime结束时间（毫秒）。
limit分页大小，1-100，默认 100。
page分页索引，从 0 开始，默认 0。
查询当前追踪委托 (USER_DATA) › 响应
成功响应
avgPrice平均成交价。
clientOrderId客户自定义订单号。
cumQuote已成交计价资产数量。
executedQty已成交基础资产数量。
orderId系统订单 ID。
origQty原始下单数量。
price下单价格。
reduceOnly是否仅减仓。
side买卖方向，取值见订单方向。
positionSide持仓方向，取值见持仓模式。
status订单状态，取值见订单状态。
stopPrice触发价/止损价（如适用）。
symbol交易对。
time下单时间（毫秒）。
timeInForce有效方式，取值见时间有效方式。
type订单类型，取值见订单类型。
updateTime最近更新时间（毫秒）。
workingType触发价类型，取值见触发价格类型。
activatePrice激活价格，有值时返回。
callbackRate回调幅度百分比，有值时返回。
查询历史委托 (USER_DATA)
查询历史委托 (USER_DATA)。
查询参数
symbol按交易对过滤。
limit每页数量，1-100，默认 100。
startTime起始时间（毫秒），需 ≤ endTime。
endTime结束时间（毫秒），与 startTime 间隔不超过 90 天。
page页码，从 0 开始，默认 0。
查询历史委托 (USER_DATA) › 响应
成功响应
orderId系统订单 ID。
symbol交易对。
side买卖方向，取值见订单方向。
positionSide持仓方向，取值见持仓模式。
status订单状态，取值见订单状态。
type订单类型，取值见订单类型。
time下单时间（毫秒）。
price下单价格。
origQty原始下单数量。
executedQty已成交基础资产数量。
avgPrice平均成交价。
updateTime最近更新时间（毫秒）。
clientOrderId客户自定义订单号。
cumQuote已成交计价资产数量。
timeInForce有效方式，取值见时间有效方式。
reduceOnly是否仅减仓。
stopPrice触发价/止损价（如适用）。
workingType触发价类型，取值见触发价格类型。
查询历史追踪委托 (USER_DATA)
查询历史追踪委托 (USER_DATA)。
查询参数
symbol按交易对过滤。
limit每页数量，1-1000，默认 500。
startTime起始时间（毫秒），需 ≤ endTime。
endTime结束时间（毫秒），与 startTime 间隔不超过 90 天。
page页码，从 0 开始，默认 0。
查询历史追踪委托 (USER_DATA) › 响应
成功响应
avgPrice平均成交价。
clientOrderId客户自定义订单号。
cumQuote已成交计价资产数量。
executedQty已成交基础资产数量。
orderId系统订单 ID。
origQty原始下单数量。
price下单价格。
reduceOnly是否仅减仓。
side买卖方向，取值见订单方向。
positionSide持仓方向，取值见持仓模式。
status订单状态，取值见订单状态。
stopPrice触发价/止损价（如适用）。
symbol交易对。
time下单时间（毫秒）。
timeInForce有效方式，取值见时间有效方式。
type订单类型，取值见订单类型。
updateTime最近更新时间（毫秒）。
workingType触发价类型，取值见触发价格类型。
activatePrice激活价格，有值时返回。
callbackRate回调幅度百分比，有值时返回。
查询成交明细 (USER_DATA)
查询成交明细 (USER_DATA)。
查询参数
symbol按交易对过滤。
orderId仅返回指定订单的成交。
startTime起始时间（毫秒）。
endTime结束时间（毫秒），需 ≥ startTime。
limit返回条数，1-100，默认 100。
查询成交明细 (USER_DATA) › 响应
成功响应
id成交 ID。
orderId对应订单 ID。
symbol交易对。
buyer是否为买方。
commission手续费金额。
commissionAsset手续费计价资产。
maker是否为挂单方。
price成交价格。
qty成交数量（基础资产）。
quoteQty成交金额（计价资产）。
realizedPnl该笔成交的已实现盈亏。
side买卖方向，BUY 或 SELL。
positionSide持仓方向，LONG 或 SHORT。
time成交时间（毫秒）。
查询当前条件单 (USER_DATA)
查询当前条件单 (USER_DATA)。
查询参数
symbol按交易对过滤。
startTime起始时间（毫秒）。
endTime结束时间（毫秒），需 ≥ startTime。
page页码，从 1 开始，默认 1。
limit每页数量，1-100，默认 100。
查询当前条件单 (USER_DATA) › 响应
成功响应
algoId条件单 ID。
clientAlgoId客户自定义 ID。
algoType条件单类型，目前仅返回 CONDITIONAL。
orderType触发后下发的订单类型，可为 STOP、TAKE_PROFIT、STOP_MARKET、TAKE_PROFIT_MARKET、TRAILING_STOP_MARKET。
symbol交易对。
side买卖方向，可为 BUY、SELL。
positionSide持仓方向，可为 LONG、SHORT。
timeInForce触发订单的有效方式，可为 GTC、IOC、FOK、POST_ONLY。
quantity委托数量。
algoStatus条件单状态，可为 NEW、PENDING、UNTRIGGERED、FILLED、CANCELED、CANCELING。
actualOrderId触发后的订单 ID（如有）。
actualPrice实际成交价格（如有）。
triggerPrice触发价格。
price触发订单的委托价格。
tpTriggerPrice止盈触发价（如配置）。
tpPrice止盈委托价（如配置）。
slTriggerPrice止损触发价（如配置）。
slPrice止损委托价（如配置）。
tpOrderType止盈触发价格来源，可为 CONTRACT_PRICE、MARK_PRICE。
workingType触发价来源，可为 CONTRACT_PRICE、MARK_PRICE。
closePosition是否全平仓。
reduceOnly触发订单是否仅减仓。
createTime创建时间（毫秒）。
updateTime最近更新时间（毫秒）。
triggerTime触发时间（毫秒），未触发时返回 0。
查询条件单历史 (USER_DATA)
查询条件单历史 (USER_DATA)。