用户钱包历史

GET🔒 Read

⚡ Query: 15 req/s per endpoint · 30 req/s per user

提示

立即试用 — 在 API 浏览器中测试此端点

查询钱包历史记录。需要 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。

请求参数

名称	类型	是否必填	描述
walletType	Object	否
walletName	String	否	逐仓钱包的名称。当 walletType 为 ISOLATED 时为必填项
asset	String	否	资产。当 walletType=SPOT 时为必填项。
historyTypes	Object[]	否	指定查询的历史类型
startTime	Double	否	起始时间（包含）。
endTime	Double	否	结束时间（不包含）。
pageSize	Double	否	分页每页大小
currentPage	Double	否	分页当前页码

响应内容

名称	类型	描述
data	Object[]

example

GEThttps://api.btse.com/public-api/wallet/v1/user/walletHistory

Response (Deposit (crypto))

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1624989977940,
  "data": [
    {
      "transactionTime": 1678445104907,
      "type": "DEPOSIT",
      "walletName": "SPOT@",
      "asset": "ETH",
      "netAmount": "0.05",
      "amount": "0.05",
      "transactionRef": "2023031000000321",
      "status": "COMPLETED",
      "description": null,
      "fee": "0",
      "cryptoNetwork": "ETHEREUM",
      "toAddress": "0xF14BAc881e719934CEFccD1AC5dC5f814dfbCbF8",
      "confirmTimes": "(10/10)",
      "txId": "0x94ead563799ee341cb136c18dc9a71a231abaec820caa18c096febbe92da8709"
    }
  ]
}

Response (Withdraw (crypto))

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1624989977940,
  "data": [
    {
      "transactionTime": 1678957494276,
      "type": "WITHDRAW",
      "walletName": "SPOT@",
      "asset": "USDT",
      "netAmount": "-30",
      "amount": "-30",
      "transactionRef": "2023031600000374",
      "status": "COMPLETED",
      "description": null,
      "fee": "6.429",
      "cryptoNetwork": "ERC20",
      "toAddress": "0xF14BAc881e719934CEFccD1AC5dC5f814dfbCbF8",
      "confirmTimes": "(15/15)",
      "txId": "0x0a8487a85f37d4995716419d7d7d7048c9625fab8cae69c235103a39ea789377"
    }
  ]
}

Response (Send To)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1624989977940,
  "data": [
    {
      "transactionTime": 1679619604907,
      "type": "SEND",
      "walletName": "SPOT@",
      "asset": "USDT",
      "netAmount": "-1",
      "amount": "-1",
      "transactionRef": "2023024000000034",
      "status": "COMPLETED",
      "description": null,
      "fee": "0",
      "cryptoNetwork": null,
      "confirmTimes": null,
      "txId": null
    }
  ]
}

Response (Others)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1767580139575,
  "data": [
    {
      "transactionTime": 1767580126422,
      "type": "TRANSFER_OUT",
      "walletName": "VIRTUAL|4@BTCPFC-USDT#1",
      "asset": "USDT",
      "netAmount": "-1.00950715",
      "amount": "-1.00950715",
      "transactionRef": "e6d252e8-eb64-48cd-81f0-e35ab453059d",
      "status": "COMPLETED",
      "description": "VIRTUAL|4@BTC-PERP-USD#1->CROSS@;CLOSE",
      "fee": "0",
      "cryptoNetwork": null,
      "toAddress": null,
      "confirmTimes": null,
      "txId": null
    },
    {
      "transactionTime": 1767580126418,
      "type": "REALIZED_PNL",
      "walletName": "VIRTUAL|4@BTCPFC-USDT#1",
      "asset": "USDT",
      "netAmount": "-0.00019329",
      "amount": "-0.00019329",
      "transactionRef": "69491374-0a01-4341-92ed-5212eb36b0ff",
      "status": "COMPLETED",
      "description": "VIRTUAL|4@BTC-PERP-USD#1;TRADE",
      "fee": "0",
      "cryptoNetwork": null,
      "toAddress": null,
      "confirmTimes": null,
      "txId": null
    },
    {
      "transactionTime": 1767578949884,
      "type": "TRANSFER_IN",
      "walletName": "VIRTUAL|4@BTCPFC-USDT#1",
      "asset": "USDT",
      "netAmount": "1",
      "amount": "1",
      "transactionRef": "1732d021-75dc-43cc-86b6-ebc767dd0969",
      "status": "COMPLETED",
      "description": "CROSS@->VIRTUAL|4@BTC-PERP-USD#1;TRANSFER",
      "fee": "0",
      "cryptoNetwork": null,
      "toAddress": null,
      "confirmTimes": null,
      "txId": null
    }
  ]
}