Balance Changes

Query Balance Change History

Query user's asset change history records.

HTTP Request

GET

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

Request Frequency Restriction:

• Recommended: no more than 10 times per second

Authentication Required:

• JWT Token required
• X-Wallet-Address header required

Request Headers

Name	Type	Required	Description
Authorization	string	Yes	JWT Token, format: Bearer {token}
X-Wallet-Address	string	Yes	Wallet address

Request Parameters

Name	Type	Required	Description
pageNum	integer	No	Page number, default is 1
pageSize	integer	No	Page size, default is 20
beginTime	long	No	Start time (milliseconds), default is 90 days ago

Response Fields Description

Returns paginated response, containing:

Name	Type	Description
total	long	Total number of records
pageNum	integer	Current page number
pageSize	integer	Page size
list	array	Change record list

Each change record contains:

Name	Type	Description
account	string	User address
txDigest	string	Transaction hash
txIndex	long	Transaction index
bizType	integer	Business type
bizTypeDesc	string	Business type description
settlementAmount	decimal	Settlement amount
createdTime	long	Creation time (milliseconds)

Response Example

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