更新日志

2025-09-16

更新一个接口 :
- POST /sapi/v1/margin/apiKey: 接口描述增加可支持产品的详细说明，以及错误码说明。

2025-06-17

杠杆交易新增最佳实践模块。

2025-06-16

杠杆交易新增币种或币对预上架接口:
- GET /sapi/v1/margin/list-schedule: 查询全仓和逐仓的币种或币对的上架计划

2024-09-19

杠杆交易为VIP4及以上的用户提供了低延迟交易接口，这类接口通过特定的SpecialKey实现杠杆交易。

若您的VIP级别为3及以下，请联系您的VIP经理获取相关SpecialKey的使用许可标准。

关于SpecialKey的接口包含：
- POST /sapi/v1/margin/apiKey
- DELETE /sapi/v1/margin/apiKey
- PUT /sapi/v1/margin/apiKey/ip
- GET /sapi/v1/margin/apiKey
- GET /sapi/v1/margin/api-key-list
special API key使用步骤
1. 通过上述新建SAPI接口创建"margin trade only" 权限的key/secret对；
2. 全仓杠杆无需传递symbol参数；
3. 逐仓杠杆则用symbol参数指定特定交易对；
4. 使用步骤#1生成的key/secret对进行杠杆交易，同时可用现货REST api (https://api.binance.com/api/v3/) 接口创建listenKey进行监听。

2024-09-13

我们将在杠杆市场开始推出新功能 One-Triggers-the-Other (OTO) 订单和 One-Triggers-a-One-Cancels-The-Other (OTOCO) 订单。
- POST /sapi/v1/margin/order/oto: One-Triggers-the-Other (OTO) 订单
- POST /sapi/v1/margin/order/otoco: One-Triggers-a-One-Cancels-The-Other (OTOCO) 订单
在全仓杠杆账户接口GET /sapi/v1/margin/account新增2个返回参数并替换原有参数'transferEnabled' ：
- transferInEnabled
- transferOutEnabled

2024-01-09

根据公告，币安杠杆将于 2024 年 03 月 31 日 12:00（东八区时间）下架以下 SAPI 接口，请及时更换为对应替代接口:
- 将下架POST /sapi/v1/margin/transfer，应替换为POST /sapi/v1/asset/transfer万能划转
- 将下架POST /sapi/v1/margin/isolated/transfer，应替换为POST /sapi/v1/asset/transfer万能划转
- 将下架POST /sapi/v1/margin/loan，应替换为POST /sapi/v1/margin/borrow-repay借还款接口（新增）
- 将下架POST /sapi/v1/margin/repay，应替换为POST /sapi/v1/margin/borrow-repay借还款接口（新增）
- 将下架GET /sapi/v1/margin/isolated/transfer，应替换为GET /sapi/v1/margin/transfer获取全仓杠杆划转历史
- 将下架GET /sapi/v1/margin/asset，应替换为GET /sapi/v1/margin/allAssets
- 将下架GET /sapi/v1/margin/pair，应替换为GET /sapi/v1/margin/allPairs
- 将下架GET /sapi/v1/margin/isolated/pair，应替换为GET /sapi/v1/margin/isolated/allPairs
- 将下架GET /sapi/v1/margin/loan，应替换为GET /sapi/v1/margin/borrow-repay
- 将下架GET /sapi/v1/margin/repay，应替换为GET /sapi/v1/margin/borrow-repay
- 将下架GET /sapi/v1/margin/dribblet，应替换为GET /sapi/v1/asset/dribblet
- 将下架GET /sapi/v1/margin/dust，应替换为POST /sapi/v1/asset/dust-btc
- 将下架POST /sapi/v1/margin/dust，应替换为POST /sapi/v1/asset/dust
新增杠杆交易接口:
- POST /sapi/v1/margin/borrow-repay：杠杆账户借贷/还款
- GET /sapi/v1/margin/borrow-repay：查询借贷/还款记录
更新 3 个杠杆交易接口:
- GET /sapi/v1/margin/transfer：新增参数 isolatedSymbol，新增响应信息
- GET /sapi/v1/margin/allAssets：新增参数asset，新增响应信息
- GET /sapi/v1/margin/allPairs：新增参数symbol
- GET /sapi/v1/margin/isolated/allPairs：新增参数symbol

