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

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

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:

{webhook.body.mint}

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

Output for SOL

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

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

Output for SPL tokens

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

{
  "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

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 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

Workflow:

Manual Trigger -> Balance -> Condition -> Jupiter

Leave Token mint empty. Then configure Condition:

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

Next steps

Condition - branch based on the balance
Jupiter - transfer or swap tokens
x402 - pay x402-enabled endpoints