跳到主要内容

用户强平订单

接口描述​

查询用户被强平的订单历史。

HTTP请求​

GET /fapi/v1/forceOrders (HMAC SHA256)

请求参数​

名称类型是否必需描述
symbolSTRINGNO交易对
startTimeLONGNO接受但当前被忽略 —— 不做任何时间过滤
endTimeLONGNO接受但当前被忽略 —— 不做任何时间过滤
limitINTNO默认 100; 最大 1000
timestampLONGYES时间戳

响应示例​

[
    {
        "orderId": "9d1a3c6e-2f47-4b8a-9c30-5b7de2a41f88",
        "symbol": "BTCUSDT",
        "status": "FILLED",
        "side": "SELL",
        "type": "LIQUIDATION",
        "price": "56000",
        "origQty": "1",
        "executedQty": "1",
        "time": 1623910239123,
        "updateTime": 1623910239123
    }
]

响应返回调用者最近的强平事件，最新在前，最多 limit 条。没有时间截止。 如果不发送 symbol，则会返回所有交易对的强平单。

代码示例​

cURL​

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

curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.prex.world/fapi/v1/forceOrders?${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_get(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.get(f"{BASE_URL}{path}", params=params, headers={"X-MBX-APIKEY": API_KEY})

# Get user's liquidation orders for BTCUSDT
resp = signed_get("/fapi/v1/forceOrders", params={
    "symbol": "BTCUSDT",
    "limit": "100"
})
print(resp.json())