Payments
Agent Fund Balance
Get the current prepaid fund balance for the authenticated agent.
Usage Note
Use this route when the app needs to show the agent's currently available prepaid balance before top-up or payment-related actions.
Get Agent Fund Balance
GET /api/v2/agent/fund-balance
Returns the current prepaid fund balance for the authenticated agent.
Access note
- treat this as a protected route
- the response is scoped to the authenticated agent in the current bearer token context
Response fields
prepaid_balance: the agent's current prepaid balance, formatted as a string with 2 decimal places (e.g., "1,234.56")currency: the currency code for the balance
Success response shape
{
"status_code": 200,
"message": "Success",
"data": {
"prepaid_balance": "1,234.56",
"currency": "USDT"
}
}
Integration notes
prepaid_balanceis display-ready text, not a raw numeric field- if your client needs to do arithmetic, remove formatting separators and parse the value as a decimal first
- if you only need to show the current balance in UI, you can display the value as returned