账户与交易（v2）

USDT-M / USDC-M REST API v2。

总览

成功响应格式：

json

{ "code": 200, "msg": "success", "data": { } }

成功时 code 为 200；错误为负数错误码，见错误码。
列表类接口的 data 为 JSON 数组（如当前委托、成交）。JSON 批量下单时，每一项为 { "code", "order" }。
验签与 JSON 请求体（v2） 见基础信息中需签名接口与 v2 说明。
JSON 形态说明： 系统中的 64 位整型（如时间戳、订单号）在 JSON 里多为字符串（非裸数字）。为 null 的可选字段通常整段省略（响应里一般看不到 "字段": null）。stopPrice、triggerBy 等仅在有值时才会出现在返回体中。

枚举类参数速查

请求/响应中常用字符串枚举的允许取值（以下字段在每个出现它们的接口里取值范围一致）。

参数	允许取值
category	`USDT`（USDT-M）、`USDC`（USDC-M）
side	`BUY`、`SELL`
positionSide	`LONG`、`SHORT`
type	普通单：`LIMIT` 限价单、`MARKET` 市价单计划委托：`STOP` 触发后转限价单、`STOP_MARKET` 触发后转市价单改计划委托请求体：`STOP` 改计划委托、`STOP_PROFIT_LOSS` 改止盈止损
stopCategory	`STOP` 计划委托、`STOP_PROFIT_LOSS` 止盈止损
timeInForce	`GTC`、`FOK`、`IOC`、`POST_ONLY`
triggerBy / tpTriggerBy / slTriggerBy	`CONTRACT_PRICE`、`MARK_PRICE`
tpOrderType / slOrderType	`MARKET`、`LIMIT`
stopOrderType	`TAKE_PROFIT`、`STOP_LOSS`
stopType	`FIXED_STOP`、`TRAILING_STOP`
fallbackType	`RATE`、`PRICE`

下普通单 (TRADE)

POST /api/v2/futures/order

权重：1

参数

名称	类型	是否必须	说明
symbol	STRING	YES	合约 symbolId
side	STRING	YES	`BUY` 或 `SELL`
positionSide	STRING	YES	`LONG` 或 `SHORT`
type	STRING	YES	`LIMIT` 或 `MARKET`
newClientOrderId	STRING	YES	客户端订单号
quantity	DECIMAL	NO	委托数量（单位是张）；与 `valueQuantity` 至少其一非 0
valueQuantity	DECIMAL	NO	USDT名义价值；与 `quantity` 至少其一非 0
price	DECIMAL	NO	`type` = `LIMIT` 时必填；`MARKET` 不传
timeInForce	STRING	NO	`GTC`、`FOK`、`IOC`、`POST_ONLY`；默认 `GTC`。
takeProfit	STRING	NO	止盈价格
tpTriggerBy	STRING	NO	触发止盈的价格类型：`CONTRACT_PRICE`、`MARK_PRICE`
tpLimitPrice	STRING	NO	触发止盈后转换为限价单的价格（`tpOrderType` = `LIMIT` 时）
tpOrderType	STRING	NO	止盈触发后的订单类型：`MARKET`、`LIMIT`
stopLoss	STRING	NO	止损价格
slTriggerBy	STRING	NO	触发止损的价格类型：`CONTRACT_PRICE`、`MARK_PRICE`
slLimitPrice	STRING	NO	触发止损后转换为限价单的价格（`slOrderType` = `LIMIT` 时）
slOrderType	STRING	NO	止损触发后的订单类型：`MARKET`、`LIMIT`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1668418485058",
    "updateTime": "1668418485058",
    "orderId": "1289182123551455488",
    "clientOrderId": "test1115",
    "symbol": "BTC-SWAP-USDT",
    "price": "19000",
    "leverage": "2",
    "origQty": "10",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "9.5",
    "type": "LIMIT",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "NEW",
    "contractMultiplier": "0.001"
  }
}

批量下单（JSON）(TRADE)

POST /api/v2/futures/batch-orders

权重：2