2023-12-22

新增杠杆交易 Websocket：
- 新的 base url 为wss://margin-stream.binance.com，推送两类事件：负债变化事件和 Margin Call 事件

2023-11-21

更新杠杆接口
- POST /sapi/v1/margin/order: 参数sideEffectType增加AUTO_BORROW_REPAY选项
- POST /sapi/v1/margin/order/oco: 参数sideEffectType增加AUTO_BORROW_REPAY选项
- GET /sapi/v1/margin/available-inventory: 响应增加返回参数 updateTime ，表示放贷库存的获取时间

2023-11-17

新增杠杠接口支持全仓 Pro 模式FAQ:
- GET /sapi/v1/margin/leverageBracket: 查询全仓杠杆 Pro 模式下的负债币种杠杆与保证金率
更新杠杠接口:
- POST /sapi/v1/margin/max-leverage: 增加 maxLeverage入参 10 以支持全仓 Pro 模式
- GET /sapi/v1/margin/account: 新增响应字段accountType, MARGIN_2 以支持全仓 Pro 模式

2023-10-16

新增杠杆接口:
- GET /sapi/v1/margin/available-inventory: 杠杆可用放贷库存查询
- POST /sapi/v1/margin/manual-liquidation: 杠杆手动强平

2023-08-31

新增杠杆接口：
- /sapi/v1/margin/capital-flow: 查询全仓/逐仓资金流水

2023-07-07

新增杠杆接口：
- POST /sapi/v1/margin/max-leverage: 调整全仓最大杠杆倍数

2023-06-22

更新杠杆接口：
- POST /sapi/v1/margin/order：增加参数autoRepayAtCancel和 selfTradePreventionMode
- POST /sapi/v1/margin/order/oco: 增加参数 selfTradePreventionMode

2023-06-20

新增杠杆接口：
- GET /sapi/v1/margin/delist-schedule：查询全仓和逐仓的币种或币对的下架计划

2023-02-27

新增杠杆接口:
- /sapi/v1/margin/next-hourly-interest-rate: 查询用户币种预估下小时利率

2023-02-02

添加杠杆接口:
- GET /sapi/v1/margin/exchange-small-liability: 查询可小额负债转换的资产
- POST /sapi/v1/margin/exchange-small-liability: 全仓杠杆小额负债转换
- GET /sapi/v1/margin/exchange-small-liability-history: 查询全仓杠杆小额负债转换历史

2023-01-13

添加杠杆账户接口：
- GET /sapi/v1/margin/crossMarginCollateralRatio: 获取全仓币种质押率信息

2022-09-16

添加杠杆账户接口：
- GET /sapi/v1/margin/tradeCoeff：获取用户个人杠杆账户信息汇总

2022-07-01

添加新杠杆账户接口：
- GET /sapi/v1/margin/dribblet 查询用户杠杆账户小额资产转换 BNB 历史信息。
更新杠杆账户接口：
- GET /sapi/v1/margin/repay：响应出参增加字段 rawAsset，表示原始币种。

2022-05-26

更新杠杆账户接口：查询时间范围最大不得超过 30 天：
- GET /sapi/v1/margin/transfer
- GET /sapi/v1/margin/loan
- GET /sapi/v1/margin/repay
- GET /sapi/v1/margin/isolated/transfer
- GET /sapi/v1/margin/interestHistory

2022-04-26

新增接口 GET /sapi/v1/margin/rateLimit/order
- 回传用户在当前时间区间内的杠杆账户下单总数

2021-12-30

更新杠杆接口：
- 获取杠杆利率历史接口GET /sapi/v1/margin/interestRateHistory移除参数limit，查询时间间隔更改为最大 1 个月

2021-12-03

新增杠杆接口:
- 新增接口 GET /sapi/v1/margin/crossMarginData 以获取全仓杠杆利率及限额
- 新增接口 GET /sapi/v1/margin/isolatedMarginData 以获取逐仓杠杆利率及限额
- 新增接口 GET /sapi/v1/margin/isolatedMarginTier 以获取逐仓档位信息

2021-10-14

