跳到主要内容

用户钱包历史

GET 
/public-api/wallet/v1/user/walletHistory

查询钱包历史记录。需要 Read 权限。

查询参数规则：

  • 建议在查询中包含 walletType。如果未提供，默认仅查询现货钱包历史。
  • 当 walletType 为 ISOLATED 时，walletName 为必填项。
  • 仅升级后的钱包支持使用 walletType=UNIFIED 查询钱包历史。
  • historyTypes 应编码为 JSON 数组格式。
  • 若未设置 startTime 和 endTime，默认获取过去 7 天的数据。
  • startTime 和 endTime 必须在过去 120 天的范围内。
  • 如果您的合约钱包已升级，请使用 walletType=UNIFIED 查询合约钱包历史以获取升级后的记录。
  • 设置 walletType=CROSS 或 walletType=ISOLATED 查询钱包历史仅返回合约钱包升级前的记录。

例如，

// 查询过去 7 天的现货钱包历史。
.../public-api/wallet/v1/user/walletHistory?walletType=SPOT
// 查询过去 7 天的现货充值和提现历史。
.../public-api/wallet/v1/user/walletHistory?walletType=SPOT&historyTypes=["DEPOSIT","WITHDRAW"]
// 查询 2023-01-01 至 2023-03-31 的现货充值和提现历史。
.../public-api/wallet/v1/user/walletHistory?walletType=SPOT&historyTypes=["DEPOSIT","WITHDRAW"]&startTime=1672531200000&endTime=1680307200000
// 查询过去 7 天的 BTC-PERP 逐仓钱包历史。
.../public-api/wallet/v1/user/walletHistory?walletType=ISOLATED&walletName=ISOLATED@BTC-PERP-USDT

涉及区块链交易的详情将显示 cryptoNetwork，交易完成后将显示 txId。

请求​

响应​

成功响应