Content-Type: application/json — 请求 body 为订单对象的 JSON 数组。验签方式见JSON 请求体验签示例（API v2）。

Query 参数（参与签名）

名称	类型	是否必须	说明
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	需签名
recvWindow	LONG	NO	recv 窗口

请求体（JSON 数组）— 每个元素

每个元素须包含与单笔下单相同的业务字段；各字段含义与 下普通单 参数表相同。

名称	类型	是否必须	说明
newClientOrderId	STRING	YES	客户端订单号
symbol	STRING	YES	合约 symbolId
side	STRING	YES	`BUY` 或 `SELL`
positionSide	STRING	YES	`LONG` 或 `SHORT`
type	STRING	YES	`LIMIT` 或 `MARKET`
quantity	DECIMAL	NO	每条数量单位是张；与 `valueQuantity` 至少其一非 0
valueQuantity	DECIMAL	NO	USDT名义价值；与 `quantity` 至少其一非 0
price	DECIMAL	NO	`type` = `LIMIT` 时每条必填；省略时默认 0
timeInForce	STRING	NO	`GTC`、`FOK`、`IOC`、`POST_ONLY`；每行未填时默认 `GTC`

响应

数组每项 { code, order }：失败行 order 为 null；成功行返回订单对象。

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "code": 200,
      "order": {
        "time": "1668418485058",
        "updateTime": "1668418485058",
        "orderId": "1289182123551455488",
        "clientOrderId": "c1",
        "symbol": "BTC-SWAP-USDT",
        "price": "19000",
        "leverage": "2",
        "origQty": "10",
        "executedQty": "0",
        "avgPrice": "0",
        "marginLocked": "9.5",
        "type": "LIMIT",
        "side": "BUY",
        "positionSide": "LONG",
        "timeInForce": "GTC",
        "status": "NEW",
        "contractMultiplier": "0.001"
      }
    },
    {
      "code": -2011,
      "order": null
    }
  ]
}

改普通单 (TRADE)

POST /api/v2/futures/order/update

权重：2

参数

仅支持修改 LIMIT 单（价格、数量等按接口字段）。

名称	类型	是否必须	说明
orderId	LONG	NO	与 `origClientOrderId` 二选一；定位订单须传其一
origClientOrderId	STRING	NO	与 `orderId` 二选一；要修改的订单客户端单号
newClientOrderId	STRING	NO	新客户端单号；省略则自动生成
quantity	DECIMAL	NO	新数量（可选，单位是张）
valueQuantity	DECIMAL	NO	新价值数量；默认 0
price	DECIMAL	NO	新价格；默认 0
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952682388",
    "updateTime": "1767952682388",
    "orderId": "2124135487564299264",
    "clientOrderId": "1767952681690",
    "symbol": "ETH-SWAP-USDT",
    "price": "4000",
    "leverage": "20",
    "origQty": "1",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "2",
    "type": "LIMIT",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "NEW",
    "contractMultiplier": "0.01"
  }
}

撤单笔普通单 (TRADE)

DELETE /api/v2/futures/order

权重：1

参数

名称	类型	是否必须	说明
orderId	LONG	NO	与 `origClientOrderId` 二选一；撤单须传其一
origClientOrderId	STRING	NO	与 `orderId` 二选一
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1668418485058",
    "updateTime": "1668418490000",
    "orderId": "1289182123551455488",
    "clientOrderId": "test1115",
    "symbol": "BTC-SWAP-USDT",
    "price": "19000",
    "leverage": "2",
    "origQty": "10",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "0",
    "type": "LIMIT",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "CANCELED",
    "contractMultiplier": "0.001"
  }
}

批量撤普通单 (TRADE)

DELETE /api/v2/futures/batch-orders

权重：3

参数

名称	类型	是否必须	说明
symbol	STRING	YES	逗号分隔的合约 symbolId
side	STRING	NO	可选 `BUY` 或 `SELL`；省略则不按买卖方向筛选。本接口无 `positionSide`。
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 为 null（不返回订单对象，无字符串枚举字段）。

json

