GET
/api/v1/balance
Fetch real-time comprehensive wallet financial metrics for the authenticated user, including total wallet balance, referral commissions, held/escrow funds, bonus rewards, and spendable available balance.
Request Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization |
string | Required | Bearer token (e.g. Bearer tente_sk_live_...) |
Sample 200 Success Response
{
"status": 200,
"meaning": "Success",
"message": "Wallet balances retrieved successfully.",
"data": {
"wallet_number": "4810293847",
"balance": 150000.50,
"commission": 12500.00,
"hold_balance": 5000.00,
"bonus": 2500.00,
"available_balance": 145000.50,
"currency": "NGN",
"status": "active"
}
}