{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["badge","tabs","tab","try-it","code-snippet"]},"redocly_category":"Documentation","type":"markdown"},"seo":{"title":"account_mptokens","siteUrl":"https://xrpl.org","llmstxt":{"hide":false,"title":"XRPL Developer Portal & Documentation","description":"Explore XRP Ledger documentation, blogs, and other blockchain developer resources needed to start building and integrating with the ledger.","details":{"content":"XRP Ledger concepts, use cases, tutorials, references, and other blockchain developer resources. Also, stay up to date with release announcements and more through the XRPL Blog."},"sections":[{"title":"Introduction","description":"A high-level introduction to the XRP Ledger.","includeFiles":["docs/introduction/**/*.*","about/faq.md"],"excludeFiles":["docs/introduction/index.md"]},{"title":"Use Cases","description":"Real-world applications and business scenarios for the XRP Ledger.","includeFiles":["docs/use-cases/**/*.*"],"excludeFiles":["docs/use-cases/index.md","docs/use-cases/defi/index.md"]},{"title":"Agentic Transactions","description":"XRPL AI Starter Kit to help autonomous agents discover, set up, and execute agentic transactions on the XRP Ledger.","includeFiles":["docs/agents/**/*.*"]},{"title":"Concepts","description":"Core concepts including accounts, tokens, transactions, consensus, and more.","includeFiles":["docs/concepts/**/*.*"],"excludeFiles":["docs/concepts/index.md","docs/concepts/decentralized-storage/index.md","docs/concepts/payment-types/index.md"]},{"title":"Tutorials","description":"Step-by-step guides for building on the XRP Ledger in JavaScript, Python, Go, and more.","includeFiles":["docs/tutorials/**/*.*"]},{"title":"References","description":"Protocol specification, transaction types, ledger entries, and API methods.","includeFiles":["docs/references/**/*.*"],"excludeFiles":["docs/references/xrp-api.md","docs/references/data-api.md","docs/references/protocol/index.md","docs/references/protocol/ledger-data/ledger-entry-types/index.md","docs/references/protocol/transactions/index.md","docs/references/protocol/transactions/types/index.md","docs/references/http-websocket-apis/api-conventions/index.md","docs/references/http-websocket-apis/public-api-methods/*/index.md","docs/references/http-websocket-apis/admin-api-methods/*/index.md"]},{"title":"Infrastructure","description":"Install, configure, and troubleshoot xrpld and Clio servers.","includeFiles":["docs/infrastructure/**/*.*"],"excludeFiles":["docs/infrastructure/index.md","docs/infrastructure/*/index.md","docs/infrastructure/installation/build-run-xrpld-in-reporting-mode.md","docs/infrastructure/configuration/data-retention/index.md","docs/infrastructure/configuration/server-modes/index.md"]},{"title":"Blog (2023+)","description":"Recent XRPL Blog posts (showing 2023 and newer).","includeFiles":["blog/2023/**/*.*","blog/2024/**/*.*","blog/2025/**/*.*","blog/2026/**/*.*"]},{"title":"Resources","description":"Developer resources and contribution guidelines.","includeFiles":["resources/**/*.*"]}]},"description":"Get the MPTokens held by a given account as of a given ledger."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"account_mptokens","__idx":0},"children":["account_mptokens"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/XRPLF/clio/blob/develop/src/rpc/handlers/AccountMPTokens.cpp","title":"Source"},"children":["[Source]"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_mptokens"]}," method returns information about the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/tokens/fungible-tokens/multi-purpose-tokens"},"children":["MPTs"]}," held by an account, including their balance. This method may return large data sets, so you should expect to implement ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/http-websocket-apis/api-conventions/markers-and-pagination"},"children":["pagination"]},". ",{"$$mdtype":"Tag","name":"Badge","attributes":{"color":"","href":"https://github.com/XRPLF/clio/releases/tag/2.7.0"},"children":["New in: Clio v2.7.0"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This method is only available using Clio, not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["xrpld"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-format","__idx":1},"children":["Request Format"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"WebSocket","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"command\": \"account_mptokens\",\n  \"account\": \"rLEw4taUYTNLs3ZCv3vyXGmct8PagQ9GcF\",\n  \"ledger_index\": \"validated\"\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JSON-RPC","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"method\": \"account_mptokens\",\n  \"params\": [\n    {\n      \"account\": \"rLEw4taUYTNLs3ZCv3vyXGmct8PagQ9GcF\",\n      \"ledger_index\": \"validated\"\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"TryIt","attributes":{"method":"account_mptokens","server":""},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request contains the following parameters:"]},{"$$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":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required?"},"children":["Required?"]},{"$$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":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String - ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#addresses"},"children":["Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Look up MPTs held by this account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledger_index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#ledger-index"},"children":["Ledger Index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#ledger-index"},"children":["Ledger Index"]}," of the ledger to use, or a shortcut string to choose a ledger automatically. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#specifying-ledgers"},"children":["Specifying Ledgers"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledger_hash"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A 32-byte hex string for the ledger version to use. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#specifying-ledgers"},"children":["Specifying Ledgers"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marker"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/http-websocket-apis/api-conventions/markers-and-pagination"},"children":["Marker"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to continue your query where it left off in paginating."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number (positive integer)"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify a limit to the number of MPTs returned. Must be within the inclusive range 10 to 400. Positive values outside this range are replaced with the closest valid option. The default is 200."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-format","__idx":2},"children":["Response Format"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"WebSocket","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/_api-examples/account_mptokens/ws-response.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"result\": {\n    \"account\": \"rLEw4taUYTNLs3ZCv3vyXGmct8PagQ9GcF\",\n    \"ledger_hash\": \"6CAA8A6A2B5EB20B0D2C8DE5B54B63BA4D8FE54266EBB3A7DA9B3F60B009778B\",\n    \"ledger_index\": 105503030,\n    \"validated\": true,\n    \"limit\": 200,\n    \"mptokens\": [\n      {\n        \"mpt_id\": \"CC043159A7647CDB51F41C1DF4985D654CD1635A62299B2522B9E184D8A0573F\",\n        \"account\": \"rLEw4taUYTNLs3ZCv3vyXGmct8PagQ9GcF\",\n        \"mpt_issuance_id\": \"062B590488AF241E0720C1D54DD12798D8B0A05E7B147EE0\",\n        \"mpt_amount\": 2412500,\n        \"mpt_authorized\": true\n      }\n    ]\n  },\n  \"id\": \"example_account_mptokens\",\n  \"status\": \"success\",\n  \"type\": \"response\",\n  \"warnings\": [\n    {\n      \"id\": 2001,\n      \"message\": \"This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request\"\n    }\n  ]\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JSON-RPC","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/_api-examples/account_mptokens/jsonrpc-response.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"200 OK\n\n{\n  \"result\": {\n    \"account\": \"rLEw4taUYTNLs3ZCv3vyXGmct8PagQ9GcF\",\n    \"ledger_hash\": \"6CAA8A6A2B5EB20B0D2C8DE5B54B63BA4D8FE54266EBB3A7DA9B3F60B009778B\",\n    \"ledger_index\": 105503030,\n    \"validated\": true,\n    \"limit\": 200,\n    \"mptokens\": [\n      {\n        \"mpt_id\": \"CC043159A7647CDB51F41C1DF4985D654CD1635A62299B2522B9E184D8A0573F\",\n        \"account\": \"rLEw4taUYTNLs3ZCv3vyXGmct8PagQ9GcF\",\n        \"mpt_issuance_id\": \"062B590488AF241E0720C1D54DD12798D8B0A05E7B147EE0\",\n        \"mpt_amount\": 2412500,\n        \"mpt_authorized\": true\n      }\n    ],\n    \"status\": \"success\"\n  },\n  \"warnings\": [\n    {\n      \"id\": 2001,\n      \"message\": \"This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request\"\n    }\n  ]\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response follows the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/http-websocket-apis/api-conventions/response-formatting"},"children":["standard format"]},", with the result containing the following 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":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#addresses"},"children":["Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The account whose MPTokens were queried."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mptokens"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Array"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["An array of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#mpt-objects"},"children":["MPT objects"]}," held by the account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marker"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/http-websocket-apis/api-conventions/markers-and-pagination"},"children":["Marker"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Used to continue querying where we left off when paginating. Omitted if there are no more entries after this result."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The limit, as specified in the request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledger_hash"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#hashes"},"children":["Hash"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The hash of the ledger version used to generate this response."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledger_index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#ledger-index"},"children":["Ledger Index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The index of the ledger version used to generate this response."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the ledger has been validated by the consensus process and is immutable. Otherwise, the contents of the ledger are not final and may change. In Clio, this is ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["always"]}," true as Clio stores and returns validated ledger data."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mpt-objects","__idx":3},"children":["MPT objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each MPT object has the following 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":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mpt_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/ledger-data/common-fields#ledger-entry-id"},"children":["ledger entry ID"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPToken"]}," ledger entry for this MPT."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#addresses"},"children":["Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The holder of this MPT."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mpt_issuance_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The 192-bit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuanceID"]},", as hexadecimal, of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/ledger-data/ledger-entry-types/mptokenissuance"},"children":["MPTokenIssuance entry"]}," that this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPToken"]}," is associated with."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mpt_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The amount of tokens currently held by the account for this issuance."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locked_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Number"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(May be omitted)"]}," The amount of tokens currently held in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/payment-types/escrow"},"children":["escrow"]},". Omitted if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPToken"]}," has no escrowed balance."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mpt_locked"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(May be omitted)"]}," If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the issuer has frozen the holder's balance of this token, so the holder can't send it. This is unrelated to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locked_amount"]},". Omitted if not frozen."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mpt_authorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(May be omitted)"]}," If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the holder is authorized to hold this token. Omitted if not authorized."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"possible-errors","__idx":4},"children":["Possible Errors"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/http-websocket-apis/api-conventions/error-formatting#universal-errors"},"children":["universal error types"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalidParams"]}," - One or more fields are specified incorrectly, or one or more required fields are missing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actMalformed"]}," - The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#addresses"},"children":["Address"]}," specified in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}," field of the request is not a valid account address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actNotFound"]}," - The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/references/protocol/data-types/basic-data-types#addresses"},"children":["Address"]}," specified in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account"]}," field of the request does not correspond to an account in the ledger."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lgrNotFound"]}," - The ledger specified by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledger_hash"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ledger_index"]}," does not exist, or the server does not have it."]}]}]},"headings":[{"value":"account_mptokens","id":"account_mptokens","depth":1},{"value":"Request Format","id":"request-format","depth":2},{"value":"Response Format","id":"response-format","depth":2},{"value":"MPT objects","id":"mpt-objects","depth":3},{"value":"Possible Errors","id":"possible-errors","depth":2}],"frontmatter":{"seo":{"description":"Get the MPTokens held by a given account as of a given ledger.","title":"account_mptokens"},"labels":["Accounts","Multi Purpose Tokens, MPTs"]},"editPage":{"to":"https://github.com/XRPLF/xrpl-dev-portal/tree/master/docs/references/http-websocket-apis/public-api-methods/clio-methods/account_mptokens.md"},"lastModified":"2026-10-21T16:21:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/references/http-websocket-apis/public-api-methods/clio-methods/account_mptokens","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}