> ## 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 Wallet Balance

> Get the native token balance for a wallet address

## Method Signature

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

## Parameters

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

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

## Returns

Returns the balance as a formatted string (e.g., `"1.5"` for 1.5 ETH/POL).

## 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",
    });

    const balance = await align.blockchain.wallets.getBalance(
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42",
      "polygon"
    );

    console.log(`Balance: ${balance} POL`);
    // Balance: 125.5 POL
    ```
  </Tab>

  <Tab title="JavaScript">
    ```javascript theme={null}
    const balance = await align.blockchain.wallets.getBalance(
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42",
      "polygon"
    );
    console.log("Balance:", balance, "POL");
    ```
  </Tab>
</Tabs>

### Check Multiple Networks

```typescript theme={null}
const address = "0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42";

type NetworkBalance = { network: string; balance: string };

const networks = ["ethereum", "polygon", "base", "arbitrum"] as const;

for (const network of networks) {
  const balance = await align.blockchain.wallets.getBalance(address, network);
  console.log(`${network}: ${balance}`);
}
```

### Check Before Transaction

```typescript theme={null}
const wallet = await align.blockchain.wallets.create();
const balance = await align.blockchain.wallets.getBalance(
  wallet.address,
  "polygon"
);

if (parseFloat(balance) < 0.01) {
  console.error("Insufficient funds for gas fees");
} else {
  // Proceed with transaction
  await align.blockchain.transactions.sendToken(
    wallet,
    "usdc",
    recipient,
    "100",
    "polygon"
  );
}
```

## Related Methods

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

  <Card title="Send Native Token" icon="paper-plane" href="/docs/api/blockchain/wallets/send-native-token">
    Send ETH/POL
  </Card>
</CardGroup>
