调整开仓杠杆(TRADE)

类型：TRADE

POST /fapi/v1/leverage

状态：已实现。

设置你在某个 symbol 上的杠杆偏好。之后在该 symbol 上的 POST /fapi/v1/order 都会使用该值（1–100x），直到你再次修改——与 Binance Futures 一致，杠杆是按 symbol 的常驻设置，而非订单内联参数。已按某杠杆开出的仓位在完全平掉前，其保证金计算仍沿用该杠杆；之后的 /fapi/v1/leverage 调用或不同杠杆的订单只影响新增敞口（开仓、同向加仓或反向翻转），不会在单纯减仓 / 平仓时追溯重算现有仓位的已锁定保证金。

Query 参数

参数仅从 URL query string 读取（body 仅参与签名载荷）；query string 缺少必填参数时返回 HTTP 400（axum 的纯文本拒绝，而非 {code, msg} JSON）。

字段	类型	必填	说明
symbol	string	是	standard pair，如 BTCUSDT。
leverage	integer	是	1–100（无符号整数）。0 或 > 100 返回 -1100；非整数或负数会导致 query 解析失败（HTTP 400，纯文本）。

响应 — 200

{
  "symbol": "BTCUSDT",
  "leverage": 25
}

此处 leverage 为 JSON 数字（在 GET /fapi/v2/positionRisk 中为字符串）。该设置按 (user, symbol) 存于 ledger.user_leverage，不是按仓位的值。

错误

HTTP	code	msg
400	-1100	未知 symbol，或 leverage 超出 1–100。
401	-2015	API key 无效或已吊销。
500	-1000	数据库故障。

签名 / API key 错误（-1021、-1022、-1102、-2014、-2015）及限流（-1003，HTTP 429）适用于所有签名接口；见 错误码。

来源：rocky-backend/services/api-gateway/src/fapi/routes_orders.rs（set_leverage），底层为 ledger.user_leverage。