# Use basic getter hooks in AppKit (https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/get-started/basic-getter-hooks/content.md)



Read the connected wallet's state from React using AppKit's getter hooks. They re-render when the underlying state changes and do not themselves start wallet actions — transactions and signatures use mutation hooks such as `useTransferTon`, `useSignText`, and `useSendTransaction`.

## Before you begin [#before-you-begin]

You need the React providers in place. See [Install AppKit → Wrap the application](https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/get-started/installation/react-app/content.md).

## Three return shapes [#three-return-shapes]

Getter hooks come in three return shapes. Which shape a hook uses depends on where the data lives.

**Tuple with setter** — for state AppKit stores reactively and that the app can change. The first element is the value (or `null` if not yet set), the second is the setter.

```tsx
const [wallet, setWalletId] = useSelectedWallet();
const [network, setDefaultNetwork] = useDefaultNetwork();
```

The hooks that return tuples: `useSelectedWallet`, `useDefaultNetwork`.

**Direct value** — for store-derived state that is read-only from React. Returns the value itself, no wrapper.

```tsx
const address = useAddress();              // string | undefined
const network = useNetwork();              // Network | undefined
const networks = useNetworks();            // Network[]
const connectors = useConnectors();        // Connector[]
const wallets = useConnectedWallets();     // WalletInterface[]
const connector = useConnectorById('tonconnect'); // Connector | undefined
const appKit = useAppKit();                // AppKit
```

These hooks use `useSyncExternalStore` under the hood and re-render when the underlying state changes.

**TanStack Query result** — for chain data fetched through an API client. Returns `{ data, isLoading, isError, error, refetch }` and accepts a `query` field for `refetchInterval`, `enabled`, `staleTime`, and the rest of the TanStack Query options.

```tsx
const { data: balance, isLoading } = useBalance();
const { data: jettons } = useJettons({ query: { refetchInterval: 20000 } });
```

The hooks that return query results: `useBalance`, `useJettons`, `useNfts`, `useTransactionStatus`, `useJettonInfo`, `useJettonBalanceByAddress`, `useJettonWalletAddress`, `useBlockNumber`, `useNft`, and the `*ByAddress` variants.

## Provider data is not chain finality [#provider-data-is-not-chain-finality]

A getter hook reflects a snapshot of provider data, not the chain itself. The user's wallet may report state that differs from what the configured `apiClient` returns — usually because the indexer is a few blocks behind the wallet, sometimes because the two read different networks. For live updates without manual refetch, mount the matching `useWatch*` hook (covered on [Stream live updates](https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/get-started/streaming/content.md)).

## Tips [#tips]

Treat hook data as the latest read, not as a settlement check. Verify chain effects with `getTransactionStatus` or a backend before crediting value, and re-check after any reconnect.

## Code example [#code-example]

See a [working example](https://github.com/ton-connect/kit/tree/main/apps/appkit-minter) that uses `useBalance`, `useJettons`, and `useNfts` to render wallet state — [try it live](https://appkit-minter.vercel.app/).

## Next steps [#next-steps]

* Move on to [Send transactions](https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/get-started/sending-transactions/content.md) — at that point you'll have a working app.
* For a full walkthrough of reading Gram, jetton, and NFT data, see [Read balances](https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/howto/read-balances/content.md).
* Look up the full hook surface in the [`@ton/appkit-react` reference](https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/reference/appkit-react/content.md).