{
  "code": 200,
  "msg": "success",
  "data": null
}

查单笔普通单 (USER_DATA)

GET /api/v2/futures/order

权重：1

参数

名称	类型	是否必须	说明
orderId	LONG	NO	与 `origClientOrderId` 二选一；查询须传其一
origClientOrderId	STRING	NO	与 `orderId` 二选一
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1668418485058",
    "updateTime": "1668418485058",
    "orderId": "1289182123551455488",
    "clientOrderId": "test1115",
    "symbol": "BTC-SWAP-USDT",
    "price": "19000",
    "leverage": "2",
    "origQty": "10",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "9.5",
    "type": "LIMIT",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "NEW",
    "contractMultiplier": "0.001"
  }
}

当前普通单 (USER_DATA)

GET /api/v2/futures/open-orders

权重：1

参数

名称	类型	是否必须	说明
symbol	STRING	NO	按交易对过滤；空为全部
orderId	LONG	NO	游标
limit	INT	NO	默认 `20`，最小 `1`，最大 `1000`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "time": "1668418485058",
      "updateTime": "1668418485058",
      "orderId": "1289182123551455488",
      "clientOrderId": "test1115",
      "symbol": "BTC-SWAP-USDT",
      "price": "19000",
      "leverage": "2",
      "origQty": "10",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "9.5",
      "type": "LIMIT",
      "side": "BUY",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "NEW",
      "contractMultiplier": "0.001"
    }
  ]
}

历史普通单 (USER_DATA)

GET /api/v2/futures/history-orders

权重：5

参数

名称	类型	是否必须	说明
symbol	STRING	NO	按交易对过滤；空为全部
orderId	LONG	NO	游标；默认 0
startTime	LONG	NO	开始时间（ms）；`<=0` 时用默认滑窗
endTime	LONG	NO	结束时间（ms）
limit	INT	NO	默认 `20`，最小 `1`，最大 `1000`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "time": "1668418485058",
      "updateTime": "1668418485058",
      "orderId": "1289182123551455488",
      "clientOrderId": "test1115",
      "symbol": "BTC-SWAP-USDT",
      "price": "19000",
      "leverage": "2",
      "origQty": "10",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "9.5",
      "type": "LIMIT",
      "side": "BUY",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "NEW",
      "contractMultiplier": "0.001"
    }
  ]
}

用户成交 (USER_DATA)

GET /api/v2/futures/user-trades

权重：5

参数

名称	类型	是否必须	说明
symbol	STRING	YES	合约 symbolId
fromId	LONG	NO	默认 0
toId	LONG	NO	默认 0
startTime	LONG	NO	开始时间（ms）
endTime	LONG	NO	结束时间（ms）
limit	INT	NO	默认 `20`，最小 `1`，最大 `1000`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "time": "1668419000000",
      "createdTime": "1668419000100",
      "id": "9876543210",
      "orderId": "1289182123551455488",
      "matchOrderId": "1289182123551456000",
      "matchAccountId": "10001",
      "accountId": "122216245228131",
      "symbol": "BTC-SWAP-USDT",
      "price": "19000",
      "qty": "1",
      "commissionAsset": "USDT",
      "commission": "0.01",
      "makerRebate": "0",
      "type": "LIMIT",
      "side": "BUY",
      "positionSide": "LONG",
      "realizedPnl": "0",
      "ticketId": "t1",
      "isMaker": true,
      "matchOrderStrategy": 0
    }
  ]
}

下计划委托 (TRADE)

POST /api/v2/futures/algo-order

权重：1

参数

