> This page is for Taurus PROTECT, version v3.46. > For other versions, use one of these documentation indexes: > - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt > - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt > - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt > - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt > - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt > - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt > - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt > - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt > - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt > - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt > - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server. # Create a DOT unbond request POST https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond Content-Type: application/json This endpoint creates an unbond request for DOT. This will unbond the selected amount. The unbonded funds will then be locked for 28 days, and can be claimed when unlocked with a DOT WithdrawUnbonded request. Required role: **RequestCreator**. This API can be made idempotent by generating an ID for the Request beforehand and passing it as the externalRequestId attribute Reference: https://taurushq.ferndocs.com/protect-capital/reference/requests-dot/create-outgoing-dot-unbond-request ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Body (application/json) This endpoint expects a tgvalidatordCreateOutgoingDOTUnbondRequestRequest. - `fromAddressId` (string, required) — uint64; The ID of the source address for funds. - `amount` (string, required) — numeric; Amount in the smallest currency unit, based on the currency decimals. Example: 1500000000000000000 WEI (smallest ETH unit) corresponds to 1.5 ETH (ETH has 18 decimals places) - `feeLimit` (string, optional) — numeric; Maximum amount of fees to be paid for the transaction. - `comment` (string, optional) — A reconciliation note can be given when initiating a request and this will be included in transaction history. - `transactionReference` (string, optional) — **Deprecated:** use `externalRequestId` instead - `externalRequestId` (string, optional) — Identifier for the request in the user's system. This must be unique. Attempting to create a request with an existing externalRequestId will do nothing and return the originally created request ## Response ### 200 A successful response. - `result` (tgvalidatordRequest, optional) ## Errors ### 400 Bad Request Error Bad Request: indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing) - `any` ### 401 Unauthorized Error Unauthorized: indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource - `any` ### 403 Forbidden Error Forbidden: indicates that the server understands the request but refuses to authorize it - `any` ### 404 Not Found Error Not Found: indicates that the server cannot find the requested resource - `any` ### 500 Internal Server Error Internal Server Error: indicates that the server encountered an unexpected condition that prevented it from fulfilling the request - `any` ### 503 Service Unavailable Error Service Unavailable: indicates that the server is not ready to handle the request. - `any` ## Types ### tgvalidatordRequest - `id` (string, optional) — Unique identifier for the request. - `tenantId` (string, optional) — The ID of the Protect tenant where the request was created. - `currency` (string, optional) — The currency of the request. - `envelope` (string, optional) — This field is used internally by Protect for request signing and approvals. This field is signed and encrypted. - `status` (string, optional) — The status of the request. One of the following: `CREATED`, `APPROVING`, `HSM_SIGNED`, `BROADCASTING`, `BROADCASTED`, `CONFIRMED`, `REJECTED` - `trails` (list of tgvalidatordRequestTrail, optional) - `signedRequests` (list of RequestSignedRequest, optional) - `creationDate` (datetime, optional) - `updateDate` (datetime, optional) - `metadata` (tgvalidatordMetadata, optional) - `attributes` (list of tgvalidatordRequestAttribute, optional) - `rule` (string, optional) - `approvers` (tgvalidatordApprovers, optional) - `type` (string, optional) — Value used internally to distinguish between different types of blockchain transactions (e.g., staking, unstaking, transfer, delegate, etc) - `currencyInfo` (tgvalidatordCurrency, optional) - `needsApprovalFrom` (list of string, optional) — List of groups that the request needs approval from. - `requestBundleId` (string, optional) — The ID of the request bundle. For more information on request bundles, see the [our docs](https://docs.taurushq.com/user-and-technical-guides/docs/accounts#bundle-request). - `externalRequestId` (string, optional) — Identifier for the request in the user's system. This must be unique. - `travelRuleDataInput` (tgvalidatordTravelRuleDataInput, optional) ### tgvalidatordRequestTrail - `id` (string, optional) — ID for the event record. - `userId` (string, optional) — The ID of the user related to the audit event. For events that are not triggered by a user, 1 is used. - `externalUserId` (string, optional) — The external ID of the user related to the audit event. E.g., validator-core@taurusgroup.com corrosponds to user ID 1 - `action` (string, optional) — The event being logged. E.g., `broadcasting`, `hsm_signed`, `hsm_ready`, `approved`, etc... - `comment` (string, optional) — Some more details about the event. This could be the transaction hash, or the ID or an error code associated with the event. - `date` (datetime, optional) - `requestStatus` (string, optional) — The status of the request at the time of the event. One of the following: `CREATED`, `APPROVING`, `APPROVED`, `HSM_SIGNED`, `HSM_READY`, `BROADCASTING`, `BROADCASTED`, `CONFIRMED`, `REJECTED` ### RequestSignedRequest - `id` (string, optional) - `signedRequest` (string, optional) - `status` (string, optional) - `hash` (string, optional) - `block` (long, optional) - `details` (string, optional) - `creationDate` (datetime, optional) - `updateDate` (datetime, optional) - `broadcastDate` (datetime, optional) - `confirmationDate` (datetime, optional) - `attributes` (list of tgvalidatordSignedRequestAttribute, optional) ### tgvalidatordMetadata - `hash` (string, optional) - `payload` (any, optional) - `payloadAsString` (string, optional) ### tgvalidatordRequestAttribute - `id` (string, optional) - `key` (string, optional) - `value` (string, optional) - `contentType` (string, optional) ### tgvalidatordApprovers - `parallel` (list of tgvalidatordParallelApproversGroups, optional) ### tgvalidatordCurrency - `name` (string, optional) — Name of the currency. - `symbol` (string, optional) — Shorthand symbol for the currency. - `coinTypeIndex` (string, optional) — Index used to identify the coin type in BIP44. (e.g. Bitcoin is 0, Ethereum is 60). - `blockchain` (string, optional) — The Blockchain the currency is associated with, (e.g. ETH, BTC). - `isToken` (boolean, optional) — Indicates if the currency is a token (e.g., ERC-20). - `isERC20` (boolean, optional) — Indicates if the token is an ERC-20 token. - `decimals` (string, optional) — Number of decimal places the currency uses (e.g. 18 for ETH). - `contractAddress` (string, optional) — Smart contract address if currency is a smart contract (e.g. ERC-20.). - `hasStaking` (boolean, optional) — Indicates if the currency supports staking. - `isUTXOBased` (boolean, optional) — Indicates if the currency is UTXO-based (e.g. Bitcoin). - `isAccountBased` (boolean, optional) — Indicates if the currency is account-based (e.g. Ethereum). - `isFiat` (boolean, optional) — Indicates if the currency is a fiat currency (e.g. CHF, EUR, USD). - `isFA12` (boolean, optional) — Indicates if the currency is based on FA12 standard (used in Tezos). - `isFA20` (boolean, optional) — Indicates if the currency is based on FA20 standard (used in Tezos). - `isNFT` (boolean, optional) — Indicates if the currency represents a Non-Fungible Token (NFT). - `enabled` (boolean, optional) — Indicates if the currency is enabled in the current tenant. - `id` (string, optional) — Unique identifier of the currency. - `displayName` (string, optional) — Display name for the currency, (e.g. Ethereum, Bitcoin). - `type` (string, optional) — Type of the currency. Can be `token`, `fiat`, `native` , or `signet`. - `wlcaId` (string, optional) — White listed contract address id associated with the currency. - `network` (string, optional) — Network or environment the currency is used on (e.g. 'mainnet', 'testnet'). - `tokenID` (string, optional) — Unique id for the token, if applicable (e.g. for NFTs). - `logo` (string, optional) — Currency logo in Data URI scheme. Base 64 encoded. (e.g. data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==). ### tgvalidatordTravelRuleDataInput - `originatorPersonTravelRuleData` (tgvalidatordPersonTravelRuleData, optional) - `originatorCompanyTravelRuleData` (tgvalidatordCompanyTravelRuleData, optional) - `beneficiaryCompanyTravelRuleData` (tgvalidatordCompanyTravelRuleData, optional) - `beneficiaryPersonTravelRuleData` (tgvalidatordPersonTravelRuleData, optional) - `provider` (string, optional) — Provider is the type of the travel rule data provider. Supported provider: 'TaurusNetwork' ### tgvalidatordSignedRequestAttribute - `id` (string, optional) - `key` (string, optional) - `value` (string, optional) - `contentType` (string, optional) ### tgvalidatordParallelApproversGroups - `sequential` (list of tgvalidatordApproversGroup, optional) ### tgvalidatordPersonTravelRuleData - `name` (string, optional) - `houseNumber` (string, optional) - `street` (string, optional) - `city` (string, optional) - `province` (string, optional) - `postalCode` (string, optional) - `country` (string, optional) - `idNumber` (string, optional) - `externalCustomerID` (string, optional) - `birthdate` (string, optional) - `birthPlace` (string, optional) - `accountNumber` (string, optional) ### tgvalidatordCompanyTravelRuleData - `department` (string, optional) - `buildingNumber` (string, optional) - `street` (string, optional) - `city` (string, optional) - `province` (string, optional) - `postalCode` (string, optional) - `country` (string, optional) - `legalEntityIdentifier` (string, optional) - `businessName` (string, optional) - `accountNumber` (string, optional) ### tgvalidatordApproversGroup - `externalGroupID` (string, optional) - `minimumSignatures` (long, optional) ## Examples **Request** ```json { "fromAddressId": "string", "amount": "string" } ``` **Response** ```json { "result": { "id": "442", "tenantId": "1", "currency": "BTC", "envelope": "CgM0NDIQmfGjk6Ops/oVGAEqmgUSrAEKPwoPbS80NCcvMCcvMCcvMC8wGiAeyruP7CoNYcGISzRo8iZmuVnV6M9gLiZuShy7aDtKKiABKNHEFDD/////DxIoCiIxQ3Zoeml0ZFZMUGhOVGZ3NU5rUm9YWHZveldacGZhWXQ2EJ/nBRoVCg9tLzQ0Jy8wJy8wJy8wLzAYsbcOMig0NDI6NDY5ZTMxOGUtYjcxZC00MGUwLTg0ZjctNzVlOGQwOWE3Yzg2IhMKCnJlcXVlc3RfaWQQARoDNDQyIhIKCXJ1bGVzX2tleRABGgNCVEMiEQoIY3VycmVuY3kQARoDQlRDIlsKBnNvdXJjZRAEGkcIARJDCAESIjFKTUJZTU1pOWlqSlJlVFlxdEZUU2RlVkJ6azhOSGRzVHUaCm5vc3RybyBCVEMiD20vNDQnLzAnLzAnLzAvMCIGc291cmNlImIKC2Rlc3RpbmF0aW9uEAUaRBJCCMwBEiIxQ3Zoeml0ZFZMUGhOVGZ3NU5rUm9YWHZveldacGZhWXQ2GghteSBsYWJlbCIPbS80NCcvMCcvMCcvMC84IgtkZXN0aW5hdGlvbiKeAQoGYW1vdW50EAoaiQEKAwGGoBIHMTAuMDQzMBoKMTAwNDIuOTcwMCAIKgNCVEMyA0NIRjphCh12YWxpZGF0b3ItY29yZUB0YXVydXNncm91cC5jaBJAffe4nBGVSajYYQxxzEZbQuj0snr8WOC1P506eXRn2EUsDrAnkWvNW9wfU+pwUoBVUaXl/veYW/6m/DJsEKijLCIGYW1vdW50Ih4KEXRvdGFsX2ZpYXRfYW1vdW50EAEaBzEwLjA0MzAiCwoDZmVlEAIaAhMBIh4KFGZlZV9wYWlkX2J5X3JlY2VpdmVyEAEaBHRydWU=", "status": "CREATED", "trails": [ { "userId": "11", "externalUserId": "team1@bank.com", "action": "created", "comment": "Ich bin eine flying Roasted Butternut Squash Boodles", "requestStatus": "CREATED" }, { "userId": "1", "externalUserId": "validator-core@taurusgroup.ch", "action": "approvers_assigned", "comment": "rule = [source: any, destination: any, amount: 10.0000], approvals = ['team1': 1 sig, 'team2': 1 sig]", "requestStatus": "CREATED" } ], "rule": "rule = [source: any, destination: any, amount: 10.0000], approvals = ['team1': 1 sig, 'team2': 1 sig]", "approvers": { "parallel": [ { "sequential": [ { "externalGroupID": "team1", "minimumSignatures": 1 }, { "externalGroupID": "team2", "minimumSignatures": 1 } ] } ] } } } ``` **SDK Code** ```python import requests url = "https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond" payload = { "fromAddressId": "string", "amount": "string" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"fromAddressId":"string","amount":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond" payload := strings.NewReader("{\n \"fromAddressId\": \"string\",\n \"amount\": \"string\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"fromAddressId\": \"string\",\n \"amount\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"fromAddressId\": \"string\",\n \"amount\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond', [ 'body' => '{ "fromAddressId": "string", "amount": "string" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"fromAddressId\": \"string\",\n \"amount\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "fromAddressId": "string", "amount": "string" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/dot/unbond")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```