Change Log
#
2024-01-09According to the announcement, Binance Margin will remove the following SAPI interfaces at 4:00 on March 31, 2024 (UTC). Please switch to the corresponding alternative interfaces in time:
POST /sapi/v1/margin/transfer
will be removed, please replace withPOST /sapi/v1/asset/transfer
universal transferPOST /sapi/v1/margin/isolated/transfer
will be removed, please replace withPOST /sapi/v1/asset/transfer
universal transferPOST /sapi/v1/margin/loan
will be removed, please replace with the newPOST /sapi/v1/margin/borrow-repay
borrowing and repayment interfacePOST /sapi/v1/margin/repay
will be removed, please replace with the newPOST /sapi/v1/margin/borrow-repay
borrowing and repayment interfaceGET /sapi/v1/margin/isolated/transfer
will be removed, please replace it withGET /sapi/v1/margin/transfer
to get total margin transfer historyGET /sapi/v1/margin/asset
will be removed, please replace withGET /sapi/v1/margin/allAssets
GET /sapi/v1/margin/pair
will be removed, please replace withGET /sapi/v1/margin/allPairs
GET /sapi/v1/margin/isolated/pair
will be removed, please replace withGET /sapi/v1/margin/isolated/allPairs
GET /sapi/v1/margin/loan
will be removed, please replace withGET /sapi/v1/margin/borrow-repay
GET /sapi/v1/margin/repay
will be removed, please replace withGET /sapi/v1/margin/borrow-repay
GET /sapi/v1/margin/dribblet
will be removed, please replace withGET /sapi/v1/asset/dribblet
GET /sapi/v1/margin/dust
will be removed, please replace withPOST /sapi/v1/asset/dust-btc
POST /sapi/v1/margin/dust
will be removed, please replace withPOST /sapi/v1/asset/dust
New Endpoints for Margin:
POST /sapi/v1/margin/borrow-repay
: Margin account borrow/repayGET /sapi/v1/margin/borrow-repay
: Query borrow/repay records in Margin account
Update Endpoints fpr Margin:
GET /sapi/v1/margin/transfer
: add parameterisolatedSymbol
, add response bodyGET /sapi/v1/margin/allAssets
: add parameterasset
, add response bodyGET /sapi/v1/margin/allPairs
: add parametersymbol
GET /sapi/v1/margin/isolated/allPairs
: add parametersymbol
#
2023-12-22- New Websocket for Margin Trading:
- New Base url
wss://margin-stream.binance.com
for two events: Liability update event and Margin call event
- New Base url
#
2023-11-21- Update endpoints for Margin
POST /sapi/v1/margin/order
:New enumerate valueAUTO_BORROW_REPAY
for the field ofsideEffectType
POST /sapi/v1/margin/order/oco
:New enumerate valueAUTO_BORROW_REPAY
for the field ofsideEffectType
GET /sapi/v1/margin/available-inventory
:New response field ofupdateTime
which indicates the acquisition time of lending inventory.
#
2023-11-17- New endpoint for Margin to support cross margin Pro modeFAQ:
GET /sapi/v1/margin/leverageBracket
: query Liability coin leverage bracket in cross margin Pro mode
- Update endpoints for Margin:
POST /sapi/v1/margin/max-leverage
: fieldmaxLeverage
adds value 10 for Cross Margin ProGET /sapi/v1/margin/account
: add new response fieldaccountType
,MARGIN_2
for Cross Margin Pro
#
2023-10-16- New endpoint for Margin:
GET /sapi/v1/margin/available-inventory
: Query margin available inventoryPOST /sapi/v1/margin/manual-liquidation
: Margin manual liquidation
#
2023-08-31- New endpoint for Margin:
/sapi/v1/margin/capital-flow
: Get cross or isolated margin capital flow
#
2023-07-07- New endpoints for Margin:
POST /sapi/v1/margin/max-leverage
: Adjust cross margin max leverage
#
2023-06-29- New endpoints for Margin:
GET /sapi/v1/margin/dust
: Get Assets That Can Be Converted Into BNBPOST /sapi/v1/margin/dust
: Convert dust assets to BNB.
#
2023-06-22- Update endpoints for Margin:
POST /sapi/v1/margin/order
: add fieldsautoRepayAtCancel
andselfTradePreventionMode
POST /sapi/v1/margin/order/oco
: add fieldselfTradePreventionMode
#
2023-06-20- Update endpoints for Margin:
GET /sapi/v1/margin/delist-schedule
: get tokens or symbols delist schedule for cross margin and isolated margin
#
2023-02-27- New endpoints for Margin:
/sapi/v1/margin/next-hourly-interest-rate
: Get user the next hourly estimate interest
#
2023-02-02- New endpoints for Margin:
GET /sapi/v1/margin/exchange-small-liability
: Query the coins which can be small liability exchangePOST /sapi/v1/margin/exchange-small-liability
: Cross Margin Small Liability ExchangeGET /sapi/v1/margin/exchange-small-liability-history
: Get Small liability Exchange History
#
2022-09-16- New endpoint for Margin:
GET /sapi/v1/margin/tradeCoeff
: Get personal margin level information
#
2022-07-01- New endpoint for Margin:
GET /sapi/v1/margin/dribblet
to query the historical information of user's margin account small-value asset conversion BNB.
- Update endpoint for Margin:
GET /sapi/v1/margin/repay
: Add response field rawAsset.
#
2022-05-26- Update info for the following margin account endpoints: The max interval between
startTime
andendTime
is 30 days.: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-26GET /sapi/v1/margin/rateLimit/order
added- The endpoint will display the user's current margin order count usage for all intervals.
#
2021-12-30- Update endpoint for Margin:
- Removed out
limit
fromGET /sapi/v1/margin/interestRateHistory
; The max interval between startTime and endTime is 30 days.
- Removed out
#
2021-12-03- New endpoints for Margin:
GET /sapi/v1/margin/crossMarginData
to get cross margin fee data collectionGET /sapi/v1/margin/isolatedMarginData
to get isolated margin fee data collectionGET /sapi/v1/margin/isolatedMarginTier
to get isolated margin tier data collection
#
2021-10-14- Update the time range of the response data for the following margin account endpoints,
startTime
andendTime
time span will not exceed 30 days, without time parameter sent the system will return the last 7 days of data by default, while thearchived
parameter istrue
, the system will return the last 7 days of data 6 months ago by default: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-08Add endpoints for enabled isolated margin account limit:
DELETE /sapi/v1/margin/isolated/account
to disable isolated margin account for a specific symbolPOST /sapi/v1/margin/isolated/account
to enable isolated margin account for a specific symbolGET /sapi/v1/margin/isolated/accountLimit
to query enabled isolated margin account limit
New field "enabled" in response of
GET /sapi/v1/margin/isolated/account
to check if the isolated margin account is enabled
#
2021-08-23- New endpoints for Margin Account 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
Same usage as spot account OCO
#
2021-04-28On May 15, 2021 08:00 UTC the SAPI Create Margin Account endpoint will be discontinued:
POST /sapi/v1/margin/isolated/create
Isolated Margin account creation and trade preparation can be completed directly through Isolated Margin funds transfer POST /sapi/v1/margin/isolated/transfer
#
2021-03-05- New endpoints for Margin:
GET /sapi/v1/margin/interestRateHistory
to support margin interest rate history query
#
2021-01-15- New endpoint
DELETE /sapi/v1/margin/openOrders
for Margin Trade- This will allow a user to cancel all open orders on a single symbol for margin account.
- This endpoint will cancel all open orders including OCO orders for margin account.
#
2020-12-01- Update Margin Trade Endpoint:
POST /sapi/v1/margin/order
new parameterquoteOrderQty
allow a user to specify the totalquoteOrderQty
spent or received in theMARKET
order.
#
2020-11-16- Updated endpoints for Margin, new parameter
archived
to query data from 6 months ago:GET /sapi/v1/margin/loan
GET /sapi/v1/margin/repay
GET /sapi/v1/margin/interestHistory
#
2020-11-10- New endpoint to toggle BNB Burn:
POST /sapi/v1/bnbBurn
to toggle BNB Burn on spot trade and margin interest.GET /sapi/v1/bnbBurn
to get BNB Burn status.
#
2020-09-30- Update endpoints for Margin Account:
GET /sapi/v1/margin/maxBorrowable
new fieldborrowLimit
in response for account borrow limit.
#
2020-08-26- New parameter
symbols
added in the endpointGET /sapi/v1/margin/isolated/account
.
#
2020-07-28ISOLATED MARGIN
New parameters "isIsolated" and "symbol" added for isolated margin in the following endpoints:
POST /sapi/v1/margin/loan
POST /sapi/v1/margin/repay
New parameter "isIsolated" and new response field "isIsolated" added for isolated margin in the following endpoints:
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
New parameter "isolatedSymbol" and new response field "isolatedSymbol" added for isolated margin in the following endpoints:
GET /sapi/v1/margin/loan
GET /sapi/v1/margin/repay
GET /sapi/v1/margin/interestHistory
New parameter "isolatedSymbol" and new response field "isIsolated" added for isolated margin in the following endpoint
GET /sapi/v1/margin/forceLiquidationRec
New parameter "isolatedSymbol" added for isolated margin in the following endpoints:
GET /sapi/v1/margin/maxBorrowable
GET /sapi/v1/margin/maxTransferable
New endpoints for isolated margin:
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
New endpoints for listenKey management of isolated margin account:
POST /sapi/v1/userDataStream/isolated
PUT /sapi/v1/userDataStream/isolated
DELETE /sapi/v1/userDataStream/isolated
#
2019-12-18- New endpoint to get daily snapshot of account:
GET /sapi/v1/accountSnapshot
#
2019-11-30Added parameter
sideEffectType
inPOST /sapi/v1/margin/order (HMAC SHA256)
with enums:NO_SIDE_EFFECT
for normal trade order;MARGIN_BUY
for margin trade order;AUTO_REPAY
for making auto repayment after order filled.
New field
marginBuyBorrowAmount
andmarginBuyBorrowAsset
inFULL
response toPOST /sapi/v1/margin/order (HMAC SHA256)
#
2019-11-28- New SAPI endpont to disable fast withdraw switch:
POST /sapi/v1/account/disableFastWithdrawSwitch (HMAC SHA256)
- New SAPI endpont to enable fast withdraw switch:
POST /sapi/v1/account/enableFastWithdrawSwitch (HMAC SHA256)