Change Log
2024-11-22
- Update endpoints for Managed Sub-Account:
- GET
/sapi/v1/managed-subaccount/marginAsset
: Add a new request parameter to determine which margin account type is queried. - GET
/sapi/v1/managed-subaccount/fetch-future-asset
: Add a new request parameter to determine which futures account type is queried.
- GET
2024-11-04
- Update endpoints for Sub-Account:
GET /sapi/v1/sub-account/universalTransfer
: The query time period must be less then 7 days. If startTime and endTime not sent, return records of the last 7 days by default.
2024-10-24
- Update endpoints for Sub-Account:
GET /sapi/v4/sub-account/assets
andGET /sapi/v3/sub-account/assets
: Add 2 new asset types to the response.
2024-05-21
- Update endpoints for Sub-Account:
GET /sapi/v1/sub-account/transfer/subUserHistory
: update response fieldfromAccountType
andtoAccountType
. Return USDT_FUTURE/COIN_FUTURE in order to differentiate 2 futures wallets.
2023-06-22
- New endpoints for Sub-Account:
POST /sapi/v1/sub-account/eoptions/enable
: enable Options for Sub-accountGET /sapi/v1/managed-subaccount/query-trans-log
: Query Managed Sub Account Transfer Log (For Trading Team Sub Account)
2023-04-20
- New endpoints for Sub-Account:
GET /sapi/v1/managed-subaccount/deposit/address
: get managed sub-account deposit address
2023-03-23
- Update endpoints for Sub-Account:
GET /sapi/v1/managed-subaccount/queryTransLogForInvestor
: Add response fieldtranId
GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent
: Add response fieldtranId
- New endpoints for Sub-Account:
GET /sapi/v1/managed-subaccount/info
: query investor's managed sub-account listGET /sapi/v1/sub-account/transaction-statistics
: Query sub-account transaction tatistics
2023-02-13
- New endpoints for Sub-Account:
GET /sapi/v4/sub-account/assets
: Fetch sub-account assets
2023-01-13
- The following endpoints will be discontinued on January 13, 2023 6:00 AM UTC:
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 Key
- New endpoints for Sub-Account:
GET /sapi/v1/managed-subaccount/fetch-future-asset
: Investor can use this api to query managed sub account futures asset detailsGET /sapi/v1/managed-subaccount/marginAsset
: Investor can use this api to query managed sub account margin asset details
- New endpoin for Margin:
GET /sapi/v1/margin/crossMarginCollateralRatio
: Get cross margin collateral ratio
2023-01-05
- New endpoints for Sub-Account:
GET /sapi/v1/managed-subaccount/queryTransLogForInvestor
: Investor can use this api to query managed sub account transfer logGET /sapi/v1/managed-subaccount/queryTransLogForTradeParent
: Trading team can use this api to query managed sub account transfer log
2022-11-18
- New endpoints for Sub-account:
POST /sapi/v2/sub-account/subAccountApi/ipRestriction
: To support master account update IP Restriction for Sub-Account API key
2022-09-22
- Update endpoint for Sub-Account:
POST /sapi/v1/sub-account/subAccountApi/ipRestriction
: Add new paramthirdParty
POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
: Add new paramthirdPartyName
DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
: Add new paramthirdPartyName
2022-09-12
- Update endpoint for Sub-account: *
GET /sapi/v1/sub-account/subAccountApi/ipRestriction
: To support master account query Third party IP list name for a sub account API key
2022-06-02
- Update endpoint for Subaccount:
GET /sapi/v1/sub-account/sub/transfer/history
: fromEmail and toEmail can be master email.
2022-3-29
The following updates will take effect on March 31, 2022 08:00 AM UTC
- Update endpoint for Sub-account:
GET /sapi/v1/sub-account/universalTransfer
The query time period must be less then 30 days; If startTime
and endTime
not sent, return records of the last 30 days by default
2022-03-25
- Update endpoint for Sub-Account:
- New endpoint
GET /sapi/v1/managed-subaccount/accountSnapshot
to support investor master account query asset snapshot of managed sub-account
- New endpoint
2022-03-08
- Update endpoint for Sub-Account:
- New transfer types
MARGIN
,ISOLATED_MARGIN
and parametersymbol
added inPOST /sapi/v1/sub-account/universalTransfer
to support transfer to sub-account cross margin account and isolated margin account
- New transfer types
2022-2-18
- Update endpoint for Sub-Account:
- New fields
isManagedSubAccount
andisAssetManagementSubAccount
added inGET /sapi/v1/sub-account/list
to support query whether the sub-account is a managed sub-account or a asset management sub-account
- New fields
2021-12-24
- Update endpoints for Sub-Account:
- New parameter
clientTranId
added inPOST /sapi/v1/sub-account/universalTransfer
andGET /sapi/v1/sub-account/universalTransfer
to support custom transfer id
- New parameter
2021-11-16
- 新增子母账户接口:
POST /sapi/v1/sub-account/subAccountApi/ipRestriction
以支持母账户为子账户 API Key 开启或关闭 IP 白名单POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
以支持母账户为子账户 API Key 添加 IP 白名单地址列表GET /sapi/v1/sub-account/subAccountApi/ipRestriction
以支持母账户为子账户 API Key 查询 IP 白名单DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
以支持母账户为子账户 API Key 删除 IP 白名单地址列表
2021-07-29
- Update endpoint for Sub-Account:
GET /sapi/v1/sub-account/transfer/subUserHistory
ifstartTime
andendTime
are not sent, the recent 30-day data will be returned by default
2021-06-15
- New endpoints for Sub-Account:
POST /sapi/v1/managed-subaccount/deposit
to deposit assets into the managed sub-account (only for investor master account)GET /sapi/v1/managed-subaccount/asset
to query managed sub-account asset details (only for investor master account)POST /sapi/v1/managed-subaccount/withdraw
to withdrawal assets from the managed sub-account (only for investor master account)
2021-04-08
- Update endpoint for Sub-Account:
GET /sapi/v1/sub-account/futures/accountSummary
andGET /sapi/v2/sub-account/futures/accountSummary
the unit of fieldasset
changed to USD valued summary of sub-account assets
2021-04-02
- New endpoint for Sub-Account:
GET /sapi/v3/sub-account/assets
to query sub-account assets
2021-04-01
- Update endpoint for Sub-Account:
GET /sapi/v1/sub-account/transfer/subUserHistory
new fieldsfromAccountType
andtoAccountType
added in response
2021-03-31
- Update endpoint for Sub-Account:
GET /wapi/v3/sub-account/transfer/history.html
added new parametersfromEmail
andtoEmail
, the original parameteremail
is equal tofromEmail
by default
2021-03-08
- New endpoint for Sub-Account:
POST /sapi/v1/sub-account/virtualSubAccount
to support create a virtual sub-accountGET /sapi/v1/sub-account/list
to support query sub-account listPOST /sapi/v1/sub-account/blvt/enable
to support enable blvt for sub-account
2020-12-22
- New endpoint for Sub-Account:
GET /sapi/v1/sub-account/sub/transfer/history
to get spot asset transfer history.
2020-12-02
- New endpoints for Sub-Account:
GET /sapi/v2/sub-account/futures/account
to get detail on sub-account's USDT margined futures account and COIN margined futures account.GET /sapi/v2/sub-account/futures/accountSummary
to get summary of sub-account's USDT margined futures account and COIN margined futures account.GET /sapi/v2/sub-account/futures/positionRisk
to get position risk of sub-account's USDT margined futures account and COIN margined futures account.
2020-11-13
- New endpoints for Sub-Account:
POST /sapi/v1/sub-account/universalTransfer
to transfer spot and futures asset between master account and sub accounts.GET /sapi/v1/sub-account/universalTransfer
to search transfer records.
2020-11-09
- New field
tranId
is available from endpoints:GET /sapi/v1/sub-account/futures/internalTransfer
GET /sapi/v1/sub-account/transfer/subUserHistory
2020-10-10
- New
type
added in the endpointPOST /sapi/v1/sub-account/futures/transfer
to support transfer asset from subaccount's spot account to its COIN-margined futures account and transfer asset from subaccount's COIN-margined futures account to its spot account.
2020-09-03
- New endpoint
POST /sapi/v1/sub-account/futures/internalTransfer
to transfer futures asset between master account and subaccount. - New endpoint
GET /sapi/v1/sub-account/futures/internalTransfer
to get futures transfer history of subaccount.
2020-09-01
- New parameter
masterAccountTotalAsset
added in the endpointGET /sapi/v1/sub-account/spotSummary
to get BTC valued asset summary of master account.
2020-08-27
- New endpoint
GET /sapi/v1/sub-account/spotSummary
to get BTC valued asset summary of subaccout.
2020-02-05
- New sub account endpoints:
POST /sapi/v1/sub-account/futures/transfer
to transfer between futures and spot accout of sub-account.POST /sapi/v1/sub-account/margin/transfer
to transfer between margin and spot accout of sub-account.POST /sapi/v1/sub-account/transfer/subToSub
to transfer to another account by sub-account.POST /sapi/v1/sub-account/transfer/subToMaster
to transfer to same master by sub-account.GET /sapi/v1/sub-account/transfer/subUserHistory
to get transfer history of sub-account.
2019-11-19
GET /sapi/v1/sub-account/margin/account
has new field:marginTradeCoeffVo
which containsforceLiquidationBar
for liquidation margin ratiomarginCallBar
for margin call margin rationormalBar
for initial margin ratio
2019-11-08
- New sapi for subaccount management on margin and futures:
GET /sapi/v1/sub-account/status (HMAC SHA256)
POST /sapi/v1/sub-account/margin/enable (HMAC SHA256)
GET /sapi/v1/sub-account/margin/account (HMAC SHA256)
GET /sapi/v1/sub-account/margin/accountSummary (HMAC SHA256)
POST /sapi/v1/sub-account/futures/enable (HMAC SHA256)
GET /sapi/v1/sub-account/futures/account (HMAC SHA256)
GET /sapi/v1/sub-account/futures/accountSummary (HMAC SHA256)
GET /sapi/v1/sub-account/futures/positionRisk (HMAC SHA256)
2019-11-04
- New sapi endpoints for subaccount wallet.
GET /sapi/v1/capital/deposit/subAddress (HMAC SHA256))
: fetch subaccount deposit address.GET /sapi/v1/capital/deposit/subHisrec (HMAC SHA256))
: fetch subaccount deposit history.