Get wallet balance

GET/api/v1/wallets/{walletBizId}/balanceHMAC

Returns the current balance information for a specific wallet.

Headers

Name	Type	Required	Description
X-Api-Key	string	required	API key identifier
X-Signature	string	required	HMAC-SHA256 signature
X-Timestamp	string	required	Unix timestamp in seconds
X-Nonce	string	required	Unique request identifier (UUID)

Path Parameters

Name	Type	Required	Description
walletBizId	string	required	Wallet business ID

Request Example

curl -X GET https://api.lampay.app/api/v1/wallets/<walletBizId>/balance \
  -H "X-Api-Key: sk_live_xxx" \
  -H "X-Signature: <computed_signature>" \
  -H "X-Timestamp: 1709337600" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000"

Response

200Success

{
  "version": "1.3.0",
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "walletBizId": "wlt_abc123",
    "currency": "USD",
    "availableBalance": 1300.25,
    "frozenBalance": 200,
    "totalBalance": 1500.25,
    "updatedAt": "2026-03-02T10:20:30Z"
  }
}