Skip To Content

Blockdaemon Documentation

Post Stake Intent

The Staking Integration API endpoint in this page allows you to create your stake intents.

POST Create a New Stake Intent
Authentication Using API Key as an X-API-Key


POST Create a New Stake Intent

https://svc.blockdaemon.com/boss/v1/{protocol}/{network}/stake-intents

Creates a transaction that will attach Blockdaemon as a proxy account for the specified controller account. This will allow Blockdaemon to nominate on behalf of the customer and to continuously optimise the nominations of the controller account in order to achieve the best possible rewards.

Learn more: Polkadot API Usage Example

Note: You need to authorize your request via an API key provided when signing up for a staking account.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • polkadot/mainnet

Supported Networks

Here is a full list of supported networks with their path parameters:

Protocol Network Path parameters
Polkadot Mainnet polkadot/mainnet
Polkadot Westend polkadot/westend

Example Query

To create a new stake intent in the Polkadot Mainnet, use the following:

https://svc.blockdaemon.com/boss/v1/polkadot/mainnet/stake-intents

Request Body

In the request body you need to specify the following:

  • controller_address: The Polkadot account address in SS58 format

Example Request Body

{
    "controller_address": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty"
}

Response Example

The following is a typical response from POST Create a New Stake Intent:

{
    "stake_intent_id": "stake_intent_Wgx98Rbi8nQuL9ddn3mTk1",
    "protocol": "polkadot",
    "network": "mainnet",
    "polkadot": {
      "unsigned_transaction": "0xa4041d0100e659a7a1628cdd93febc04a4e0646ea20e9f5f0ce097d9a05290d4a9e054df4e0100000000",
      "controller_address": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty",
      "proxy_address": "16D2eVuK5SWfwvtFD3gVdBC2nc2BafK31BY6PrbZHBAGew7L"
    }
}

Authentication Using API Key as an X-API-Key

When signing up for a staking account, you are provided with an API key.

To authenticate a Staking API request, pass your API key in the X-API-Key header:

curl -X POST \
'https://svc.blockdaemon.com/boss/v1/polkadot/mainnet/stake-intents' \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"controller_address": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty"}'

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.