# Balances

Fetch token balances for the connected wallet with optional filtering.

```ts title="Pure JS"
import { mega } from '@megaeth-labs/wallet-sdk';

// Omit tokens to get every token the account holds.
const balances = await mega.balances({ tokens: ['0x2715b6d04b6a0AB227631019899282a585Be410F'] });

for (const token of balances) {
    console.log(token.symbol, token.displayBalance);
}
```

```tsx title="React"
import { useBalances } from '@megaeth-labs/wallet-sdk-react';

export default function Balances() {
    const { data: balances, isLoading } = useBalances();

    if (isLoading) return <p>Loading…</p>;

    return (
        <ul>
            {balances?.map((token) => (
                <li key={token.address}>
                    {token.displayBalance} {token.symbol}
                </li>
            ))}
        </ul>
    );
}
```

```tsx title="Wagmi"
import type { MegaWalletProvider } from '@megaeth-labs/wallet-wagmi-connector';
import { useQuery } from '@tanstack/react-query';
import { useAccount } from 'wagmi';

export default function Balances() {
    const { address, connector } = useAccount();

    const { data: balances, isLoading } = useQuery({
        queryKey: ['balances', address],
        enabled: !!connector,
        queryFn: async () => {
            const provider = (await connector?.getProvider()) as MegaWalletProvider;
            return provider.balances();
        },
    });

    if (isLoading) return <p>Loading…</p>;

    return (
        <ul>
            {balances?.map((token) => (
                <li key={token.address}>
                    {token.displayBalance} {token.symbol}
                </li>
            ))}
        </ul>
    );
}
```

```ts
interface BalancesRequest {
    tokens?: string[];
}

// Resolves to one entry per token
interface OwnedTokenResponse {
    name: string;
    symbol: string;
    decimals: number;
    address: string;
    image?: string;
    balance: string;
    displayBalance: string;
    usdPrice?: string;
    usdBalance?: string;
}
```
