Skip to main content
You can get a real-time view of funds that can be spent or withdrawn from a Wallet. Balances are separated by currency and network. For example, a wallet may hold USDC on Ethereum and USDC on Solana.

Supported Currencies

View all supported stablecoins and networks

Using the API

Use the Balance API to get real-time information about funds available in a wallet. GET /v2/users/{userId}/wallets/balance
curl -X GET "https://sandbox.hifibridge.com/v2/users/{userId}/wallets/balance?chain=POLYGON&currency=usdc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

The balance API requires specific parameters to retrieve wallet balances:
ParameterTypeRequiredDescriptionAllowed Values
chainstringBlockchain networkPOLYGON, ETHEREUM, SOLANA, BASE
currencystringCurrency typeusdc, usdt, usdHifi

Response Format

The API returns detailed balance information for each token:
{
  "balance": "10000",
  "displayBalance": "0.01",
  "tokenInfo": {
    "chain": "POLYGON_MAINNET",
    "contractAddress": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
    "assetType": "ERC20",
    "quantity": "10000",
    "symbol": "USDC",
    "decimals": 6
  }
}

Balance Information

The balance fields provide both raw and human-readable amounts:
  • balance: Raw balance amount in the token’s smallest unit (e.g., 10000 for 0.01 USDC)
  • displayBalance: Human-readable balance amount formatted for display (e.g., “0.01”)
USDC uses 6 decimal places, so a balance of “10000” represents 0.01 USDC (10000 ÷ 10^6 = 0.01). Always use the displayBalance field for user-facing amounts.

Token Information

The tokenInfo object contains metadata about the token:
  • chain: Blockchain network where the token is held (e.g., “POLYGON_MAINNET”, “ETHEREUM_MAINNET”)
  • contractAddress: Smart contract address of the token on the blockchain
  • assetType: Token standard (ERC20 for Ethereum-based chains, SPL for Solana)
  • quantity: Total token supply (not the user’s balance)
  • symbol: Token symbol (USDC, USDT, etc.)
  • decimals: Number of decimal places used by the token
I