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
Query Parameters
The balance API requires specific parameters to retrieve wallet balances:Parameter | Type | Required | Description | Allowed Values |
---|---|---|---|---|
chain | string | ✅ | Blockchain network | POLYGON , ETHEREUM , SOLANA , BASE |
currency | string | ✅ | Currency type | usdc , usdt , usdHifi |
Response Format
The API returns detailed balance information for each token: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”)
Understanding Token Decimals
Understanding Token Decimals
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
ThetokenInfo
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