名称	类型	是否必须	说明
symbol	STRING	YES	合约 symbolId
side	STRING	YES	`BUY` 或 `SELL`
positionSide	STRING	YES	`LONG` 或 `SHORT`
type	STRING	YES	`STOP` 或 `STOP_MARKET`
stopPrice	DECIMAL	YES	触发价
newClientOrderId	STRING	YES	客户端订单号
quantity	DECIMAL	NO	委托数量（单位是张）；与 `valueQuantity` 至少其一非 0
valueQuantity	DECIMAL	NO	USDT名义价值；与 `quantity` 至少其一非 0
price	DECIMAL	NO	`type` = `STOP` 时必填（触发后限价）；`STOP_MARKET` 不传
timeInForce	STRING	NO	`GTC`、`FOK`、`IOC`、`POST_ONLY`；未传时默认 `GTC`
triggerBy	STRING	NO	触发价格类型：`CONTRACT_PRICE`（默认）、`MARK_PRICE`
takeProfit	STRING	NO	止盈价格
tpTriggerBy	STRING	NO	触发止盈的价格类型：`CONTRACT_PRICE`、`MARK_PRICE`
tpLimitPrice	STRING	NO	触发止盈后转换为限价单的价格（`tpOrderType` = `LIMIT` 时）
tpOrderType	STRING	NO	止盈触发后的订单类型：`MARKET`、`LIMIT`
stopLoss	STRING	NO	止损价格
slTriggerBy	STRING	NO	触发止损的价格类型：`CONTRACT_PRICE`、`MARK_PRICE`
slLimitPrice	STRING	NO	触发止损后转换为限价单的价格（`slOrderType` = `LIMIT` 时）
slOrderType	STRING	NO	止损触发后的订单类型：`MARKET`、`LIMIT`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

示例 — 计划委托（STOP / STOP_MARKET）：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952799216",
    "updateTime": "1767952799216",
    "orderId": "2124136467689134848",
    "clientOrderId": "1767952799112",
    "symbol": "BTC-SWAP-USDT",
    "price": "0",
    "leverage": "20",
    "origQty": "2",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "10",
    "type": "STOP_MARKET",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "95000",
    "triggerBy": "CONTRACT_PRICE"
  }
}

改计划委托 (TRADE)

POST /api/v2/futures/algo-order/update

权重：2

参数

名称	类型	是否必须	说明
type	STRING	YES	`STOP`（改计划委托类）或 `STOP_PROFIT_LOSS`（改正盈止损类）
orderId	LONG	NO	与 `origClientOrderId` 二选一；定位待改订单
origClientOrderId	STRING	NO	与 `orderId` 二选一；待改单的客户端单号
newClientOrderId	STRING	NO	新客户端单号；省略则自动生成
quantity	DECIMAL	NO	新数量（单位是张）
valueQuantity	DECIMAL	NO	默认 0
price	DECIMAL	NO	默认 0
stopPrice	DECIMAL	NO	触发价；默认 0
triggerBy	STRING	NO	`CONTRACT_PRICE` 或 `MARK_PRICE`；空则沿用原单
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

按请求体 type 选择改动单族，返回相应的订单对象：计划类返回 STOP / STOP_MARKET，止盈止损类返回 STOP_PROFIT_LOSS / STOP_PROFIT_LOSS_MARKET。止盈止损类对象可包含附加枚举字段 stopOrderType、stopType、fallbackType（追踪止损适用时）以及相关字段（如 activePrice、fallbackQuantity、activeStatus 等）。

示例 — 计划类：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952799216",
    "updateTime": "1767952800000",
    "orderId": "2124136467689134848",
    "clientOrderId": "1767952799112",
    "symbol": "BTC-SWAP-USDT",
    "price": "96000",
    "leverage": "20",
    "origQty": "2",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "10",
    "type": "STOP",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "95000",
    "triggerBy": "CONTRACT_PRICE"
  }
}

示例 — 止盈止损类：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952801000",
    "updateTime": "1767952802000",
    "orderId": "2124136467689135000",
    "clientOrderId": "1767952800001",
    "symbol": "BTC-SWAP-USDT",
    "price": "100000",
    "leverage": "20",
    "origQty": "1",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "5",
    "type": "STOP_PROFIT_LOSS",
    "side": "SELL",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "99000",
    "triggerBy": "CONTRACT_PRICE",
    "stopOrderType": "TAKE_PROFIT",
    "stopType": "FIXED_STOP"
  }
}

查单笔计划委托 (USER_DATA)

GET /api/v2/futures/algo-order

权重：1

