Get Wallet Balance

GET/web/v1/wallets/{walletBizId}/balance JWT

Retrieves the balance details for a specific wallet, including available, frozen, and total amounts.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
walletBizId	string	Required	path	Wallet business ID (path parameter)

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "walletBizId": "WLT-001",
    "currency": "USD",
    "availableBalance": 1200,
    "frozenBalance": 300,
    "totalBalance": 1500,
    "updatedAt": "2026-03-21T10:00:00Z"
  }
}

Error Responses

HTTP Status	Code	Description
401	4010	Unauthorized
404	4040	Wallet not found

Notes

• totalBalance = availableBalance + frozenBalance.
• frozenBalance represents amounts held for pending transactions.