Get Aggregated USDT, USDC, And Native Balances For All User Wallets

curl --request GET \
  --url https://crypto.westminister.tech/api/v1/auth/balances/user/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "user_id": "5c81c005-1c52-4e0d-85e2-862ee1cdd4d0",
  "total_usdt": "977.00000000",
  "total_usdc": "125.50000000",
  "balances": [
    {
      "wallet_id": "fae48f4b-9aa3-44db-9011-c4f6b91aeb0e",
      "wallet_address": "TAVFvX9tToo1UJ2h7j47jVkgQjZa8LarY8",
      "network": "tron",
      "usdt_balance": "977.00000000",
      "usdc_balance": "125.50000000",
      "native_balance": "1993.89360000",
      "last_synced": "2026-01-16T09:15:30Z",
      "is_cached": true
    },
    {
      "wallet_id": "de755c09-27e0-41cd-a791-41c5c858459c",
      "wallet_address": "0x17F4552b0c47F24F88B9569E6305413c5ff5370d",
      "network": "ethereum",
      "usdt_balance": "0.00000000",
      "usdc_balance": "0.00000000",
      "native_balance": "0.00000000",
      "last_synced": "2026-01-16T09:15:30Z",
      "is_cached": true
    }
  ],
  "synced_at": "2026-01-16T09:20:58Z"
}

Wallets-Users

Get Aggregated USDT, USDC, And Native Balances For All User Wallets

Returns aggregated USDT, USDC, and native balances (TRX/ETH) per wallet for the user. Custodial wallets provisioned by POST /wallets or POST /wallets/for-owner include USDT and USDC ledger rows on the wallet network. This summary endpoint now exposes both stablecoins through total_usdt, total_usdc, usdt_balance, and usdc_balance. Supports network filtering and optional force refresh from blockchain.

Balance Sources:

By default, it returns cached balances from database
If refresh=true, it fetches directly from blockchain
If balance is not in the DB, it automatically fetches from blockchain as fallback

Network Filtering:

Use networks parameter to filter by specific blockchain networks
Supports: tron, ethereum, or tron,ethereum
If omitted, returns balances for all networks

Response Fields:

total_usdt: Sum of all USDT balances across all wallets
total_usdc: Sum of all USDC balances across all wallets
balances[]: Per-wallet USDT, USDC, and native (TRX/ETH) amounts
is_cached: Indicates if balance came from DB cache or blockchain
last_synced: Timestamp when balance was last updated in DB

GET

api

auth

balances

user

{user_id}

Get Aggregated USDT, USDC, And Native Balances For All User Wallets

curl --request GET \
  --url https://crypto.westminister.tech/api/v1/auth/balances/user/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "user_id": "5c81c005-1c52-4e0d-85e2-862ee1cdd4d0",
  "total_usdt": "977.00000000",
  "total_usdc": "125.50000000",
  "balances": [
    {
      "wallet_id": "fae48f4b-9aa3-44db-9011-c4f6b91aeb0e",
      "wallet_address": "TAVFvX9tToo1UJ2h7j47jVkgQjZa8LarY8",
      "network": "tron",
      "usdt_balance": "977.00000000",
      "usdc_balance": "125.50000000",
      "native_balance": "1993.89360000",
      "last_synced": "2026-01-16T09:15:30Z",
      "is_cached": true
    },
    {
      "wallet_id": "de755c09-27e0-41cd-a791-41c5c858459c",
      "wallet_address": "0x17F4552b0c47F24F88B9569E6305413c5ff5370d",
      "network": "ethereum",
      "usdt_balance": "0.00000000",
      "usdc_balance": "0.00000000",
      "native_balance": "0.00000000",
      "last_synced": "2026-01-16T09:15:30Z",
      "is_cached": true
    }
  ],
  "synced_at": "2026-01-16T09:20:58Z"
}

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

Show child attributes

synced_at

string<date-time>

Timestamp when this response was generated

Example:

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

Update Wallet Active Status List Master Merchants (Vendors)