Skip to main content
The withdrawal process in the Polygon network using the Staking API can be done following these steps:
  1. Undelegate staked tokens.
  2. Unstake tokens — available after the undelegate period.
  3. Withdraw unstaked tokens.
After each operation, sign and send the transaction to the Polygon network.
1

Undelegate staked tokens

Prepare previously staked tokens to unstake by sending a POST request to ​/api​/v1​/polygon​/staking​/undelegate.Example request:
  • amount — amount of tokens in Wei (1 POL = 10¹⁸ Wei) to undelegate.
  • stakerAddress — staker account address.
Example response:
  • serializeTx — serialized unsigned transaction.
  • to — recipient address for this transaction.
  • gasLimit — maximum gas limit for this block.
  • data — transaction data.
  • value — amount this transaction is sending in Wei.
  • chainId — chain ID this transaction is authorized on, as specified by EIP-155.
  • typeEIP-2718 type of this transaction envelope.
  • maxFeePerGas — maximum price per unit of gas this transaction will pay for the combined EIP-1559 block’s base fee and this transaction’s priority fee in Wei.
  • maxPriorityFeePerGas — price per unit of gas in Wei, which is added to the EIP-1559 block’s base fee. This added fee is used to incentivize miners to prioritize this transaction.
It takes up to 3-4 days to prepare your tokens for unstaking as Polygon uses a system of . The average undelegate period on Polygon is 80 checkpoints.
2

Unstake tokens

After the undelegate period on Polygon is complete, unstake your tokens by sending a POST request to /api/v1/polygon/staking/unstake.Example request:
  • unbondNonce — unique identifier () of the undelegate request.
  • stakerAddress — staker account address.
Example response is the same as in the undelegate staked tokens step.
3

Withdraw unstaked tokens

Send a POST request to /api/v1/polygon/staking/withdraw.Example request:
  • stakerAddress — staker account address.
Example response is the same as in the two previous steps.To complete the withdrawal, sign and send the transaction to the Polygon network.