# Balance (/docs/nodes/utility/balance)

Read the connected wallet's SOL or SPL token balance.



The Balance node reads the embedded Privy wallet attached to the signed-in user. Use it before trading, paying, or branching so the workflow can check available funds.

Prerequisites [#prerequisites]

* A signed-in Solaris AI Flow account
* An embedded Privy Solana wallet
* No API key required

Configuration [#configuration]

| Field      | Type   | Required | Description                                                                 |
| ---------- | ------ | -------- | --------------------------------------------------------------------------- |
| Node Label | string | No       | Display name shown on the canvas                                            |
| Token mint | string | No       | Leave empty to read SOL. Paste an SPL token mint to read that token instead |

The token mint field supports template expressions. For example:

```text
{webhook.body.mint}
```

Use a template when the token to inspect comes from a webhook, API response, or previous workflow step.

Output for SOL [#output-for-sol]

When **Token mint** is empty, the node reads native SOL:

```json
{
  "walletAddress": "YourWallet...",
  "mint": null,
  "symbol": "SOL",
  "decimals": 9,
  "balance": 1.25,
  "balanceRaw": "1250000000"
}
```

Output for SPL tokens [#output-for-spl-tokens]

When **Token mint** is set, the node reads the wallet's associated token account:

```json
{
  "walletAddress": "YourWallet...",
  "mint": "TokenMint...",
  "symbol": null,
  "decimals": 6,
  "balance": 42.5,
  "balanceRaw": "42500000",
  "accountExists": true
}
```

If the token account does not exist yet, the node returns a zero balance with `accountExists: false` instead of failing. That is useful before buys or swaps where the wallet may not have received that token before.

Common use cases [#common-use-cases]

* Check SOL before a Jupiter transfer, Pump.fun trade, marketplace purchase, or x402 request
* Check a token balance before deciding whether to sell
* Branch with a [Condition](/docs/nodes/utility/condition) node when a balance is above or below a threshold
* Use a webhook-provided mint address to inspect arbitrary SPL token balances

Example: only continue if SOL is available [#example-only-continue-if-sol-is-available]

Workflow:

```text
Manual Trigger -> Balance -> Condition -> Jupiter
```

Leave **Token mint** empty. Then configure Condition:

```text
expression: {balanceResponse.balance}
operator: greater_than
value: 0.05
```

Next steps [#next-steps]

* [Condition](/docs/nodes/utility/condition) - branch based on the balance
* [Jupiter](/docs/nodes/defi/jupiter) - transfer or swap tokens
* [x402](/docs/nodes/utility/x402) - pay x402-enabled endpoints