Skip to main content

Change Log

2025-09-17​

  • Update GET /sapi/v1/sub-account/transaction-statistics endpoints.
  • Supports returning the transaction information of the master account by default (without sending the email parameter)

2025-06-03​

  • Remove POST /sapi/v1/sub-account/blvt/enable and POST /sapi/v1/sub-account/margin/enable endpoints.
  • User now should make the initial transfer in the Margin account to enable it.

2025-04-30​

  • Update universal transfer endpoints for Sub-Account: POST /sapi/v1/sub-account/universalTransfer to accept 'ALPHA' to 'ALPHA' transfer.

2025-04-08​

  • Update the weight of endpoints for Sub-Account:
    • The UID request weight of POST /sapi/v1/sub-account/universalTransfer is 360.

2025-03-26​

    • New endpoints for Sub-Account to support move position function：
    • POST /sapi/v1/sub-account/futures/move-position: Move position between sub-master, master-sub, or sub-sub accounts
    • GET /sapi/v1/sub-account/futures/move-position: Query move position history

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.

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 and GET /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 field fromAccountType and toAccountType. 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-account
    • GET /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 field tranId
    • GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent: Add response field tranId
  • New endpoints for Sub-Account:
    • GET /sapi/v1/managed-subaccount/info: query investor's managed sub-account list
    • GET /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 Key
    • POST /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 details
    • GET /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 log
    • GET /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 param thirdParty
    • POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList: Add new param thirdPartyName
    • DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList: Add new param thirdPartyName

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 endpointGET /sapi/v1/managed-subaccount/accountSnapshot to support investor master account query asset snapshot of managed sub-account

2022-03-08​

  • Update endpoint for Sub-Account:
    • New transfer typesMARGIN,ISOLATED_MARGIN and parametersymboladded inPOST /sapi/v1/sub-account/universalTransfer to support transfer to sub-account cross margin account and isolated margin account

2022-2-18​

  • Update endpoint for Sub-Account:
    • New fields isManagedSubAccountand isAssetManagementSubAccount added inGET /sapi/v1/sub-account/listto support query whether the sub-account is a managed sub-account or a asset management sub-account

2021-12-24​

  • Update endpoints for Sub-Account:
    • New parameterclientTranIdadded inPOST /sapi/v1/sub-account/universalTransfer and GET /sapi/v1/sub-account/universalTransfer to support custom transfer id

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 if startTimeandendTimeare 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 and GET /sapi/v2/sub-account/futures/accountSummary the unit of field asset 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 fields fromAccountType and toAccountType added in response

2021-03-31​

  • Update endpoint for Sub-Account:
    • GET /wapi/v3/sub-account/transfer/history.html added new parameters fromEmail and toEmail, the original parameteremail is equal tofromEmailby default

2021-03-08​

  • New endpoint for Sub-Account:
    • POST /sapi/v1/sub-account/virtualSubAccount to support create a virtual sub-account
    • GET /sapi/v1/sub-account/list to support query sub-account list
    • POST /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 endpoint POST /sapi/v1/sub-account/futures/transferto 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 endpointGET /sapi/v1/sub-account/futures/internalTransfer to get futures transfer history of subaccount.

2020-09-01​

  • New parameter masterAccountTotalAsset added in the endpoint GET /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 contains
    • forceLiquidationBar for liquidation margin ratio
    • marginCallBar for margin call margin ratio
    • normalBar 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.