Skip to main content
GET
Get Aggregated USDT, USDC, And Native Balances For All User Wallets

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string<uuid>
required

User ID to fetch balances for

Query Parameters

networks
string

Comma-separated list of networks to filter by (tron, ethereum). If omitted, returns all networks.

refresh
enum<string>

Force refresh from blockchain. If true, fetches directly from blockchain instead of using DB cache.

Available options:
true,
false
include_pending
enum<string>

Include pending transactions (reserved for future use)

Available options:
true,
false

Response

Balances retrieved successfully

user_id
string<uuid>

User ID

Example:

"5c81c005-1c52-4e0d-85e2-862ee1cdd4d0"

total_usdt
string

Aggregated USDT balance across all wallets

Example:

"977.00000000"

total_usdc
string

Aggregated USDC balance across all wallets

Example:

"125.50000000"

balances
object[]

Array of wallet balances

synced_at
string<date-time>

Timestamp when this response was generated

Example:

"2026-01-16T09:20:58Z"