{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/accounts-and-assets/staking/tezos-api","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/accounts-and-assets/staking/tezos-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/accounts-and-assets/staking/tezos-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/staking/tezos-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/staking/tezos-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/staking/tezos-api","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/staking/tezos-api","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition"]},"type":"markdown"},"seo":{"title":"Delegate Tezos staking validation rights with the API","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":"delegate-tezos-staking-validation-rights-with-the-api","__idx":0},"children":["Delegate Tezos staking validation rights with the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Tezos, token holders can delegate their validation rights to other token holders (called validators or bakers) without transferring ownership of their tokens. Unlike other DPoS protocols, the account as a whole is delegated. However, the liquidity is maintained and the tokens can still be transferred, as no freezing periods apply to a delegation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can perform the following tasks:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delegate validation rights"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Undelegate validation rights"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To perform staking tasks on Tezos, you need the following:"]},{"$$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 account on a Tezos ledger from which to initiate the transactions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/accounts/manage-accounts-api#view-account-details"},"children":["View account details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enough funds in the account to cover the transaction fees and the amount"]},{"$$mdtype":"Tag","name":"td","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":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The following new IDs, in a standard UUID format:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A transaction order ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An intent ID"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delegate-or-undelegate-validation-rights","__idx":2},"children":["Delegate or undelegate validation rights"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"System change process"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All new requests to change the system state follow the same process. To familiarize yourself with this process first, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To delegate or undelegate validation rights, follow the steps in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},", with a payload similar to one of the following examples."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payload-examples","__idx":3},"children":["Payload examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"delegate-validation-rights","__idx":4},"children":["Delegate validation rights"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n\"payload\": {\n    \"id\": \"953d75b2-e384-46e9-8a72-a1ce753a50e2\",\n    \"accountId\": \"953d75b2-e384-46e9-8a72-a1ce753a50e2\",\n    \"parameters\": {\n        \"operation\": {\n\t\t\t\"destination\": {\n\t\t\t\t\"address\": \"tz1b9jT9tp1XxNe8n2WgxnWKwup4rxGaHLhV\",\n\t\t\t\t\"type\": \"Address\"\n\t\t\t\t\t},\n\t\t\t\"type\": \"Delegation\"\n\t\t\t\t},\n        \"feeStrategy\": {\n            \"priority\": \"Low\",\n            \"type\": \"Priority\"\n        },\n        \"maximumFee\": \"4000\",\n        \"type\": \"Tezos\"\n    },\n    \"description\": \"\",\n    \"customProperties\": {},\n    \"type\": \"v0_CreateTransactionOrder\"\n\t\t}\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fields of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]}," block to note are as follows:"]},{"$$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":"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":["accountId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal account ID of a Tezos account in ","Ripple Custody","."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.destination"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Address to which to delegate validation rights."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delegation"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.feeStrategy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The fee strategy to use for the transaction. For Tezos, the Priority strategy applies. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.maximumFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The maximum fee, in micro tez. For more information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/transactions/reference#fee-strategy-and-maximum-fee"},"children":["Fee strategy and maximum fee"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ledger type, in this case ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tezos"]},"."]}]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransactionOrder"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"undelegate-validation-rights","__idx":5},"children":["Undelegate validation rights"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"payload\": {\n        \"id\": \"953d75b2-e384-46e9-8a72-a1ce753a50e2\",\n        \"accountId\": \"953d75b2-e384-46e9-8a72-a1ce753a50e2\",\n        \"parameters\": {\n            \"operation\": {\n\t\t\t    \"type\": \"Undelegation\"\n            },\n            \"feeStrategy\": {\n                \"priority\": \"Low\",\n                \"type\": \"Priority\"\n            },\n            \"maximumFee\": \"4000\",\n            \"type\": \"Tezos\"\n        },\n        \"customProperties\": {},\n        \"type\": \"v0_CreateTransactionOrder\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the transaction order is successfully approved, ","Ripple Custody"," does the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates a transaction, to broadcast the details and delegate staking to or undelegate staking from the staking pool on the blockchain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates one or more transfers, to represent the separate amounts associated with the transaction, such as the cryptocurrency amount and the fees."]}]}]}]},"headings":[{"value":"Delegate Tezos staking validation rights with the API","id":"delegate-tezos-staking-validation-rights-with-the-api","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Delegate or undelegate validation rights","id":"delegate-or-undelegate-validation-rights","depth":2},{"value":"Payload examples","id":"payload-examples","depth":3},{"value":"Delegate validation rights","id":"delegate-validation-rights","depth":4},{"value":"Undelegate validation rights","id":"undelegate-validation-rights","depth":4}],"frontmatter":{"seo":{"title":"Delegate Tezos staking validation rights with the API"}},"lastModified":"2026-08-17T21:19:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/accounts-and-assets/staking/tezos-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}