Method Signature
align.blockchain.wallets.getTokenBalance(
address: string,
token: string,
network: Network
): Promise<string>
Parameters
The wallet address to check
Token contract address or known token identifier (usdc, usdt)
Network: ethereum, polygon, base, arbitrum, optimism
Returns
Returns the token balance as a formatted string (e.g., "1000.50" for 1000.50 USDC).
Examples
import Align from "@tolbel/align";
const align = new Align({
apiKey: process.env.ALIGN_API_KEY!,
environment: "sandbox",
});
// Using token identifier
const usdcBalance = await align.blockchain.wallets.getTokenBalance(
"0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42",
"usdc",
"polygon"
);
console.log(`USDC Balance: ${usdcBalance}`);
// USDC Balance: 1500.00
const usdcBalance = await align.blockchain.wallets.getTokenBalance(
"0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42",
"usdc",
"polygon"
);
console.log("USDC:", usdcBalance);
Using Contract Address
// USDC on Polygon
const USDC_POLYGON = "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174";
const balance = await align.blockchain.wallets.getTokenBalance(
address,
USDC_POLYGON,
"polygon"
);
Check Multiple Tokens
const address = "0x...";
const tokens = ["usdc", "usdt"] as const;
for (const token of tokens) {
const balance = await align.blockchain.wallets.getTokenBalance(
address,
token,
"polygon"
);
console.log(`${token.toUpperCase()}: ${balance}`);
}