Withdrawal

The withdrawal process in the Aptos network using the Staking API can be done in a few steps:

Create an unstaking request.

It takes up to 30 days to unlock tokens on Aptos network. During this waiting period, unlocked tokens continue earning rewards.

Create a withdrawal request.

Get an authentication token to start using Staking API. Request examples are provided using cURL.

Create unstaking transaction

Send a POST request to /api/v1/aptos/{network}/staking/delegated/unlock. Example request (for mainnet network):

curl --request POST \
     --url https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/unlock \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <token>' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": 1100000000,
  "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
  "gas": {
    "unitPrice": 100,
    "maxGasLimit": 100
  }
}
'

const response = await fetch("https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/unlock", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "amount": 1100000000,
    "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
    "gas": {
      "unitPrice": 100,
      "maxGasLimit": 100
    }
  }),
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/unlock",
    headers={
        "Authorization": "Bearer <token>",
        "Content-Type": "application/json",
    },
    json={
        "amount": 1100000000,
        "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
        "gas": {
            "unitPrice": 100,
            "maxGasLimit": 100
        }
    },
)
print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"amount": 1100000000,
		"delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
		"gas": map[string]interface{}{
			"unitPrice": 100,
			"maxGasLimit": 100,
		},
	}
	body, _ := json.Marshal(payload)
	req, _ := http.NewRequest("POST", "https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/unlock", bytes.NewBuffer(body))
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

amount — amount of tokens to unlock in Octas.
delegatorAddress — account address which keeps tokens.
gas — optional; computational effort required to execute the transaction, measured in units.
- unitPrice — price per unit of in Octas for processing the Aptos transaction.
- maxGasLimit — maximum gas limit for the transaction.

Example response:

{
    "result": {
      "amount": 1100000000,
      "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
      "unsignedTransaction": "0xa571a5bc9b1bfd5fe58e6e09a5be251a3299985494d022959ce206f1f23f752e21000000000000000200000000000000000000000000000000000000000000000000000000000000010f64656c65676174696f6e5f706f6f6c096164645f7374616b650002207a2ddb6af66beb0d9987c6c9010cb9053454f067e16775a8ecf19961195c3d28080100000000000000400d0300000000006400000000000000e5742068000000000200",
      "createdAt": "2023-08-24T08:14:50.455Z"
    },
    "error": null
  }

amount — amount of tokens to unlock in Octas.
delegatorAddress — account address which keeps tokens.
unsignedTransaction — unsigned transaction in hexadecimal format. Sign the transaction and submit it to the blockchain to perform the called action.
createdAt — timestamp of the transaction in the ISO 8601 format.

Use unsignedTransaction to sign and send the signed transaction to the Aptos network.

Create withdrawal request

After the delegation pool period on Aptos expired, withdraw your tokens by sending a POST request to /api/v1/aptos/{network}/staking/delegated/withdraw. Example request (for mainnet network):

curl --request POST \
     --url https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/withdraw \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <token>' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": 1100000000,
  "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
  "gas": {
    "unitPrice": 100,
    "maxGasLimit": 100
  }
}
'

const response = await fetch("https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/withdraw", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "amount": 1100000000,
    "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
    "gas": {
      "unitPrice": 100,
      "maxGasLimit": 100
    }
  }),
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/withdraw",
    headers={
        "Authorization": "Bearer <token>",
        "Content-Type": "application/json",
    },
    json={
        "amount": 1100000000,
        "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
        "gas": {
            "unitPrice": 100,
            "maxGasLimit": 100
        }
    },
)
print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"amount": 1100000000,
		"delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
		"gas": map[string]interface{}{
			"unitPrice": 100,
			"maxGasLimit": 100,
		},
	}
	body, _ := json.Marshal(payload)
	req, _ := http.NewRequest("POST", "https://api.p2p.org/api/v1/aptos/mainnet/staking/delegated/withdraw", bytes.NewBuffer(body))
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

amount — amount of tokens to withdraw in Octas.
delegatorAddress — account address which keeps tokens.
gas — optional; computational effort required to execute the transaction, measured in gas units.
- unitPrice — price per unit of gas in Octas for processing the Aptos transaction.
- maxGasLimit — maximum gas limit for the transaction.

Example response:

{
    "result": {
      "amount": 1100000000,
      "delegatorAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
      "unsignedTransaction": "0xa571a5bc9b1bfd5fe58e6e09a5be251a3299985494d022959ce206f1f23f752e21000000000000000200000000000000000000000000000000000000000000000000000000000000010f64656c65676174696f6e5f706f6f6c096164645f7374616b650002207a2ddb6af66beb0d9987c6c9010cb9053454f067e16775a8ecf19961195c3d28080100000000000000400d0300000000006400000000000000e5742068000000000200",
      "createdAt": "2025-08-24T08:14:50.455Z"
    },
    "error": null
  }

amount — amount of tokens to withdraw in Octas.
delegatorAddress — account address which keeps tokens.
unsignedTransaction — unsigned transaction in hexadecimal format. Sign the transaction and submit it to the blockchain to perform the called action.
createdAt — timestamp of the transaction in the ISO 8601 format.

Use unsignedTransaction to sign and send the signed transaction to the Aptos network.

To check the transaction status, send a GET request to /api/v1/aptos/{network}/transaction/status/{transactionHash}.Example request (for mainnet network):

curl --request GET \
     --url https://api.p2p.org/api/v1/aptos/mainnet/transaction/status/0x8d80b8ed85b578eeb873731101a926221701ee48218f6c9b83895f7ac1535641 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <token>' \
     --header 'content-type: application/json'

const response = await fetch("https://api.p2p.org/api/v1/aptos/mainnet/transaction/status/0x8d80b8ed85b578eeb873731101a926221701ee48218f6c9b83895f7ac1535641", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://api.p2p.org/api/v1/aptos/mainnet/transaction/status/0x8d80b8ed85b578eeb873731101a926221701ee48218f6c9b83895f7ac1535641",
    headers={
        "Authorization": "Bearer <token>",
        "Content-Type": "application/json",
    },
)
print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.p2p.org/api/v1/aptos/mainnet/transaction/status/0x8d80b8ed85b578eeb873731101a926221701ee48218f6c9b83895f7ac1535641", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

transactionHash — hash of the transaction.

Example response:

{
    "result": {
      "createdAt": "2025-06-24T08:14:50.455Z",
      "gas": {
        "unitPrice": 100,
        "maxGasLimit": 100,
        "used": 100
      },
      "senderAddress": "0xd890b1115b39c8d182aeac6cae313cc713cd93922135f8a5893c34fce4e0f32a",
      "sequenceNumber": 42,
      "status": "success",
      "transactionHash": "0x8d80b8ed85b578eeb873731101a926221701ee48218f6c9b83895f7ac1535641"
    },
    "error": null
  }

createdAt — timestamp of the transaction in the ISO 8601 format.
gas — computational effort required to execute the transaction, measured in gas units.
- unitPrice — price per unit of gas in Octas for processing the Aptos transaction.
- maxGasLimit — maximum gas limit for the transaction.
- used — amount of gas spent for the transaction.
senderAddress — transaction sender address.
sequenceNumber — number of transactions that have been submitted and committed on-chain from the sender account.
status — transaction status: pending, success or failed.
transactionHash — hash of the transaction.

Introduction

Using AI Tools

API Products

Widget

Syncro Products

SDK Products

Deep Dive

Support