调整杠杆倍数

接口描述

调整特定交易对的开仓杠杆倍数。

HTTP请求

POST /fapi/v1/leverage (HMAC SHA256)

请求权重

1

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
leverage	INT 或 STRING	YES	目标杠杆，必须落在该交易对的 [min_leverage, max_leverage] 区间内，详见 杠杆档位与仓位限制。同时接受数字字符串 ("20") 与整数 (20)。越界返回 -4028。
recvWindow	LONG	NO	详见 接口鉴权
timestamp	LONG	YES	时间戳

响应示例

{
    "leverage": 20,
    "maxNotionalValue": "1000000",
    "symbol": "BTCUSDT"
}

杠杆值会按 (用户, symbol) 持久化。该交易对后续未显式带 leverage 的下单会自动用持久值；再次调用 POST /fapi/v1/leverage 会覆盖。

maxNotionalValue 是该交易对的仓位上限（max_position_size_usd）， 直接来自交易场配置，详见 杠杆档位与仓位限制。 持仓状态下下调杠杆不会追溯重算保证金或重新定价已有持仓—— 新设置只对之后的订单生效。

代码示例

cURL

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

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

Python

import time, hmac, hashlib, requests, json

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()

def signed_post(path, body={}):
    ts = int(time.time() * 1000)
    qs = f"timestamp={ts}"
    body_str = json.dumps(body, separators=(',', ':'))
    sig = sign(qs + body_str)
    return requests.post(
        f"{BASE_URL}{path}?timestamp={ts}&signature={sig}",
        data=body_str,
        headers={"X-MBX-APIKEY": API_KEY, "Content-Type": "application/json"},
    )

# Change leverage to 20x for BTCUSDT
resp = signed_post("/fapi/v1/leverage", body={
    "symbol": "BTCUSDT",
    "leverage": 20,
})
print(resp.json())
# {"leverage": 20, "maxNotionalValue": "10000000.0000", "symbol": "BTCUSDT"}