Token Balances

Description

Returns the token balances for a specific wallet address on Loopring DeFi, including total, locked, and pending amounts per token.

This endpoint is typically used for:

• Fetching wallet balances for a given address

• Monitoring available vs locked assets

• Displaying deposit/withdrawal activity in progress

---

Endpoint

GET /api/v3/user/balances

---

Request

Field	Type	Description	Example
address	string	(Optional) The wallet's public address. address or owner is required.	0xbefa...b491
owner	string	(Optional) The unique ID of the user's Loopring DeFi account. accountId or address is required.	0xbefa...b491

⚠️ Either address or owner must be provided — at least one is required to query token balances.

---

Response

Field	Type	Description	Example
address	string	The contract address of the token or asset.	"0x0000000000000000000000000000000000000000"
value	string	The amount or balance associated with the given token address, typically returned as a string to preserve precision. To display the balance in a readable format, divide it by 10^decimals.	"99476758000000000"

💡 All values are returned in base units. Use token decimals to convert to human-readable values. The decimals value can be retrieved using GET /api/v3/exchange/tokens.