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"}'