Account Info

Query Account Information

Query user's account information, including balance, margin, account value, etc.

HTTP Request

GET

/api/perp-trade-api/curr-info/account

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

No parameters required

Response Fields Description

Name	Type	Description
address	string	Address
canTrade	boolean	Whether trading is allowed
updateTime	long	Update time (milliseconds)
feeTier	string	Fee tier
walletBalance	string	Wallet balance
totalPositionMargin	string	Total position margin
totalUnrealizedProfit	string	Total unrealized profit/loss
freeCollateral	string	Free collateral
accountValue	string	Account value
accountDataByMarket	array	Account data by market

Each market account data contains:

Name	Type	Description
symbol	string	Trading pair
...	...	Other market-related data

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "address": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
    "canTrade": true,
    "updateTime": 1700000000000,
    "feeTier": "1",
    "walletBalance": "10000",
    "totalPositionMargin": "500",
    "totalUnrealizedProfit": "5",
    "freeCollateral": "9505",
    "accountValue": "10005",
    "accountDataByMarket": [
      {
        "symbol": "ETH-PERP",
        ...
      }
    ]
  }
}