Skip to main content
Version: 2.4

Withdraw Unstaked AVT

Withdraws previously unstaked AVT back to the user's free balance.

await API.send.withdrawUnlocked()

This operation uses a relayer account that the sender authorizes to submit the transfer transaction. You can learn more about relayers HERE.


You can get the AVN_GATEWAY_URL and Relayer here.

const AVN_API = require("avn-api");
const AVN_GATEWAY_URL = "<node_url>";
const options = {
suri: "<account_suri>",
const API = new AVN_API(AVN_GATEWAY_URL, options);

async function main() {
await API.init();

let result = await API.send.withdrawUnlocked();
// Returns a request id

(async () => {
await main();

You have now successfully submitted a transaction to the AVN.


You can query the state of your transaction here using the returned request id.


This endpoint can only be called while the eraElectionWindow is closed. The status of the Election period can be checked here. If it is called during an election, the following error response will be returned:

"message":"Invalid Request",
"data": {
"gatewayError":"election window is open",