以下杠杆账户接口更新返回数据的时间范围，startTime与endTime时间跨度不能超过 30 天，如果不传时间参数默认返回最近 7 天数据，如果archived参数为true，则默认返回 6 个月以前的最后 7 天数据:
- GET /sapi/v1/margin/transfer
- GET /sapi/v1/margin/loan
- GET /sapi/v1/margin/repay
- GET /sapi/v1/margin/isolated/transfer
- GET /sapi/v1/margin/interestHistory

2021-09-08

新增以下杠杆账户接口支持杠杆逐仓账户启用限制:
- 新增接口 DELETE /sapi/v1/margin/isolated/account 以支持杠杆逐仓账户停用
- 新增接口 POST /sapi/v1/margin/isolated/account 以支持杠杆逐仓账户启用
- 新增接口 GET /sapi/v1/margin/isolated/accountLimit 以查询杠杆逐仓账户上限
查询杠杆逐仓账户信息接口 GET /sapi/v1/margin/isolated/account 响应加入字段 "enabled" 判断账户是否启用

2021-08-23

新增杠杆账户 OCO 接口:
- POST /sapi/v1/margin/order/oco
- DELETE /sapi/v1/margin/orderList
- GET /sapi/v1/margin/orderList
- GET /sapi/v1/margin/allOrderList
- GET /sapi/v1/margin/openOrderList

用法与现货账户 OCO 相同

2021-04-28

从 May 15, 2021 08:00 UTC 开始, 以下创建逐仓杠杆账户接口将关闭:

POST /sapi/v1/margin/isolated/create

后续，用户可通过逐仓杠杆账户划转 POST /sapi/v1/margin/isolated/transfer 直接完成逐仓杠杆账户的创建与交易准备，无需调用接口创建账户

2021-04-02

新增钱包接口:
- GET /sapi/v1/system/status 以获取系统状态
- GET /sapi/v1/account/status 以获取账户状态
- GET /sapi/v1/account/apiTradingStatus 以获取账户 API 交易状态
- GET /sapi/v1/asset/dribblet 以获取小额资产转换 BNB 历史
- GET /sapi/v1/asset/assetDetail 以获取上架资产详情
- GET /sapi/v1/asset/tradeFee 以获取交易手续费率查询
新增子母账户接口:
- GET /sapi/v3/sub-account/assets 以查询子账户资产

2021-03-05

新增杠杆接口：
- GET /sapi/v1/margin/interestRateHistory 以支持杠杆利率历史查询

2021-02-04

更新钱包接口：
- 用户万向划转接口 POST /sapi/v1/asset/transfer 和GET /sapi/v1/asset/transfer 新增划转类型 MARGIN_MINING ,MINING_MARGIN, MARGIN_C2C ,C2C_MARGIN, MARGIN_CMFUTURE, CMFUTURE_MARGIN 以支持全仓杠杆，矿池，C2C，币本位合约账户间划转。

2021-01-15

杠杆交易添加新接口 DELETE /sapi/v1/margin/openOrders
- 此接口便于用户撤销单一交易对的所有挂单, 包括 OCO 的挂单。

2020-12-04

更新杠杆代币接口:
- 接口GET /sapi/v1/blvt/tokenInfo 新增返回参数 currentBaskets(包括 symbol， amount ， notionalValue )，purchaseFeePct申购费率，dailyPurchaseLimit每日申购数量上限，redeemFeePct赎回费率，dailyRedeemLimit每日赎回数量上限。
新增杠杆代币接口:
- GET /sapi/v1/blvt/userLimit 以查询用户每日申购赎回限额。

2020-12-01

更新杠杆交易接口:
- POST /sapi/v1/margin/order 加入参数 quoteOrderQty 支持"报价总额市价单"。

2020-11-16

更新杠杆接口加入 archived 参数以支持查询 6 个月以前数据:
- GET /sapi/v1/margin/loan
- GET /sapi/v1/margin/repay
- GET /sapi/v1/margin/interestHistory

2020-11-10

新增 BNB 抵扣开关接口:
- POST /sapi/v1/bnbBurn BNB 现货交易和杠杆利息抵扣开关。
- GET /sapi/v1/bnbBurn 获取 BNB 抵扣开关状态。

2020-09-30

杠杆账户接口更新:
- GET /sapi/v1/margin/maxBorrowable 返回新字段 borrowLimit 为用户账户借贷限额。

2020-08-26

