跳到主要内容

批量修改订单

接口描述​

批量修改多个订单。每次最多允许修改 5 个订单。

HTTP请求​

PUT /fapi/v1/batchOrders (HMAC SHA256)

请求权重​

5

请求参数​

名称类型是否必需描述
batchOrdersJSON LISTYES订单列表，最多包含 5 个订单参数
timestampLONGYES时间戳

每个订单对象中包含的参数请参考 修改订单 接口。

响应示例​

[
  {
    "orderId": 2254222045,
    "symbol": "BTCUSDT",
    "status": "NEW",
    "clientOrderId": "testOrderBatchModify1",
    "price": "60500",
    "origQty": "0.1",
    "updateTime": 1623910239123
  },
  {
    "code": -2011,
    "msg": "Unknown order sent."
  }
]

响应是一个列表，每个元素对应请求中的一个订单。 命中的 orderId 或 origClientOrderId 必须填其一。

代码示例​

cURL​

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
BATCH='[{"symbol":"BTCUSDT","orderId":2254222045,"side":"BUY","quantity":"0.02","price":"61000"},{"symbol":"BTCUSDT","orderId":2254222046,"side":"SELL","quantity":"0.02","price":"79000"}]'
QUERY_STRING="batchOrders=${BATCH}&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY_STRING}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')

curl -s -X PUT \
  -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api-sepolia.ztdx.io/fapi/v1/batchOrders?${QUERY_STRING}&signature=${SIGNATURE}"

Python​

import time, hmac, hashlib, requests, json
from urllib.parse import quote

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.ztdx.io"

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

# Modify two existing orders in a batch
batch_orders = [
    {"symbol": "BTCUSDT", "orderId": "order_id_1", "side": "BUY", "quantity": "0.02", "price": "61000"},
    {"symbol": "BTCUSDT", "orderId": "order_id_2", "side": "SELL", "quantity": "0.02", "price": "79000"},
]

ts = int(time.time() * 1000)
batch_str = json.dumps(batch_orders, separators=(',', ':'))
encoded = quote(batch_str)
qs = f"batchOrders={encoded}&timestamp={ts}"
sig = sign(qs)
resp = requests.put(
    f"{BASE_URL}/fapi/v1/batchOrders?{qs}&signature={sig}",
    headers={"X-MBX-APIKEY": API_KEY},
)
print(resp.json())