查询所有订单 (包括历史订单)

接口描述

查询特定交易对的所有订单（包括活跃、已撤销或已成交的订单）。

HTTP请求

GET /fapi/v1/allOrders (HMAC SHA256)

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
orderId	STRING	NO	接受但当前被忽略 —— 响应不会按订单 ID 过滤
startTime	LONG	NO	接受但当前被忽略 —— 不做任何时间过滤
endTime	LONG	NO	接受但当前被忽略 —— 不做任何时间过滤
limit	INT	NO	默认 500; 最大 1000
timestamp	LONG	YES	时间戳

响应始终返回调用者在该交易对上最近的订单（最新在前，最多 limit 条），服务端不做进一步过滤。没有时间截止 —— 更早的订单仍然可查。

响应示例

[
  {
    "orderId": "3fa42833-9508-4061-8d80-b68563dcd521",
    "symbol": "BTCUSDT",
    "status": "NEW",
    "clientOrderId": "abc",
    "price": "60000",
    "avgPrice": "0",
    "origQty": "0.01",
    "executedQty": "0",
    "cumQuote": "0",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "reduceOnly": false,
    "side": "BUY",
    "positionSide": "BOTH",
    "stopPrice": "0",
    "workingType": "CONTRACT_PRICE",
    "priceProtect": false,
    "origType": "LIMIT",
    "updateTime": 1774330265238,
    "time": 1774330191022
  }
]

代码示例

cURL

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="symbol=BTCUSDT&limit=500&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/allOrders?${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 all orders history for BTCUSDT
resp = signed_get("/fapi/v1/allOrders", params={
    "symbol": "BTCUSDT",
    "limit": "500"
})
print(resp.json())