查询资产变化记录

查询资产历史变化记录

查询用户资产的历史变化记录。

HTTP 请求

GET

/api/perp-trade-api/history/balance-changes

请求频率限制:

• 建议不超过 10 次/秒

认证要求:

• 需要 JWT Token
• 需要 X-Wallet-Address 请求头

请求头

名称	类型	必填	描述
Authorization	string	是	JWT Token，格式：Bearer {token}
X-Wallet-Address	string	是	钱包地址

请求参数

名称	类型	必填	描述
pageNum	integer	否	页码，默认为 1
pageSize	integer	否	每页大小，默认为 20
beginTime	long	否	开始时间（毫秒），默认 90 天前

响应字段说明

返回分页响应，包含：

名称	类型	描述
total	long	总记录数
pageNum	integer	当前页码
pageSize	integer	每页大小
list	array	变化记录列表

每个变化记录包含：

名称	类型	描述
account	string	用户地址
txDigest	string	交易哈希
txIndex	long	交易索引
bizType	integer	业务类型
bizTypeDesc	string	业务类型描述
settlementAmount	decimal	结算金额
createdTime	long	创建时间（毫秒）

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 200,
    "pageNum": 1,
    "pageSize": 20,
    "list": [
      {
        "account": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
        "txDigest": "0xabc123...",
        "txIndex": 0,
        "bizType": 1,
        "bizTypeDesc": "交易",
        "settlementAmount": 100.5,
        "createdTime": 1700000000000
      }
    ]
  }
}