{"templateId":"markdown","versions":[{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Check MPT balances","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","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":"check-mpt-balances","__idx":0},"children":["Check MPT balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once a ticker exists for an MPT (created automatically or manually), you can view balances using the standard ","Ripple Custody"," balance APIs and UI."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$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":"Prerequisite"},"children":["Prerequisite"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Additional information"},"children":["Additional information"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An authorized MPT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/holder/authorize"},"children":["Authorize MPT"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ticker for the MPT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Created automatically on first receipt, or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-an-mpt-ticker"},"children":["create manually"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-balances","__idx":2},"children":["View balances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the standard balance APIs to view MPT balances:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/accounts/manage-accounts-api#check-account-balances"},"children":["Check account balances"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," applies the MPT's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AssetScale"]}," to display balances with correct decimal precision."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-an-mpt-ticker","__idx":3},"children":["Create an MPT ticker"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an incoming MPT payment is received, ","Ripple Custody"," automatically creates a ticker. You can also explicitly create a ticker using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTicker"]}," intent:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payload-example","__idx":4},"children":["Payload example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payload\": {\n    \"id\": \"{{intent_id}}\",\n    \"ticker\": {\n      \"id\": \"{{ticker_id}}\",\n      \"name\": \"MyMultiPurposeToken\",\n      \"symbol\": \"MMPT\",\n      \"decimals\": 6,\n      \"kind\": \"Token\",\n      \"ledgerId\": \"xrpl-mainnet\",\n      \"ledgerDetails\": {\n        \"type\": \"Xrpl\",\n        \"properties\": {\n          \"type\": \"MultiPurposeToken\",\n          \"issuanceId\": \"000004C463C52827307480341125DA0577AFFC21D4B2D0831E\"\n        }\n      }\n    },\n    \"type\": \"v0_CreateTicker\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"properties-fields","__idx":5},"children":["Properties fields"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["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":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MultiPurposeToken"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuanceId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The 192-bit MPT Issuance ID (hex encoded). Pattern: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["^[A-Fa-f0-9]{48}$"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ticker's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["decimals"]}," field should match the MPT's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AssetScale"]}," for correct balance display."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":6},"children":["Related topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/holder/authorize"},"children":["Authorize MPT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/holder/send"},"children":["Send MPTs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts#assetscale-decimals"},"children":["Multi-purpose tokens concepts"]}]}]}]},"headings":[{"value":"Check MPT balances","id":"check-mpt-balances","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"View balances","id":"view-balances","depth":2},{"value":"Create an MPT ticker","id":"create-an-mpt-ticker","depth":2},{"value":"Payload example","id":"payload-example","depth":3},{"value":"Properties fields","id":"properties-fields","depth":3},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Check MPT balances"}},"lastModified":"2026-08-04T20:25:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/holder/balances","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}