Create a DOT unbond request

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

Body Params
string
required

uint64; The ID of the source address for funds.

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)

string

numeric; Maximum amount of fees to be paid for the transaction.

string

A reconciliation note can be given when initiating a request and this will be included in transaction history.

string

Deprecated: use externalRequestId instead

string

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

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json


  © 2026 Taurus SA. All rights reserved.