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_balance is 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
Copyright © 2026