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

# Token balance

> Gate access when a wallet holds a minimum balance.

**Check ID:** `token-holding`

## Use cases

* Balance-based access
* Governance or membership tiers
* Token utility products

## Flow type

Lookup. NEUS checks current token balances.

## Required Fields

| Field                | Required | Notes                                                                                                     |
| -------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `contractAddress`    | Yes      | Token contract or mint                                                                                    |
| `minBalance`         | Yes      | Human-readable token amount, e.g. `"10.5"` — converted with the token's on-chain decimals, not base units |
| `chainId` or `chain` | Yes      | EVM `chainId` or Solana CAIP-2 chain                                                                      |
| `ownerAddress`       | No       | Wallet to check; defaults to the signer                                                                   |
| `blockNumber`        | No       | Check the balance at a specific block                                                                     |

## Example

```json theme={"dark"}
{
  "contractAddress": "0x...",
  "minBalance": "100",
  "chainId": 8453
}
```

Full schema: [`token-holding.json`](https://github.com/neus/network/blob/main/docs/verifiers/schemas/token-holding.json).