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

# Fetch Token Balances

<Card title="Recommended: JavaScript SDK with React Hooks" icon="react" color="#4779FE">
  For new React apps, we recommend the JavaScript SDK with React Hooks (`@dynamic-labs-sdk/react-hooks`) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the [React quickstart (JavaScript SDK)](/javascript/reference/react-quickstart) to get started.
</Card>

<Note>
  Token balance are currently supported on: Ethereum, Worldchain, Shape, Zksync, Optimism, Polygon, Geist, Arbitrum, Blast, Linea, Base, Scroll, Gnosis, BNB, Avalanche, Apechain, Lens, Soneium, Rootstock, Abstract, Settlus, Ink, Solana, Bitcoin runes.

  Dynamic supports fetching the top 3000 tokens by market cap.
</Note>

<Tip>The Dynamic UI components (DynamicWidget and UserProfile) have a built in UI for displaying multi asset balances, we strongly recommend using those components if you can! Learn more in [the Multi-Asset UI section](/react/wallets/using-wallets/general/multi-asset).</Tip>

## Hook

You can fetch token balances for a user's wallet using the `useTokenBalances` hook:

```tsx React theme={"system"}
import { useTokenBalances } from "@dynamic-labs/sdk-react-core";

const { tokenBalances, isLoading, isError, error } = useTokenBalances();
```

## Return Value

This hook returns an object for `tokenBalances` with the following properties:

| Property         | Type    | Description                                                                                                                                                                                           |
| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| networkId        | integer | The network ID of the token i.e. 1 for Ethereum, 137 for Polygon, etc.                                                                                                                                |
| address          | string  | The address of the token.                                                                                                                                                                             |
| name             | string  | The name of the token.                                                                                                                                                                                |
| symbol           | string  | The symbol of the token.                                                                                                                                                                              |
| decimals         | integer | The number of decimals the token has.                                                                                                                                                                 |
| logoURI          | string  | The URI of the token's logo image.                                                                                                                                                                    |
| balance          | float   | The balance of the token in the user's wallet.                                                                                                                                                        |
| rawBalance       | integer | The raw balance of the token in the user's wallet.                                                                                                                                                    |
| rawBalanceString | string  | The raw balance encoded as a base-10 string. Use this when the balance exceeds `Number.MAX_SAFE_INTEGER` (>= 2^53) to avoid precision loss — e.g. for high-decimal tokens or pre-divisor wei amounts. |

## Reference

You can find the full reference for the `useTokenBalances` hook [here](/react/reference/hooks/usetokenbalances).

<Note>
  On chains that distinguish a public balance from a private (shielded) one — Aleo today — use the [`usePrivateTokenBalances`](/react/reference/hooks/useprivatetokenbalances) hook to render the private balances. It mirrors `useTokenBalances` and can be called alongside it.
</Note>

## Full Example

```tsx React theme={"system"}
import { useDynamicContext, useTokenBalances } from "@dynamic-labs/sdk-react-core";

const Balances = () => {
  const { primaryWallet } = useDynamicContext();
  const { tokenBalances, isLoading, isError, error } = useTokenBalances();

  if(!primaryWallet) return <div>No wallet connected</div>;

  if (isLoading) return <div>Loading...</div>;
  if (isError) return <div>Error: {error.message}</div>;

  return (
    <div>
      {tokenBalances.map((token) => (
        <div key={token.address}>
          <img src={token.logoURI} alt={token.symbol} />
          <div>{token.name}</div>
          <div>{token.symbol}</div>
          <div>{token.balance}</div>
        </div>
      ))}
    </div>
  );
};
```

<Info>
  Using the JavaScript SDK? See [Getting Multichain Token Balances](/javascript/reference/wallets/get-multichain-token-balances) for the equivalent guide.
</Info>