> ## Documentation Index
> Fetch the complete documentation index at: https://align.tolbel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Token Balance

> Get the ERC-20 token balance for a wallet address

## Method Signature

```typescript theme={null}
align.blockchain.wallets.getTokenBalance(
  address: string,
  token: string,
  network: Network
): Promise<string>
```

## Parameters

<ParamField body="address" type="string" required>
  The wallet address to check
</ParamField>

<ParamField body="token" type="string" required>
  Token contract address or known token identifier (`usdc`, `usdt`)
</ParamField>

<ParamField body="network" type="string" required>
  Network: `ethereum`, `polygon`, `base`, `arbitrum`, `optimism`
</ParamField>

## Returns

Returns the token balance as a formatted string (e.g., `"1000.50"` for 1000.50 USDC).

## Examples

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={null}
    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
    ```
  </Tab>

  <Tab title="JavaScript">
    ```javascript theme={null}
    const usdcBalance = await align.blockchain.wallets.getTokenBalance(
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42",
      "usdc",
      "polygon"
    );
    console.log("USDC:", usdcBalance);
    ```
  </Tab>
</Tabs>

### Using Contract Address

```typescript theme={null}
// USDC on Polygon
const USDC_POLYGON = "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174";

const balance = await align.blockchain.wallets.getTokenBalance(
  address,
  USDC_POLYGON,
  "polygon"
);
```

### Check Multiple Tokens

```typescript theme={null}
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}`);
}
```

## Related Methods

<CardGroup cols={2}>
  <Card title="Get Wallet Balance" icon="coins" href="/docs/api/blockchain/wallets/get-balance">
    Get native token balance
  </Card>

  <Card title="Send Token" icon="paper-plane" href="/docs/api/blockchain/wallets/send-token">
    Transfer ERC-20 tokens
  </Card>
</CardGroup>