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

# UseBalance

```ts theme={null}
function useBalance(options): UseBalanceResult;
```

Fetch and cache token balance data with automatic metadata enrichment

Supports SOL and SPL tokens. Auto-refetches on mount and dependencies change.

## Parameters

| Parameter | Type | Description |
| - | - | - |
| `options` | [`UseBalanceOptions`](https://developers.squads.so/grid/v1/sdk-reference/react/reference/latest/interfaces/UseBalanceOptions) | Balance fetching configuration |

## Returns

[`UseBalanceResult`](https://developers.squads.so/grid/v1/sdk-reference/react/reference/latest/interfaces/UseBalanceResult)

Balance data with loading and error states

## Example

```tsx theme={null}
import { useBalance } from '@sqds/grid-react';

function WalletBalance() {
  const { balance, isLoading, error } = useBalance({ symbol: 'USDC' });

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

  return <div>{balance?.amountDecimal} {balance?.symbol}</div>;
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.