仅按订单号定位，计划委托与止盈止损均支持。

参数

名称	类型	是否必须	说明
orderId	LONG	NO	与 `origClientOrderId` 二选一；查询须传其一
origClientOrderId	STRING	NO	与 `orderId` 二选一
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 为单笔计划委托或止盈止损订单。

type：
- STOP — 计划委托，触发后限价成交；
- STOP_MARKET — 计划委托，触发后市价成交；
- STOP_PROFIT_LOSS — 止盈止损条件，触发后限价；
- STOP_PROFIT_LOSS_MARKET — 止盈止损条件，触发后市价。
当 type 为 STOP_PROFIT_LOSS 或 STOP_PROFIT_LOSS_MARKET 时，可出现附加枚举字段 stopOrderType、stopType。
追踪止损适用时，可出现 fallbackType 以及 activePrice、fallbackQuantity、activeStatus 等字段（有则返回）。

示例 — 计划委托：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952799216",
    "updateTime": "1767952800000",
    "orderId": "2124136467689134848",
    "clientOrderId": "1767952799112",
    "symbol": "BTC-SWAP-USDT",
    "price": "0",
    "leverage": "20",
    "origQty": "2",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "10",
    "type": "STOP",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "96000",
    "triggerBy": "CONTRACT_PRICE"
  }
}

示例 — 止盈止损限价（STOP_PROFIT_LOSS，止盈）：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952801000",
    "updateTime": "1767952802000",
    "orderId": "2124136467689135000",
    "clientOrderId": "tp-001",
    "symbol": "BTC-SWAP-USDT",
    "price": "100000",
    "leverage": "20",
    "origQty": "1",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "5",
    "type": "STOP_PROFIT_LOSS",
    "side": "SELL",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "99000",
    "triggerBy": "MARK_PRICE",
    "stopOrderType": "TAKE_PROFIT",
    "stopType": "FIXED_STOP"
  }
}

示例 — 止盈止损市价（STOP_PROFIT_LOSS_MARKET，止损）：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952803000",
    "updateTime": "1767952803000",
    "orderId": "2124136467689135001",
    "clientOrderId": "sl-mkt-001",
    "symbol": "BTC-SWAP-USDT",
    "price": "0",
    "leverage": "20",
    "origQty": "1",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "5",
    "type": "STOP_PROFIT_LOSS_MARKET",
    "side": "SELL",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "92000",
    "triggerBy": "CONTRACT_PRICE",
    "stopOrderType": "STOP_LOSS",
    "stopType": "FIXED_STOP"
  }
}

示例 — 追踪止损（TRAILING_STOP，含 activePrice / fallback*）：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952804000",
    "updateTime": "1767952804000",
    "orderId": "2124136467689135002",
    "clientOrderId": "trail-001",
    "symbol": "BTC-SWAP-USDT",
    "price": "0",
    "leverage": "20",
    "origQty": "1",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "5",
    "type": "STOP_PROFIT_LOSS",
    "side": "SELL",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_NEW",
    "contractMultiplier": "0.001",
    "stopPrice": "0",
    "triggerBy": "CONTRACT_PRICE",
    "stopOrderType": "STOP_LOSS",
    "stopType": "TRAILING_STOP",
    "activePrice": "95000",
    "fallbackType": "RATE",
    "fallbackQuantity": "0.01",
    "activeStatus": 0
  }
}

撤单笔计划委托 (TRADE)

DELETE /api/v2/futures/algo-order

按 orderId 或 origClientOrderId 撤销单笔计划委托或止盈止损。

权重：1

参数

名称	类型	是否必须	说明
orderId	LONG	NO	与 `origClientOrderId` 二选一；撤销须传其一
origClientOrderId	STRING	NO	与 `orderId` 二选一
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 为撤单后的订单快照（计划委托或止盈止损）。

type：与 查单笔计划委托「响应」一致，可取 STOP、STOP_MARKET、STOP_PROFIT_LOSS、STOP_PROFIT_LOSS_MARKET，含义同上。
止盈止损单另含 stopOrderType（TAKE_PROFIT、STOP_LOSS）、stopType（FIXED_STOP、TRAILING_STOP）；追踪止损在适用时另含 activePrice、fallbackType（RATE、PRICE）等。

