跳到主要内容

更新日志

2025-12-26​

时效性通知​

  • 以下有关于REST API变更将在 2026-01-15 07:OO UTC 发生:
    调用需要签名的接口时，请在计算签名之前对 payload 进行百分比编码（percent-encode）。不符合此顺序的请求将被拒绝，并返回错误代码 -1022 签名不正确。请检查并相应地更新您代码中的签名逻辑部分。

REST API​

2025-09-17​

  • 更新 GET /sapi/v1/sub-account/transaction-statistics 接口
  • 支持默认返回母账户的交易信息（不发送email参数）

2025-06-03​

  • 移除 POST /sapi/v1/sub-account/blvt/enable 与 POST /sapi/v1/sub-account/margin/enable 接口。
  • 用户可划入首笔资金开启杠杆帐户。

2025-04-30​

  • 更新子母账户划转接口:POST /sapi/v1/sub-account/universalTransfer 支持ALPHA 划转到 ALPHA (无论母账户或子账户)。

2025-04-08​

  • 更新子母账户接口请求权重(UID):
    • POST /sapi/v1/sub-account/universalTransfer 请求权重(UID)更新為360。

2025-03-26​

  • 新增子母账户移仓接口：
    • POST /sapi/v1/sub-account/futures/move-position: 支持母账户和子账户，子账户和子账户的移仓
    • GET /sapi/v1/sub-account/futures/move-position: 获取账户移仓历史记录

2024-11-22​

  • 更新託管子母账户接口：
    • GET /sapi/v1/managed-subaccount/marginAsset: 添加新的入参判定请求的杠杆帐户类型。
    • GET /sapi/v1/managed-subaccount/fetch-future-asset: 添加新的入参判定请求的期货帐户类型。

2024-11-04​

  • 更新子母账户接口：
    • GET /sapi/v1/sub-account/universalTransfer : 若 startTime 和 endTime 都未传，则只可查询最近7天的记录。查询时间范围最大不得超过7天。

2024-10-24​

  • 更新子母账户接口：
    • GET /sapi/v4/sub-account/assets 及 GET /sapi/v3/sub-account/assets: 新增 2 种资产类型

2024-05-21​

  • 更新子母账户接口：
    • GET /sapi/v1/sub-account/transfer/subUserHistory: 更新返回字段fromAccountType和 toAccountType. 合约钱包划转时返回USDT_FUTURE/COIN_FUTURE以区分钱包

2023-04-20​

  • 新增子母账户接口：
    • GET /sapi/v1/managed-subaccount/deposit/address：支持获取投资人之托管子账户充值地址

2023-03-23​

  • 更新子母账户接口:
    • GET /sapi/v1/managed-subaccount/queryTransLogForInvestor: 响应出参增加字段tranId
    • GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent: 响应出参增加字段tranId
  • 添加子母账户接口:
    • GET /sapi/v1/managed-subaccount/info: 查询托管子账户列表
    • GET /sapi/v1/sub-account/transaction-statistics: 查询子账户交易量统计列表

2023-02-13​

  • 添加子母账户接口:
    • GET /sapi/v4/sub-account/assets: 查询子账户资产

2023-01-13​

  • 以下接口将于 1 月 13, 2023 6:00 AM UTC 停止使用：
    • POST /sapi/v1/sub-account/subAccountApi/ipRestriction 以支持母账户为子账户 API Key 开启或关闭 IP 白名单
    • POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList 以支持母账户为子账户 API Key 添加 IP 白名单地址列表
  • 添加子母账户接口：
    • 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

2023-01-05​

  • 添加子母账户接口:
    • GET /sapi/v1/managed-subaccount/queryTransLogForInvestor: 投资人可以根据此接口查询其托管子账户划转记录
    • GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent: 交易团队可以根据此接口查询其托管子账户划转记录

2022-11-18​

  • 新增子母账户接口:
    • POST /sapi/v2/sub-account/subAccountApi/ipRestriction: 为子账户 API Key 更新 IP 白名单

2022-09-22​

  • 更新子母账户接口：
    • POST /sapi/v1/sub-account/subAccountApi/ipRestriction：添加一个新的参数 thirdParty
    • POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList：添加一个新的参数 thirdPartyName
    • DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList：添加一个新的参数 thirdPartyName

2022-09-12​

  • 更新子母账户接口： * GET /sapi/v1/sub-account/subAccountApi/ipRestriction： 以支持母账户为子账户 API Key 查询三方 IP 白名单

2022-06-02​

  • 更新子母账户接口:
    • GET /sapi/v1/sub-account/sub/transfer/history：fromEmail 及 toEmail 可以是母账户 email。

2022-3-29​

以下更新于3 月 31, 2022 08:00 AM UTC生效

  • 更新子母账户接口：
    • GET /sapi/v1/sub-account/universalTransfer

接口查询时间窗口缩短为 30 天；若startTime和endTime没传，则默认返回最近 30 天数据。

2022-03-25​

  • 更新子母账户接口:
    • 新增接口 GET /sapi/v1/managed-subaccount/accountSnapshot以支持投资人母账户查询托管子账户资产快照

2022-03-08​

  • 更新子母账户接口:
    • 新增划转类型MARGIN ,ISOLATED_MARGIN 以及传参symbol于子母账户万能划转接口POST /sapi/v1/sub-account/universalTransfer 以支持母账户现货账户划转到子账户杠杆全仓账户和杠杆逐仓账户

