A token vault balance is not always spendable

A token vault balance shows how many tokens an account or contract records, while the spendable amount is what its rules let you move or use now. The gap matters because custody, locks, pending transactions and protocol limits can all reduce what is available.

What does a token vault balance represent?

A vault is a place or account that holds tokens, but the term describes different arrangements across crypto projects. In a smart contract, a vault address may hold tokens for a protocol or its users; on a centralized exchange, a vault may be an internal ledger category rather than a separate on-chain address.

The displayed number is therefore a starting point, not proof that the viewer can withdraw the full amount. A wallet may show tokens held by a contract, for example, even though only the contract’s programmed rules can release them. An exchange may show assets in a funding or earn account while requiring a transfer to a trading account first.

Why can the spendable amount be lower?

Spendable balance depends on the rules governing the tokens, account and transaction. A protocol may reserve assets for an open order, lock them in a staking period, or require them as collateral against a loan. Pending transfers and unconfirmed deposits may also appear in an interface before they can be used.

Some restrictions are technical. A token contract can require an approved spender, while a smart contract may permit withdrawals only after a condition is met. On-chain activity can also require the network’s native token to pay transaction fees, so having enough of the asset being moved does not always mean the transaction can be submitted.

When a swap draws from a vault, the eligible input amount affects which routes are available; the Byreal guide to comparing swap routes covers how to assess those route differences. A quoted route still depends on the amount the protocol can actually use, not necessarily the full balance shown elsewhere.

How can you check what is available to use?

Check the account or contract that holds the asset, then look for locks, reservations, pending activity and withdrawal conditions. For a protocol, read the transaction preview and its stated limits; for an exchange, check which account or product holds the funds and whether an internal transfer is required.

• Confirm the token and network match the intended transfer or swap.
• Compare total balance with available, unlocked or withdrawable balance.
• Check whether an allowance, collateral condition or account transfer is required.
• Leave enough network fee balance for the transaction, where applicable.

Prefer the spendable figure when planning a transaction, and treat the total vault balance as an accounting view until the rules confirm it can be moved. If the interface does not explain the difference, inspect the transaction details before approving it; a displayed balance alone cannot establish what the vault will release.