示例 — 计划委托：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952799216",
    "updateTime": "1767952805000",
    "orderId": "2124136467689134848",
    "clientOrderId": "1767952799112",
    "symbol": "BTC-SWAP-USDT",
    "price": "0",
    "leverage": "20",
    "origQty": "2",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "10",
    "type": "STOP",
    "side": "BUY",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_CANCELED",
    "contractMultiplier": "0.001",
    "stopPrice": "96000",
    "triggerBy": "CONTRACT_PRICE"
  }
}

示例 — 止盈止损：

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "time": "1767952801000",
    "updateTime": "1767952805000",
    "orderId": "2124136467689135000",
    "clientOrderId": "tp-001",
    "symbol": "BTC-SWAP-USDT",
    "price": "100000",
    "leverage": "20",
    "origQty": "1",
    "executedQty": "0",
    "avgPrice": "0",
    "marginLocked": "5",
    "type": "STOP_PROFIT_LOSS",
    "side": "SELL",
    "positionSide": "LONG",
    "timeInForce": "GTC",
    "status": "ORDER_CANCELED",
    "contractMultiplier": "0.001",
    "stopPrice": "99000",
    "triggerBy": "MARK_PRICE",
    "stopOrderType": "TAKE_PROFIT",
    "stopType": "FIXED_STOP"
  }
}

当前计划委托 (USER_DATA)

GET /api/v2/futures/open-algo-orders

权重：1

参数

名称	类型	是否必须	说明
symbol	STRING	NO	过滤；空为全部
orderId	LONG	NO	游标
stopCategory	STRING	NO	`STOP`（仅计划委托）或 `STOP_PROFIT_LOSS`（仅止盈止损）；省略时仅返回计划类 `STOP`，不含止盈止损
limit	INT	NO	默认 `20`，最小 `1`，最大 `1000`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 为订单数组，每行可能为计划委托或止盈止损订单：

行内 type：可取 STOP、STOP_MARKET、STOP_PROFIT_LOSS、STOP_PROFIT_LOSS_MARKET，含义同 查单笔计划委托「响应」。返回哪些 type 受请求 stopCategory 过滤决定（仅过滤行集合，不改变单行 type 含义）。
止盈止损行另含 stopOrderType（TAKE_PROFIT、STOP_LOSS）、stopType（FIXED_STOP、TRAILING_STOP）；追踪止损行在适用时另含 activePrice、fallbackType（RATE、PRICE）、fallbackQuantity、activeStatus 等。

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "time": "1767952799216",
      "updateTime": "1767952799216",
      "orderId": "2124136467689134848",
      "clientOrderId": "1767952799112",
      "symbol": "BTC-SWAP-USDT",
      "price": "0",
      "leverage": "20",
      "origQty": "2",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "10",
      "type": "STOP_MARKET",
      "side": "BUY",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "ORDER_NEW",
      "contractMultiplier": "0.001",
      "stopPrice": "95000",
      "triggerBy": "CONTRACT_PRICE"
    },
    {
      "time": "1767952801000",
      "updateTime": "1767952802000",
      "orderId": "2124136467689135000",
      "clientOrderId": "tp-001",
      "symbol": "BTC-SWAP-USDT",
      "price": "100000",
      "leverage": "20",
      "origQty": "1",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "5",
      "type": "STOP_PROFIT_LOSS",
      "side": "SELL",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "ORDER_NEW",
      "contractMultiplier": "0.001",
      "stopPrice": "99000",
      "triggerBy": "MARK_PRICE",
      "stopOrderType": "TAKE_PROFIT",
      "stopType": "FIXED_STOP"
    },
    {
      "time": "1767952803000",
      "updateTime": "1767952803000",
      "orderId": "2124136467689135001",
      "clientOrderId": "sl-mkt-001",
      "symbol": "BTC-SWAP-USDT",
      "price": "0",
      "leverage": "20",
      "origQty": "1",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "5",
      "type": "STOP_PROFIT_LOSS_MARKET",
      "side": "SELL",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "ORDER_NEW",
      "contractMultiplier": "0.001",
      "stopPrice": "92000",
      "triggerBy": "CONTRACT_PRICE",
      "stopOrderType": "STOP_LOSS",
      "stopType": "FIXED_STOP"
    },
    {
      "time": "1767952804000",
      "updateTime": "1767952804000",
      "orderId": "2124136467689135002",
      "clientOrderId": "trail-001",
      "symbol": "BTC-SWAP-USDT",
      "price": "0",
      "leverage": "20",
      "origQty": "1",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "5",
      "type": "STOP_PROFIT_LOSS",
      "side": "SELL",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "ORDER_NEW",
      "contractMultiplier": "0.001",
      "stopPrice": "0",
      "triggerBy": "CONTRACT_PRICE",
      "stopOrderType": "STOP_LOSS",
      "stopType": "TRAILING_STOP",
      "activePrice": "95000",
      "fallbackType": "RATE",
      "fallbackQuantity": "0.01",
      "activeStatus": 0
    }
  ]
}

