Withdrawal

The withdrawal process in the Polygon network using the Staking API can be done following these steps:

Undelegate staked tokens.
Unstake tokens — available after the undelegate period.
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:

curl --request POST \
		 --url https://api.p2p.org/api/v1/polygon/staking/undelegate \
     --head 'accept: application/json' \
     --head 'Authorization: Bearer <token>' \
     --head 'Content-Type: application/json' \
     --data '
{
  "amount": "100000000000000000",
  "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17"
}
'

amount — amount of tokens in Wei (1 MATIC = 10¹⁸ Wei) to undelegate.
stakerAddress — staker account address.

Example response:

{
  "result": {
    "serializeTx": "0x02f86505800214830186a094499d11e0b6eac7c0593d8fb292dcbbf815fb29ae80b844095ea7b300000000000000000000000000200ea4ee292e253e6ca07dba5edc07c8aa37a3000000000000000000000000000000000000000000000000016345785d8a0000c0",
    "to": "0x499d11E0b6eAC7c0593d8Fb292DCBbF815Fb29Ae",
    "gasLimit": "0.0000000000001",
    "data": "0x095ea7b300000000000000000000000000200ea4ee292e253e6ca07dba5edc07c8aa37a3000000000000000000000000000000000000000000000000016345785d8a0000",
    "value": "0.0",
    "chainId": 1,
    "type": 2,
    "maxFeePerGas": "0.00000000000000002",
    "maxPriorityFeePerGas": "2"
  }
}

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.
type — EIP-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 checkpoints. 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:

curl --request POST \
		 --url https://api.p2p.org/api/v1/polygon/staking/unstake \
     --head 'accept: application/json' \
     --head 'Authorization: Bearer <token>' \
     --head 'Content-Type: application/json' \
     --data '
{
  "unbondNonce": "100",
  "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17"
}
'

unbondNonce — unique identifier (nonce) 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:

curl --request POST \
		 --url https://api.p2p.org/api/v1/polygon/staking/withdraw \
     --head 'accept: application/json' \
     --head 'Authorization: Bearer <token>' \
     --head 'Content-Type: application/json' \
     --data '
{
  "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17"
}
'

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.

What's next?

Getting Started
Staking API reference