跳到主要内容

撤销全部订单

接口描述​

撤销特定交易对的所有活跃订单。

HTTP请求​

DELETE /fapi/v1/allOpenOrders (HMAC SHA256)

请求参数​

名称类型是否必需描述
symbolSTRINGYES交易对
timestampLONGYES时间戳

响应示例​

{
    "code": 200,
    "msg": "The operation of cancel all open order is done."
}

注意​

  • 该操作撤销的是调用者在该交易对下 orders 表上的挂单： resting 限价单，以及通过 POST /fapi/v1/order 下的 STOP* / TAKE_PROFIT* 触发单。
  • 通过 POST /fapi/v1/algoOrder 创建的条件单 不会被本接口撤销 —— 请使用 DELETE /fapi/v1/algoOpenOrders。
  • 撤单不是单一事务：撮合引擎移除、状态更新和保证金释放是相互 独立的步骤。
  • 被撤销订单未成交余量对应的冻结保证金会释放回可用余额。

代码示例​

cURL​

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="symbol=BTCUSDT&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY_STRING}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')

curl -s -X DELETE \
  -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.prex.world/fapi/v1/allOpenOrders?${QUERY_STRING}&signature=${SIGNATURE}"

Python​

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.prex.world"

def sign(params: str) -> str:
    return hmac.new(API_SECRET.encode(), params.encode(), hashlib.sha256).hexdigest()

def signed_delete(path, params={}):
    params["timestamp"] = int(time.time() * 1000)
    qs = "&".join(f"{k}={v}" for k, v in params.items())
    params["signature"] = sign(qs)
    return requests.delete(f"{BASE_URL}{path}", params=params, headers={"X-MBX-APIKEY": API_KEY})

# Cancel all open orders for BTCUSDT
resp = signed_delete("/fapi/v1/allOpenOrders", params={
    "symbol": "BTCUSDT"
})
print(resp.json())