历史计划委托 (USER_DATA)

GET /api/v2/futures/history-algo-orders

权重：5

参数

名称	类型	是否必须	说明
symbol	STRING	NO	过滤；空为全部
orderId	LONG	NO	默认 0
stopCategory	STRING	NO	`STOP`（仅计划委托）或 `STOP_PROFIT_LOSS`（仅止盈止损）；省略时仅返回计划类 `STOP`，不含止盈止损
startTime	LONG	NO	开始时间（ms）；`<=0` 时用默认滑窗
endTime	LONG	NO	结束时间（ms）
limit	INT	NO	默认 `20`，最小 `1`，最大 `1000`
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 为订单数组，每行可能为计划委托或止盈止损订单：

行内 type：可取 STOP、STOP_MARKET、STOP_PROFIT_LOSS、STOP_PROFIT_LOSS_MARKET，含义同 查单笔计划委托「响应」。返回哪些 type 受请求 stopCategory 过滤决定（仅过滤行集合，不改变单行 type 含义）。
止盈止损行另含 stopOrderType（TAKE_PROFIT、STOP_LOSS）、stopType（FIXED_STOP、TRAILING_STOP）；追踪止损行在适用时另含 activePrice、fallbackType（RATE、PRICE）、fallbackQuantity、activeStatus 等。

json

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "time": "1767952799216",
      "updateTime": "1767952799216",
      "orderId": "2124136467689134848",
      "clientOrderId": "1767952799112",
      "symbol": "BTC-SWAP-USDT",
      "price": "0",
      "leverage": "20",
      "origQty": "2",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "10",
      "type": "STOP_MARKET",
      "side": "BUY",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "ORDER_NEW",
      "contractMultiplier": "0.001",
      "stopPrice": "95000",
      "triggerBy": "CONTRACT_PRICE"
    },
    {
      "time": "1767952801000",
      "updateTime": "1767952802000",
      "orderId": "2124136467689135000",
      "clientOrderId": "tp-001",
      "symbol": "BTC-SWAP-USDT",
      "price": "100000",
      "leverage": "20",
      "origQty": "1",
      "executedQty": "0",
      "avgPrice": "0",
      "marginLocked": "5",
      "type": "STOP_PROFIT_LOSS",
      "side": "SELL",
      "positionSide": "LONG",
      "timeInForce": "GTC",
      "status": "ORDER_NEW",
      "contractMultiplier": "0.001",
      "stopPrice": "99000",
      "triggerBy": "MARK_PRICE",
      "stopOrderType": "TAKE_PROFIT",
      "stopType": "FIXED_STOP"
    }
  ]
}

批量撤计划委托 (TRADE)

DELETE /api/v2/futures/batch-cancel-algo-orders

权重：3

参数

