Skip to main content
GET
/
v2
/
users
/
{userId}
/
wallets
/
balance
Retrieve wallet balance
curl --request GET \
  --url https://production.hifibridge.com/v2/users/{userId}/wallets/balance \
  --header 'Authorization: Bearer <token>'
{
  "balance": "0",
  "displayBalance": "0",
  "tokenInfo": {
    "tokenAddress": "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582",
    "standard": "ERC20",
    "name": "USDC",
    "symbol": "USDC",
    "decimals": 6
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
userId
string
required

ID of the user

Query Parameters

​
chain
enum<string>
required

The blockchain network to retrieve the wallet balance from.

Available options:
POLYGON,
ETHEREUM,
SOLANA,
BASE
​
currency
enum<string>
required

The type of currency to check the balance for. Currently, only usdc is supported.

Available options:
usdc,
usdt,
usdHifi

Response

Success

​
balance
string

The raw balance of the wallet expressed in the smallest denomination of the token. This format is ideal for backend calculations, automation processes, or when precise, unrounded figures are necessary for smart contract interactions. For example, use this when calculating transaction fees or performing token transfer operations that require exact values.

​
displayBalance
string

The wallet balance formatted as a decimal string for display purposes, adjusted according to the token's decimal places to facilitate human readability. This format is best used in user interfaces where balances are displayed to end-users, such as in wallet apps or dashboards, where readability and familiarity are crucial. For instance, displaying an account balance on a user's home screen or summary page.

​
tokenInfo
object

Detailed information about the token.