2022-2-18​

  • 更新子母账户接口:
    • 新增响应参数 isManagedSubAccount和 isAssetManagementSubAccount 于接口 GET /sapi/v1/sub-account/list 以支持查询子账户是否是托管子账户或资产管理子账户

2021-12-24​

  • 更新子母账户接口:
    • 新增传参clientTranId于子母账户万能划转接口POST /sapi/v1/sub-account/universalTransfer 和查询子母账户万能划转历史接口 GET /sapi/v1/sub-account/universalTransfer 以支持用户自定义划转 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​

  • 子母账户接口更新:
    • GET /sapi/v1/sub-account/transfer/subUserHistory 如果startTime和endTime均未发送，默认只返回最近 30 天数据

2021-06-15​

  • 新增子母账户接口:
    • POST /sapi/v1/managed-subaccount/deposit 以支持投资人账户为托管子账户充值资产（仅投资人账户方使用）
    • GET /sapi/v1/managed-subaccount/asset 以支持投资人账户查询托管子账户资产（仅投资人账户方使用）
    • POST /sapi/v1/managed-subaccount/withdraw以支持投资人账户为托管子账户提币资产（仅投资人账户方使用）

2021-04-08​

  • 子母账户接口更新:
    • GET /sapi/v1/sub-account/futures/accountSummary 和 GET /sapi/v2/sub-account/futures/accountSummary 接口返回字段asset 更新为以 USD 计价的资产汇总，即子账户 USDT，BUSD 等保证金总和

2021-04-01​

  • 子母账户接口更新:
    • GET /sapi/v1/sub-account/transfer/subUserHistory 新增返回字段 fromAccountType 和 toAccountType为用户转出账户类型和转入账户类型

2021-03-31​

  • 子母账户接口更新:
    • GET /wapi/v3/sub-account/transfer/history.html 新增参数 fromEmail 和 toEmail，原有参数email 将默认查询fromEmail的记录

2021-03-08​

  • 新增子母账户接口：
    • POST /sapi/v1/sub-account/virtualSubAccount 以支持母账户创建虚拟子账户
    • GET /sapi/v1/sub-account/list 以支持查询子账户列表
    • POST /sapi/v1/sub-account/blvt/enable 以支持为子账户开通杠杆代币

2020-12-22​

  • 新增子母账户接口:
    • GET /sapi/v1/sub-account/sub/transfer/history 以支持查询子母账户现货资金划转历史。

2020-12-02​

  • 新增子母账户接口:
    • GET /sapi/v2/sub-account/futures/account 以支持查询子账户 USDT 合约和币本位合约账户详情。
    • GET /sapi/v2/sub-account/futures/accountSummary 以支持查询子账户 USDT 合约和币本位合约账户汇总。
    • GET /sapi/v2/sub-account/futures/positionRisk 以支持查询子账户 USDT 合约和币本位合约持仓信息。

2020-11-13​

  • 新增子母账户接口:
    • POST /sapi/v1/sub-account/universalTransfer 以支持子母账户，现货和合约账户之间相互划转。
    • GET /sapi/v1/sub-account/universalTransfer 以查询划转记录。

2020-11-09​

  • 新增返回字段 tranId 于子母账户接口:
    • GET /sapi/v1/sub-account/futures/internalTransfer
    • GET /sapi/v1/sub-account/transfer/subUserHistory

2020-10-10​

  • 子母账户接口POST /sapi/v1/sub-account/futures/transfer新增划转类型type 以支持子账户现货账户和币本位合约账户间相互划转。

2020-09-03​

  • 新增子母账户接口POST /sapi/v1/sub-account/futures/internalTransfer 以执行子账户合约资金直接划转。
  • 新增子母账户接口GET /sapi/v1/sub-account/futures/internalTransfer 以查询子账户合约资金直接划转历史。

2020-09-01​

  • 子母账户接口GET /sapi/v1/sub-account/spotSummary 返回内容中新增字段 masterAccountTotalAsset以获取 BTC 计价的母账户资产。

2020-08-27​

  • 新增接口 GET /sapi/v1/sub-account/spotSummary 以获取 BTC 计价的子账户现货资产汇总。

2020-02-05​

  • 新增子账户相关接口:
    • POST /sapi/v1/sub-account/futures/transfer: 对子账户实施 futures 账户划转
    • POST /sapi/v1/sub-account/margin/transfer: 对子账户实施 margin 账户划转
    • POST /sapi/v1/sub-account/transfer/subToSub: 向兄弟子账户划转
    • POST /sapi/v1/sub-account/transfer/subToMaster: 向母账户划转
    • GET /sapi/v1/sub-account/transfer/subUserHistory: 子账户获取自身划转历史

2019-11-08​

  • 新增以下 sapi 接口用以管理子账户的杠杆与期货：
    • 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​

  • 新增管理子账户充值功能相关的 sapi 接口
    • GET /sapi/v1/capital/deposit/subAddress (HMAC SHA256)): 获取子账户充值地址。
    • GET /sapi/v1/capital/deposit/subHisrec (HMAC SHA256)): 获取子账户充值记录。

2019-11-19​

  • GET /sapi/v1/sub-account/margin/account 返回内容新增: marginTradeCoeffVo 其中包括
    • forceLiquidationBar: 强平风险率;
    • marginCallBar: 补仓风险率;
    • normalBar: 初始风险率