名称	类型	是否必须	说明
symbol	STRING	YES	逗号分隔 symbolId
stopCategory	STRING	YES	必填：`STOP`（撤该 symbol 下计划委托）或 `STOP_PROFIT_LOSS`（撤该 symbol 下止盈止损类）
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 恒为 null（不返回订单对象，无字符串枚举字段）。

json

{
  "code": 200,
  "msg": "success",
  "data": null
}

调整杠杆 (TRADE)

POST /api/v2/futures/leverage

权重：1

参数

名称	类型	是否必须	说明
symbol	STRING	YES	合约 symbolId
leverage	STRING	YES	目标杠杆倍数（请求中使用字符串传入）
category	STRING	NO	USDT-M 传 `USDT`，USDC-M 传 `USDC`；默认 `USDT`
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

响应

data 为新的杠杆设置结果，无字符串枚举字段（leverage 为数值）。

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "symbolId": "BTC-SWAP-USDT",
    "leverage": 20
  }
}

查询账户流水 (USER_DATA)

GET /api/v2/account/balance-flow 见账户与交易（v2）。

账户与交易（v2） ​

总览 ​

枚举类参数速查 ​

下普通单 (TRADE) ​

权重：1 ​

参数 ​

响应 ​

批量下单（JSON）(TRADE) ​

权重：2 ​

Query 参数（参与签名） ​

请求体（JSON 数组）— 每个元素 ​

响应 ​

改普通单 (TRADE) ​

权重：2 ​

参数 ​

响应 ​

撤单笔普通单 (TRADE) ​

权重：1 ​

参数 ​

响应 ​

批量撤普通单 (TRADE) ​

权重：3 ​

参数 ​

响应 ​

查单笔普通单 (USER_DATA) ​

权重：1 ​

参数 ​

响应 ​

当前普通单 (USER_DATA) ​

权重：1 ​

参数 ​

响应 ​

历史普通单 (USER_DATA) ​

权重：5 ​

参数 ​

响应 ​

用户成交 (USER_DATA) ​

权重：5 ​

参数 ​

响应 ​

下计划委托 (TRADE) ​

权重：1 ​

参数 ​

响应 ​

改计划委托 (TRADE) ​

权重：2 ​

参数 ​

响应 ​

查单笔计划委托 (USER_DATA) ​

权重：1 ​

参数 ​

响应 ​

撤单笔计划委托 (TRADE) ​

权重：1 ​

参数 ​

响应 ​

当前计划委托 (USER_DATA) ​

权重：1 ​

参数 ​

响应 ​

历史计划委托 (USER_DATA) ​

权重：5 ​

参数 ​

响应 ​

批量撤计划委托 (TRADE) ​

权重：3 ​

参数 ​

响应 ​

调整杠杆 (TRADE) ​

权重：1 ​

参数 ​

响应 ​

查询账户流水 (USER_DATA) ​

账户与交易（v2）

总览

枚举类参数速查

下普通单 (TRADE)

权重：1

参数

响应

批量下单（JSON）(TRADE)

权重：2

Query 参数（参与签名）

请求体（JSON 数组）— 每个元素

响应

改普通单 (TRADE)

权重：2

参数

响应

撤单笔普通单 (TRADE)

权重：1

参数

响应

批量撤普通单 (TRADE)

权重：3

参数

响应

查单笔普通单 (USER_DATA)

权重：1

参数

响应

当前普通单 (USER_DATA)

权重：1

参数

响应

历史普通单 (USER_DATA)

权重：5

参数

响应

用户成交 (USER_DATA)

权重：5

参数

响应

下计划委托 (TRADE)

权重：1

参数

响应

改计划委托 (TRADE)

权重：2

参数

响应

查单笔计划委托 (USER_DATA)

权重：1

参数

响应

撤单笔计划委托 (TRADE)

权重：1

参数

响应

当前计划委托 (USER_DATA)

权重：1

参数

响应

历史计划委托 (USER_DATA)

权重：5

参数

响应

批量撤计划委托 (TRADE)

权重：3

参数

响应

调整杠杆 (TRADE)

权重：1

参数

响应

查询账户流水 (USER_DATA)