{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Understanding balances","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"understanding-balances","__idx":0},"children":["Understanding balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When viewing wallet balances in Wallet-as-a-Service (Palisade), you'll see different balance types that reflect the availability and status of your funds."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"balance-types","__idx":1},"children":["Balance types"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Balance Type"},"children":["Balance Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The sum of all funds in the wallet (available + frozen + pending)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Available"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Funds that can be used immediately for outgoing transactions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frozen"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Funds from transactions that have been frozen for compliance review"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Funds from transactions currently awaiting a freeze decision"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-balances-differ","__idx":2},"children":["When balances differ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your available balance may be less than your total balance when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions are frozen"]},": Incoming deposits have been manually frozen or automatically frozen for review. These funds remain in the \"Frozen\" balance until unfrozen. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/user-interface/transactions/manage-transactions"},"children":["Manage transactions"]}," for more information on freezing transactions."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions are pending"]},": Incoming transactions that are awaiting a freeze decision. Once confirmed, these amounts move to either \"Available\" or \"Frozen\"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"viewing-balances","__idx":3},"children":["Viewing balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can view your wallet balances in the Wallet-as-a-Service (Palisade) console from:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The vault overview, which displays balances for all wallets"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Individual wallet pages, which show balances for that specific wallet"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"refreshing-balances","__idx":4},"children":["Refreshing balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To manually refresh a wallet's balances:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to the wallet page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the refresh icon next to the wallet balance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Balances will update automatically once the sync completes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manual refresh is useful when a balance appears outdated or incorrect"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"limitations","__idx":5},"children":["Limitations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manual refresh only updates balances for tokens that Wallet-as-a-Service (Palisade) is already tracking for that wallet. It will not detect new tokens that have never been seen before."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've received a token that isn't appearing in your wallet:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The token may not yet be tracked by Wallet-as-a-Service (Palisade)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact support to have the token added to your wallet"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"multi-chain-balances-evm-wallets","__idx":6},"children":["Multi-chain balances (EVM wallets)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For EVM wallets, balances are tracked separately for each blockchain where you hold assets. This provides complete visibility into your cross-chain holdings."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"per-chain-balance-breakdown","__idx":7},"children":["Per-chain balance breakdown"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Aspect"},"children":["Aspect"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chain-specific balances"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See exactly how much you hold on each blockchain (e.g., 500 USDC on Ethereum, 200 USDC on Arbitrum)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Aggregated totals"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total holdings automatically sum across all chains"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fiat valuations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Portfolio value calculated across all chains in your preferred currency"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-balance-view","__idx":8},"children":["Example balance view"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an EVM wallet holding USDC across multiple chains:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Blockchain"},"children":["Blockchain"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Asset"},"children":["Asset"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Quantity"},"children":["Quantity"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USDC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Arbitrum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USDC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Polygon"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USDC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["150.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["USDC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["850.00"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-response","__idx":9},"children":["API response"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"API documentation"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/api-docs/palisade-api/palisade-api"},"children":["Wallet-as-a-Service (Palisade) API reference"]}," for information on how to retrieve balance information via the API."]}]}]},"headings":[{"value":"Understanding balances","id":"understanding-balances","depth":1},{"value":"Balance types","id":"balance-types","depth":2},{"value":"When balances differ","id":"when-balances-differ","depth":2},{"value":"Viewing balances","id":"viewing-balances","depth":2},{"value":"Refreshing balances","id":"refreshing-balances","depth":2},{"value":"Limitations","id":"limitations","depth":3},{"value":"Multi-chain balances (EVM wallets)","id":"multi-chain-balances-evm-wallets","depth":2},{"value":"Per-chain balance breakdown","id":"per-chain-balance-breakdown","depth":3},{"value":"Example balance view","id":"example-balance-view","depth":3},{"value":"API response","id":"api-response","depth":3}],"frontmatter":{"title":"Understanding balances","seo":{"title":"Understanding balances"}},"lastModified":"2026-01-29T16:01:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/user-interface/wallets/understanding-balances","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}