Polkadot Staking

Instructions: https://help.allnodes.com/en/articles/6730085-polkadot-staking-api

Bond coins (initial)

POST https://www.allnodes.com/api/v1/staking

This endpoint allows you to get serialized unsigned transaction for initial bond coins.

Headers

Name	Type	Description
Authorization*	string	Bearer TOKEN

Request Body

Name	Type	Description
currencySymbol*	string	Must be "DOT"
action*	string	Must be "initial-bond"
address*	string	Your wallet address (will be used as stash account)
controller*	string	Your wallet address (will be used as controller account)
payee*	string	"stash-reinvest" | "stash-save" | "controller"
amount*	string	Amount to stake (in DOT)

200: OK Serialized transaction successfully generated.

{
  serializedTransaction: string;
}

400: Bad Request Example of error response.

{
  "error": "INVALID_ADDRESS"
}

Bond extra coins

POST https://www.allnodes.com/api/v1/staking

This endpoint allows you to get serialized unsigned transaction for bonding extra coins.

Headers

Name	Type	Description
Authorization*	string	Bearer TOKEN

Request Body

Name	Type	Description
currencySymbol*	string	Must be "DOT"
action*	string	Must be "bond-extra"
address*	string	Your wallet address (stash account)
amount*	string	Amount to bond (in DOT)

200: OK Serialized transaction successfully generated.

{
  serializedTransaction: string;
}

400: Bad Request Example of error response.

{
  "error": "INVALID_AMOUNT"
}

Nominate validators

POST https://www.allnodes.com/api/v1/staking

This endpoint allows you to get serialized unsigned transaction for nominate validators.

Headers

Name	Type	Description
Authorization*	string	Bearer TOKEN

Request Body

Name	Type	Description
currencySymbol*	string	Must be "DOT"
action*	string	Must be "nominate"
address*	string	Your wallet address (stash account)
validators*	string[]	Addresses of validators to nominate (up to 16 unique addresses)

200: OK Serialized transaction successfully generated.

{
  serializedTransaction: string;
}

400: Bad Request Example of error response.

{
  "error": "VALIDATORS_UNIQ_ERROR"
}

Unbond coins

POST https://www.allnodes.com/api/v1/staking

This endpoint allows you to get serialized unsigned transaction for unbonding coins.

Headers

Name	Type	Description
Authorization*	string	Bearer TOKEN

Request Body

Name	Type	Description
currencySymbol*	string	Must be "DOT"
action*	string	Must be "unbond"
address*	string	Your wallet address (stash account)
amount*	string	Amount to unbond (in DOT)

200: OK Serialized transaction successfully generated.

{
  serializedTransaction: string;
}

400: Bad Request Example of error response.

{
  "error": "NOT_ENOUGH_AMOUNT"
}

Withdraw stake (after unbonding period finished)

POST https://www.allnodes.com/api/v1/staking

This endpoint allows you to get serialized unsigned transaction for withdraw stake. Unbonding period: 28 days

Headers

Name	Type	Description
Authorization*	string	Bearer TOKEN

Request Body

Name	Type	Description
currencySymbol*	string	Must be "DOT"
action*	string	Must be "withdraw-stake"
address*	string	Your wallet address (stash account)

200: OK Serialized transaction successfully generated.

{
  serializedTransaction: string;
}

400: Bad Request Example of error response.

{
  "error": "INVALID_ERA_FOR_WITHDRAW"
}