逐仓杠杆接口 GET /sapi/v1/margin/isolated/account 新增可选参数 symbols, 以支持查询至多 5 个指定 symbol 的杠杆逐仓资产。

2020-07-28

逐仓杠杆相关接口

以下接口新增可选参数"isIsolated", 并在返回内容中新增字段 "symbol":
- POST /sapi/v1/margin/loan
- POST /sapi/v1/margin/repay
以下接口新增可选参数"isIsolated", 并在返回内容中新增字段 "isIsolated":
- POST /sapi/v1/margin/order
- DELETE /sapi/v1/margin/order
- GET /sapi/v1/margin/order
- GET /sapi/v1/margin/openOrders
- GET /sapi/v1/margin/allOrders
- GET /sapi/v1/margin/myTrades
以下接口新增可选参数"isolatedSymbol", 并在返回内容中新增字段 "isolatedSymbol":
- GET /sapi/v1/margin/loan
- GET /sapi/v1/margin/repay
- GET /sapi/v1/margin/interestHistory
接口 GET /sapi/v1/margin/forceLiquidationRec 新增可选参数"isolatedSymbol", 并在返回内容中新增字段 "isIsolated"
以下接口新增可选参数"isolatedSymbol":
- GET /sapi/v1/margin/maxBorrowable
- GET /sapi/v1/margin/maxTransferable
新增以下逐仓杠杆功能接口:
- POST /sapi/v1/margin/isolated/create
- POST /sapi/v1/margin/isolated/transfer
- GET /sapi/v1/margin/isolated/transfer
- GET /sapi/v1/margin/isolated/account
- GET /sapi/v1/margin/isolated/pair
- GET /sapi/v1/margin/isolated/allPairs
新增以下接口，管理逐仓杠杆账户 listenKey:
- POST /sapi/v1/userDataStream/isolated
- PUT /sapi/v1/userDataStream/isolated
- DELETE /sapi/v1/userDataStream/isolated

2020-07-20

接口GET /sapi/v1/margin/allOrders 参数"limit"的可传最大值更新为 500.

2020-07-17

接口 GET /sapi/v1/margin/allOrders 增加访问限制为每个 IP 最多每分钟 60 次

2019-11-30

接口POST /sapi/v1/margin/order (HMAC SHA256)新增参数sideEffectType，可选内容如下:
- NO_SIDE_EFFECT: 普通交易订单;
- MARGIN_BUY: 自动借款交易订单;
- AUTO_REPAY: 自动还款交易订单.
New field marginBuyBorrowAmount and marginBuyBorrowAsset in FULL response to POST /sapi/v1/margin/order (HMAC SHA256)

更新日志

2025-09-16​

2025-06-17​

2025-06-16​

2024-09-19​

special API key使用步骤​

2024-09-13​

2024-01-09​

2023-12-22​

2023-11-21​

2023-11-17​

2023-10-16​

2023-08-31​

2023-07-07​

2023-06-22​

2023-06-20​

2023-02-27​

2023-02-02​

2023-01-13​

2022-09-16​

2022-07-01​

2022-05-26​

2022-04-26​

2021-12-30​

2021-12-03​

2021-10-14​

2021-09-08​

2021-08-23​

2021-04-28​

2021-04-02​

2021-03-05​

2021-02-04​

2021-01-15​

2020-12-04​

2020-12-01​

2020-11-16​

2020-11-10​

2020-09-30​

2020-08-26​

2020-07-28​

2020-07-20​

2020-07-17​

2019-11-30​

2025-09-16

2025-06-17

2025-06-16

2024-09-19

special API key使用步骤

2024-09-13

2024-01-09

2023-12-22

2023-11-21

2023-11-17

2023-10-16

2023-08-31

2023-07-07

2023-06-22

2023-06-20

2023-02-27

2023-02-02

2023-01-13

2022-09-16

2022-07-01

2022-05-26

2022-04-26

2021-12-30

2021-12-03

2021-10-14

2021-09-08

2021-08-23

2021-04-28

2021-04-02

2021-03-05

2021-02-04

2021-01-15

2020-12-04

2020-12-01

2020-11-16

2020-11-10

2020-09-30

2020-08-26

2020-07-28

2020-07-20

2020-07-17

2019-11-30