Node reference
Token holdings
List tokens held by a wallet
Token holdings lists a wallet’s token accounts and balances. Use it to discover token data before filtering it or processing each holding.
Try it step by step#
- Enter an Owner Address or select a wallet variable. Leave Include zero balances disabled for a shorter first result.
- Run and inspect the holdings array and count.
- Connect Iterate and select the holdings array with the expression picker. Add a Variable on item to inspect one holding at a time.
What to expect#
The output is an object containing owner, count, and holdings. The complete output is not itself an array; Iterate needs holdings.
Things to check#
- An empty list can mean the wallet has no matching nonzero token accounts on this network.
- Native SOL is read separately with SOL balance.
- Keep the mint and token account identifiers with the amount when building a report. A balance without its token identity is ambiguous.
Keep learning#
Network setup: This node uses solana. See connections for RPC setup and Test mode for network selection.
Parameters#
| Setting | Default | What it does |
|---|---|---|
| RPC URL | {{global.chains.solana.rpcUrl}} | Configured for Solana in workspace RPC settings. |
| Commitment | confirmed | How far a Solana block must be confirmed before its data is used. |
| Owner Wallet | {{global.main_wallet}} | Wallet address that owns the token accounts or positions to use. |
| Include Zero Balances | false | Include token accounts whose token balance is zero. |
| On failure | stop | Choose whether a failed execution stops the workflow or only ends this path. |
| Retry attempts | 0 | How many additional attempts to make after the first failure. |
RPC URL: Available under More options.
Commitment: Choices: Processed (processed), Confirmed (confirmed), Finalized (finalized). Available under More options.
Include Zero Balances: Available under More options.
On failure: Choices: Stop workflow (stop), Continue (continue). Available under More options.
Retry attempts: Available under More options. Limits: minimum 0.
Inputs#
| Port | Value | Description |
|---|---|---|
in | any | Payload to forward with token holdings. |
Outputs#
| Port | Value | Description |
|---|---|---|
out | object | Parsed SPL token holdings for a wallet. |
out fields#
| Field | Type |
|---|---|
owner | string |
count | number |
holdings | array |
context.slot | number |