Change Log
2024-08-14
- Fix travel rule api documentation:
- For NZ travel rule content:
isAddressOwner
should be1
: Yes,2
: No - Add comments to withdrawal/deposit API regarding url parameters
- For NZ travel rule content:
2024-07-09
- Update travel rule questionnaire content:
- Add withdrawal/deposit questionnaire for Bahrain: Bahrain users can now use sAPI to withdraw/deposit funds
- Update deposit questionnaire for Japan: Adding new required filled
isAttested
and fix some text issue
2024-06-21
- Adding local entity withdrawal/deposit APIs to support travel rule requirements:
POST /sapi/v1/localentity/withdraw/apply
GET /sapi/v1/localentity/withdraw/history
PUT /sapi/v1/localentity/deposit/provide-info
GET /sapi/v1/localentity/deposit/history
2024-06-04
- Wallet Endpoints adjustment: for internal transfers, the txid prefix has been replaced to “Off-chain transfer”on 28 May 2024. “internal transfer” flag is no longer available in the TXID field, including historical transactions, the following endpoints are impacted:
GET /sapi/v1/capital/deposit/hisrec
GET /sapi/v1/capital/withdraw/history
GET /sapi/v1/capital/deposit/subHisrec
2024-05-22
- Update Sub Account Endpoint:
GET /sapi/v1/sub-account/transfer/subUserHistory
: update response fieldfromAccountType
andtoAccountType
. Return USDT_FUTURE/COIN_FUTURE in order to differentiate 2 futures wallets.
- New Wallet Endpoint:
GET /sapi/v1/account/info
: To fetch the “VIP Level”, “whether Margin account is enabled” and “whether Futures account is enabled”
2024-04-08
- Update Wallet Endpoint:
GET /sapi/v1/capital/config/getall
: delete response fieldresetAddressStatus
2024-01-15
- New Endpoints for Wallet:
GET /sapi/v1/spot/delist-schedule
: Query spot delist schedule
- Update Endpoints for Wallet:
GET /sapi/v1/asset/dribblet
:add parameteraccountType
POST /sapi/v1/asset/dust-btc
:add parameteraccountType
POST /sapi/v1/asset/dust
:add parameteraccountType
2023-11-21
- New endpoint for Wallet:
GET /sapi/v1/capital/deposit/address/list
: Fetch deposit address list with network.
2023-11-02
- Changes to Wallet Endpoint:
GET /sapi/v1/account/apiRestrictions
: add new response fieldenablePortfolioMarginTrading
2023-09-22
- New endpoints for Wallet:
GET /sapi/v1/asset/wallet/balance
: query user wallet balanceGET /sapi/v1/asset/custody/transfer-history
: query user delegation history(For Master Account)
2023-09-04
- Rate limit adjustment for Wallet Endpoint:
GET /sapi/v1/capital/withdraw/history
: UID rate limit is adjusted to 18000, maxmium 10 requests per second. Please refer to the endpoint description for detail
2023-05-18
- New endpoints for Wallet:
POST /sapi/v1/capital/deposit/credit-apply
: apply deposit credit for expired address
2023-05-09
- Update endpoints for Wallet:
POST /sapi/v1/asset/transfer
: add enumMAIN_PORTFOLIO_MARGIN
andPORTFOLIO_MARGIN_MAIN
2023-02-02
- Update endpoints for Wallet:
- Universal Transfer
POST /sapi/v1/asset/transfer
support option transfer
- Universal Transfer
2022-12-26
- New endpoints for wallet:
GET /sapi/v1/capital/contract/convertible-coins
: Get a user's auto-conversion settings in deposit/withdrawalPOST /sapi/v1/capital/contract/convertible-coins
: User can use it to turn on or turn off the BUSD auto-conversion from/to a specific stable coin.
2022-11-18
- New endpoint for Wallet:
GET /sapi/v1/asset/ledger-transfer/cloud-mining/queryByPage
: The query of Cloud-Mining payment and refund history
2022-11-02
- Update endpoints for Wallet:
POST /sapi/v1/capital/withdraw/apply
: Weight changed to Weight(UID): 600
2022-10-28
- Update endpoints for Wallet:
POST /sapi/v1/asset/convert-transfer
: New parameteraccountType
POST /sapi/v1/asset/convert-transfer/queryByPage
: request method is changed toGET
, new parameterclientTranId
2022-09-29
- New endpoints for Wallet:
POST /sapi/v1/asset/convert-transfer
: Convert transfer, convert between BUSD and stablecoins.POST /sapi/v1/asset/convert-transfer/queryByPage
: Query convert transfer
2022-07-01
- New endpoint for Wallet:
POST /sapi/v3/asset/getUserAsset
to get user assets.
2022-2-17
The following updates will take effect on February 24, 2022 08:00 AM UTC
- Update endpoint for Wallet:
GET /sapi/v1/accountSnapshot
The time limit of this endpoint is shortened to only support querying the data of the latest month
2022-02-09
- New endpoint for Wallet:
POST /sapi/v1/asset/dust-btc
to get assets that can be converted into BNB
2021-12-30
- Update endpoint for Wallet:
- As the Mining account is merged into Funding account, transfer types MAIN_MINING, MINING_MAIN, MINING_UMFUTURE, MARGIN_MINING, and MINING_MARGIN will be discontinued in Universal Transfer endpoint
POST /sapi/v1/asset/transfer
on January 05, 2022 08:00 AM UTC
- As the Mining account is merged into Funding account, transfer types MAIN_MINING, MINING_MAIN, MINING_UMFUTURE, MARGIN_MINING, and MINING_MARGIN will be discontinued in Universal Transfer endpoint
2021-11-19
- Update endpoint for Wallet:
- New field
info
added inGET /sapi/v1/capital/withdraw/history
to show the reason for withdrawal failure
- New field
2021-11-18
The following updates will take effect on November 25, 2021 08:00 AM UTC
- Update endpoint for Wallet:
GET /sapi/v1/accountSnapshot
The query time range of both endpoints are shortened to support data query within the last 6 months only, where startTime does not support selecting a timestamp beyond 6 months. If you do not specify startTime and endTime, the data of the last 7 days will be returned by default.
2021-11-17
- The following endpoints will be discontinued on November 17, 2021 13:00 PM UTC:
POST /sapi/v1/account/apiRestrictions/ipRestriction
to support user enable and disable IP restriction for an API KeyPOST /sapi/v1/account/apiRestrictions/ipRestriction/ipList
to support user add IP list for an API KeyGET /sapi/v1/account/apiRestrictions/ipRestriction
to support user query IP restriction for an API KeyDELETE /sapi/v1/account/apiRestrictions/ipRestriction/ipList
to support user delete IP list for an API Key
2021-11-16
- New endpoints for Sub-Account:
POST /sapi/v1/sub-account/subAccountApi/ipRestriction
to support master account enable and disable IP restriction for a sub-account API KeyPOST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
to support master account add IP list for a sub-account API KeyGET /sapi/v1/sub-account/subAccountApi/ipRestriction
to support master account query IP restriction for a sub-account API KeyDELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
to support master account delete IP list for a sub-account API Key
2021-11-05
- Update endpoint for Wallet:
- New parameter
walletType
added inPOST /sapi/v1/capital/withdraw/apply
to support user choose wallet typespot wallet
andfunding wallet
when withdraw crypto.
- New parameter
2021-11-04
The following updates will take effect on November 11, 2021 08:00 AM UTC
- Update endpoints for Wallet and Futures:
GET /sapi/v1/asset/transfer
GET /sapi/v1/futures/transfer
The query time range of both endpoints are shortened to support data query within the last 6 months only, where startTime does not support selecting a timestamp beyond 6 months. If you do not specify startTime and endTime, the data of the last 7 days will be returned by default.
2021-10-22
- Update endpoint for Wallet:
- New transfer types
MAIN_FUNDING
,FUNDING_MAIN
,FUNDING_UMFUTURE
,UMFUTURE_FUNDING
,MARGIN_FUNDING
,FUNDING_MARGIN
,FUNDING_CMFUTURE
andCMFUTURE_FUNDING
added in Universal Transfer endpointPOST /sapi/v1/asset/transfer
andGET /sapi/v1/asset/transfer
to support transfer assets among funding account and other accounts - As the C2C account, Binance Payment, Binance Card and other business account are merged into a Funding account, transfer types
MAIN_C2C
,C2C_MAIN
,C2C_UMFUTURE
,C2C_MINING
,UMFUTURE_C2C
,MINING_C2C
,MARGIN_C2C
,C2C_MARGIN
,MAIN_PAY
andPAY_MAIN
will be discontinued in Universal Transfer endpointPOST /sapi/v1/asset/transfer
andGET /sapi/v1/asset/transfer
on November 04, 2021 08:00 AM UTC
- New transfer types
2021-09-03
- Update endpoint for Wallet:
_ New fields
sameAddress
,depositDust
andspecialWithdrawTips
added inGET /sapi/v1/capital/config/getall
sameAddress
means if the coin needs to provide memo to withdrawdepositDust
means minimum creditable amountspecialWithdrawTips
means special tips for withdraw _ New fieldconfirmNo
added inGET /sapi/v1/capital/withdraw/history
to support query confirm times for withdraw history
2021-08-27
- Update endpoint for Wallet:
- New parameter
withdrawOrderId
added inGET /sapi/v1/capital/withdraw/history
to support user query withdraw history by withdrawOrderId - New field
unlockConfirm
added inGET /sapi/v1/capital/deposit/hisrec
to support query network confirm times for unlocking
- New parameter
2021-08-20
- Update endpoint for Wallet:
- New parameters
fromSymbol
,toSymbol
and new transfer typesISOLATEDMARGIN_MARGIN
,MARGIN_ISOLATEDMARGIN
andISOLATEDMARGIN_ISOLATEDMARGIN
added inPOST /sapi/v1/asset/transfer
andGET /sapi/v1/asset/transfer
to support user transfer assets between Margin(cross) account and Margin(isolated) account
- New parameters
2021-07-16
- New endpoint for Wallet:
GET /sapi/v1/account/apiRestrictions
to query user API Key permission
2021-07-09
- New endpoint for Wallet:
POST /sapi/v1/asset/get-funding-asset
to query funding wallet, includes Binance Pay, Binance Card, Binance Gift Card, Stock Token
2021-06-24
- Update endpoints for Wallet:
GET /sapi/v1/capital/withdraw/history
added default value 1000, max value 1000 for the parameterlimit
GET /sapi/v1/capital/deposit/hisrec
added default value 1000, max value 1000 for the parameterlimit
2021-05-26
- Update endpoint for Wallet:
- New transfer types
MAIN_PAY
,PAY_MAIN
added in Universal Transfer endpointPOST /sapi/v1/asset/transfer
andGET /sapi/v1/asset/transfer
to support trasnfer assets between spot account and pay account
- New transfer types
2020-12-30
- New endpoint for Wallet:
POST /sapi/v1/asset/transfer
to support user universal transfer among Spot, Margin, Futures, C2C, MINING accounts.GET /sapi/v1/asset/transfer
to get user universal transfer history.
2020-04-02
- New fields in response to endpoint
GET /sapi/v1/capital/config/getall
:minConfirm
for min number for balance confirmationunLockConfirm
for confirmation number for balance unlock
2020-03-13
- New parameter
transactionFeeFlag
is available in endpoint:POST /sapi/v1/capital/withdraw/apply
andPOST /wapi/v3/withdraw.html
2020-01-15
- New parameter
withdrawOrderId
for client customized withdraw id for endpointPOST /wapi/v3/withdraw.html
. - New field
withdrawOrderId
in response toGET /wapi/v3/withdrawHistory.html
2019-12-25
- Added time interval limit in
GET /sapi/v1/capital/withdraw/history
,
GET /wapi/v3/withdrawHistory.html
,
GET /sapi/v1/capital/deposit/hisrec
and
GET /wapi/v3/depositHistory.html
: _ The defaultstartTime
is 90 days from current time, and the defaultendTime
is current time. _ Please notice the defaultstartTime
andendTime
to make sure that time interval is within 0-90 days. * If bothstartTime
andendTime
are sent, time betweenstartTime
andendTime
must be less than 90 days.
2019-12-18
- New endpoint to get daily snapshot of account:
GET /sapi/v1/accountSnapshot
2019-11-30
-
Added 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-10-29
- New sapi endpoints for wallet.
POST /sapi/v1/capital/withdraw/apply (HMAC SHA256)
: withdraw.Get /sapi/v1/capital/withdraw/history (HMAC SHA256)
: fetch withdraw history with network.
2019-10-14
- New sapi endpoints for wallet.
GET /sapi/v1/capital/config/getall (HMAC SHA256)
: get all coins' information for user.GET /sapi/v1/capital/deposit/hisrec (HMAC SHA256)
: fetch deposit history with network.GET /sapi/v1/capital/deposit/address (HMAC SHA256)
: fetch deposit address with network.