--- updatedAt: 2026-05-20T06:31:25.000Z --- Fetch the complete documentation index at: https://docs.blockdaemon.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version. # List Your Stake Intents Retrieve a list of all outstanding stake intents. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "version": "1.0.0", "title": "Staking API", "description": "The Blockdaemon Staking API simplifies and streamlines institutional cryptocurrency staking. The API allows developers to interact with blockchain networks and perform various staking-related operations, such as delegating and undelegating tokens, in a single, unified interface.\n\nWith the Staking API, you can quickly and easily build and deploy applications that automate staking activities and increase efficiency in your blockchain operations.", "contact": { "name": "Blockdaemon", "email": "info@blockdaemon.com", "url": "https://blockdaemon.com" }, "x-logo": { "url": "https://assets-global.website-files.com/633c5e06513fa35f3391a5f9/645d33beb6fa65f6cfb95eb8_BD%20Logo%20Stack%20-%20Purple.svg", "backgroundColor": "#fafafa", "altText": "Blockdaemon logo" } }, "x-readme": { "explorer-enabled": false }, "servers": [ { "url": "https://svc.blockdaemon.com/boss" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "description": "When signing up for a staking account, you are provided with an API key.\n\nTo authenticate a Staking API request, pass your API key in the `X-API-Key` header.", "type": "apiKey", "in": "header", "name": "X-API-KEY" } }, "parameters": { "Page": { "in": "query", "name": "page", "required": false, "schema": { "type": "integer", "format": "int64", "minimum": 1, "default": 1 }, "description": "The result set page to view" }, "PerPage": { "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer", "format": "int64", "minimum": 1, "maximum": 1000, "default": 250 }, "description": "The number of items to include on a single page" } }, "responses": { "InternalServerError": { "description": "Internal server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "ListStakeIntents": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StakeIntentList" } } } } }, "schemas": { "CosmosAccountAddress": { "type": "string", "description": "Public Key of an asymmetric key-pair.", "format": "bech32", "pattern": "^cosmos[1-9a-zA-Z]{39}$", "example": "cosmos1wvvhhfm387xvfnqshmdaunnpujjrdxznr5d5x9" }, "BinanceAccountAddress": { "type": "string", "description": "Binance beacon chain address.", "format": "bech32", "pattern": "^bnb[0-9a-z]+$", "example": "bnb13ym5szfmwh0wz9j8wr2lu2gaml94h895u9el2e" }, "CustomerId": { "type": "string", "description": "Unique identifier for a customer", "example": "SatoshiNakamoto-xUYJbPw9hw", "minimum": 1 }, "Error": { "type": "object", "description": "Error response envelope", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "format": "int32", "description": "Error code", "example": 500 }, "message": { "type": "string", "description": "Error Message", "example": "A descriptive error message" } } }, "EthereumAddress": { "type": "string", "description": "Hex-encoded Ethereum [account or smart contract address](https://ethereum.org/en/developers/docs/accounts/).", "format": "hex", "pattern": "^0x[a-fA-F0-9]{40}$", "example": "0x00000000219ab540356cBB839Cbe05303d7705Fa" }, "EthereumWithdrawalCredentials": { "type": "string", "format": "hex", "pattern": "^0x0(0|1)[a-fA-F0-9]{62}$", "example": "0x0092c20062cee70389f1cb4fa566a2be5e2319ff43965db26dbaa3ce90b9df99", "description": "Hexadecimal encoded [withdrawal credentials](https://github.com/ethereum/consensus-specs/blob/master/specs/phase0/validator.md#withdrawal-credentials) which can be either a BLS public key or an Ethereum account address.\n\nThis parameter currently accepts ETH1 and BLS withdrawal credentials, but it is considered deprecated after the Capella/Shanghai fork. All users are now advised to use an ETH1 withdrawal address, specified through the `withdrawal_address` parameter as this is required to enable the ongoing accrual of rewards.\n\nFor more information regarding creating withdrawal credentials, please see the official [Ethereum Launchpad FAQ](https://launchpad.ethereum.org/en/faq#withdrawal-credentials)." }, "Gwei": { "type": "string", "description": "Amount of ETH (denominated in Gwei).", "pattern": "^[1-9]\\d{10,}$", "example": "32000000000" }, "Lamport": { "type": "string", "description": "Denomination of the cryptocurrency Solana.", "pattern": "^[1-9]\\d+$", "example": "100" }, "Network": { "type": "string", "description": "Protocol-specific network.", "enum": [ "mainnet", "localnet", "goerli", "prater", "hoodi", "testnet", "devnet", "kusama", "westend", "preprod", "fuji", "local" ] }, "Pagination": { "type": "object", "description": "encapsulates pagination properties", "required": [ "page", "per_page", "total" ], "properties": { "page": { "description": "current page number", "type": "integer", "format": "int64" }, "per_page": { "description": "number of results per page", "type": "integer", "format": "int64" }, "total": { "description": "total number of results", "type": "integer", "format": "int64" } } }, "PlanId": { "type": "string", "description": "This feature enables you to stake to validators from the specified plan(s). When no plan id is specified, validators across all plans that match the API route will be available for staking. If it is a shared plan, you can to stake to validators on a shared node from the specified plan.", "example": "plan_Wgx98Rbi8nQuL9ddn3mTk1" }, "PolkadotAddress": { "type": "string", "description": "Polkadot account address in [SS58 format](https://wiki.polkadot.network/docs/learn-account-advanced#address-format).", "format": "base58", "pattern": "^[1-9A-HJ-NP-Za-km-z]{44}$", "example": "5xot9PVkphiX2adznghwrAuxGs2zeWisNSxMW6hU6Hkj" }, "Protocol": { "type": "string", "description": "Blockchain protocol.", "enum": [ "ethereum", "polkadot", "solana", "cosmos", "polygon", "near", "cardano", "avalanche", "binance" ] }, "PublicKey": { "type": "string", "description": "A BLS public Key.", "format": "base64", "example": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c" }, "SolanaPublicKey": { "type": "string", "description": "Public Key of an asymmetric key-pair.", "format": "base58", "pattern": "^[1-9A-HJ-NP-Za-km-z]{44}$", "example": "5xot9PVkphiX2adznghwrAuxGs2zeWisNSxMW6hU6Hkj" }, "StakeId": { "description": "Unique stake identifier.", "type": "string", "format": "base58", "example": "stake_Wgx98Rbi8nQuL9ddn3mTk1" }, "StakeIntent": { "type": "object", "required": [ "stake_intent_id", "protocol", "network", "customer_id" ], "properties": { "stake_intent_id": { "$ref": "#/components/schemas/StakeIntentId" }, "protocol": { "$ref": "#/components/schemas/Protocol" }, "network": { "$ref": "#/components/schemas/Network" }, "ethereum": { "$ref": "#/components/schemas/StakeIntentEthereum" }, "polkadot": { "$ref": "#/components/schemas/StakeIntentPolkadot" }, "solana": { "$ref": "#/components/schemas/StakeIntentSolana" }, "cosmos": { "$ref": "#/components/schemas/StakeIntentCosmos" }, "binance": { "$ref": "#/components/schemas/StakeIntentBinance" }, "polygon": { "$ref": "#/components/schemas/StakeIntentPolygon" }, "near": { "$ref": "#/components/schemas/StakeIntentNear" }, "cardano": { "$ref": "#/components/schemas/StakeIntentCardano" }, "avalanche": { "$ref": "#/components/schemas/StakeIntentAvalanche" }, "customer_id": { "$ref": "#/components/schemas/CustomerId" }, "plan_id": { "$ref": "#/components/schemas/PlanId" }, "created_at": { "$ref": "#/components/schemas/Timestamp" }, "updated_at": { "$ref": "#/components/schemas/Timestamp" } } }, "StakeIntentCardano": { "type": "object", "description": "Cardano Protocol Stake Intent", "required": [ "pool_id", "unsigned_transaction", "base_address" ], "properties": { "pool_id": { "$ref": "#/components/schemas/CardanoPoolId" }, "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction" }, "base_address": { "$ref": "#/components/schemas/CardanoBaseAddress" } } }, "StakeIntentCosmos": { "type": "object", "description": "Cosmos Stake Intent response", "required": [ "unsigned_transaction", "amount", "delegator_address", "validator_address" ], "properties": { "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction" }, "delegator_address": { "$ref": "#/components/schemas/CosmosAccountAddress" }, "validator_address": { "$ref": "#/components/schemas/CosmosAccountAddress" }, "amount": { "$ref": "#/components/schemas/CosmosUatom" }, "hex_transaction": { "$ref": "#/components/schemas/ProcessedComosTransaction" } } }, "StakeIntentBinance": { "type": "object", "description": "Binance Stake Intent response", "required": [ "unsigned_transaction", "amount", "delegator_address", "validator_address" ], "properties": { "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction" }, "delegator_address": { "$ref": "#/components/schemas/BinanceAccountAddress" }, "validator_address": { "$ref": "#/components/schemas/BinanceValidatorAddress" }, "amount": { "$ref": "#/components/schemas/BinanceJager" } } }, "StakeIntentEthereum": { "type": "object", "description": "Ethereum Stake Intent response", "required": [ "stakes", "contract_address", "unsigned_transaction", "estimated_gas", "expiration_time" ], "properties": { "stakes": { "description": "Stakes being made.", "type": "array", "items": { "$ref": "#/components/schemas/StakeIntentEthereumStake" } }, "contract_address": { "$ref": "#/components/schemas/EthereumAddress" }, "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction" }, "estimated_gas": { "$ref": "#/components/schemas/EthereumGas" }, "expiration_time": { "$ref": "#/components/schemas/ExpirationTime" } } }, "StakeIntentEthereumStake": { "type": "object", "description": "Individual Ethereum Stake Response", "required": [ "stake_id", "amount", "validator_public_key", "withdrawal_credentials", "fee_recipient" ], "properties": { "stake_id": { "$ref": "#/components/schemas/StakeId" }, "amount": { "$ref": "#/components/schemas/Gwei" }, "validator_public_key": { "$ref": "#/components/schemas/PublicKey" }, "withdrawal_credentials": { "$ref": "#/components/schemas/EthereumWithdrawalCredentials" }, "fee_recipient": { "$ref": "#/components/schemas/FeeRecipient" } } }, "StakeIntentId": { "type": "string", "format": "base58", "description": "Unique idenifier for a group of stakes.", "example": "stake_intent_Wgx98Rbi8nQuL9ddn3mTk1" }, "StakeIntentList": { "type": "object", "required": [ "stake_intents", "pagination" ], "properties": { "stake_intents": { "type": "array", "description": "List of stake intents", "items": { "$ref": "#/components/schemas/StakeIntent" } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "StakeIntentPolkadot": { "type": "object", "description": "Polkadot Stake Intent Response", "required": [ "stake_id", "unsigned_transaction", "proxy_address" ], "properties": { "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransactionPolkadotStakeIntent", "description": "Unsigned transaction that bonds a Blockdaemon's proxy account to the given customer account.\nOnce this transaction is signed, broadcasted to the network and included in the canonical history of the chain, the proxy account will be associated with the customer account." }, "customer_address": { "$ref": "#/components/schemas/PolkadotAddress", "description": "Address of the customer account to associate with the proxy account." }, "controller_address": { "$ref": "#/components/schemas/PolkadotAddress", "description": "Address of the customer account to associate with the proxy account.\nSame as customer_address. Deprecated - will be removed in a later version." }, "proxy_address": { "$ref": "#/components/schemas/PolkadotAddress", "description": "Address of the proxy account to associate with the customer account." } } }, "StakeIntentPolygon": { "type": "object", "description": "Polygon Stake Intent", "required": [ "to", "unsigned_transaction", "amount", "wallet_address" ], "properties": { "to": { "$ref": "#/components/schemas/EthereumAddress" }, "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction" }, "amount": { "$ref": "#/components/schemas/Wei" }, "wallet_address": { "$ref": "#/components/schemas/EthereumAddress" } } }, "StakeIntentSolana": { "type": "object", "description": "Solana Stake Intent response", "required": [ "stake_id", "amount", "validator_public_key", "withdrawal_authority", "staking_authority", "stake_account_public_key", "unsigned_transaction", "expiration_time" ], "properties": { "stake_id": { "$ref": "#/components/schemas/StakeId" }, "amount": { "$ref": "#/components/schemas/Lamport" }, "validator_public_key": { "$ref": "#/components/schemas/PublicKey" }, "staking_authority": { "$ref": "#/components/schemas/SolanaPublicKey" }, "withdrawal_authority": { "$ref": "#/components/schemas/PublicKey" }, "stake_account_public_key": { "$ref": "#/components/schemas/SolanaPublicKey" }, "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction" }, "expiration_time": { "$ref": "#/components/schemas/ExpirationTime" } } }, "Timestamp": { "description": "Timestamp", "type": "string", "example": "2023-01-11 06:22:46.182" }, "CosmosUatom": { "type": "string", "description": "Denomination of the cryptocurrency Cosmos.", "pattern": "^[1-9]\\d+$", "example": "100" }, "BinanceJager": { "type": "string", "description": "The smallest denomination of Binance Coin (BNB) is called Jager. 1 Jager =0.00000001 BNB.", "pattern": "^[1-9]\\d+$", "example": "10000000000" }, "UnsignedTransaction": { "type": "string", "format": "base64", "description": "Generated unsigned transaction smart contract call data.", "example": "0x22895118000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120087fed394b43849eebef1e88873cd9efdbe33136656e5148e659b8b2f33625d40000000000000000000000000000000000000000000000000000000000000030b81748644e23c4d950f9dd709f3eb73d5eacd9657997e1d9dde7c4ebd8a6519ecb9d0a7fb603d3b68e023278f9650122000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020010000000000000000000000c509bb854c526af4cee5e037089f7aa8e091d8870000000000000000000000000000000000000000000000000000000000000060b36b79b4b206c0310472c117fa40c05342b5dc3e89f98f42c9da3ce6450d4c603cad55248017fd4eca3ab277cca64569193e4d487f5b2ea78a2bcdc81926c313c05842a3af318967a775783bba22519e8b8886587efa99aa7dab5784f792b187\n" }, "UnsignedTransactionHash": { "type": "string", "format": "base64", "description": "A generated transaction that is ready to sign.", "example": "120000007465737477616c6c65742e746573746e65740025150c44ecddfe779c2ca " }, "UnsignedTransactionPolkadotStakeIntent": { "type": "string", "format": "base64", "description": "Generated Polkadot unsigned transaction for the provided stake intent details.", "example": "0xa4041601008c16e19e94328985d65cb7e3245213892730dd0e841f6511478cb12f23a178330100000000" }, "Wei": { "type": "string", "description": "Denomination of the cryptocurrency Polygon.", "pattern": "^[1-9]\\d+$", "example": "100" }, "FeeRecipient": { "type": "string", "description": "An Ethereum address to receive transaction fees from published blocks. 20-bytes, hex encoded with 0x prefix, case insensitive.", "example": "0x93247f2209abcacf57b75a51dafae777f9dd38bc", "pattern": "^0x[a-fA-F0-9]{40}$" }, "NearAddress": { "type": "string", "description": "Base58 encoded public key or registered named account. [Accounts](https://docs.near.org/concepts/basics/accounts/account-id/).", "pattern": "^([a-km-zA-HJ-NP-Z1-9]{22,44})|((([a-z\\d]+[-_])*[a-z\\d]+\\.)*([a-z\\d]+[-_])*[a-z\\d]+)$", "example": "alice.near" }, "NearYocto": { "type": "string", "description": "Denomination of NEAR Protocol.", "pattern": "^[1-9]\\d+$", "example": "100000000000000000000000000" }, "StakeIntentNear": { "type": "object", "description": "NEAR Protocol Stake Intent", "required": [ "to", "unsigned_transaction", "unsigned_transaction_hash", "amount", "wallet_address", "public_key", "expiration_time" ], "properties": { "to": { "$ref": "#/components/schemas/NearAddress" }, "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction", "example": "120000007465737477616c6c65742e746573746e65740025150c44ecddfe779c2ca624cae002ef5bf6efbb9167fe3920d6595163574dc585ca49a33e2f0000170000006e6f64656173792e706f6f6c2e663836333937332e6d308e9076d7ec46d5c1d876bb5461c4a31469d50825695a1a23ee873ed532cadb2f0100000002110000006465706f7369745f616e645f7374616b65020000007b7d00c06e31d9100100000000e4d20cc8dcd2b7520000000000" }, "unsigned_transaction_hash": { "$ref": "#/components/schemas/UnsignedTransactionHash" }, "amount": { "$ref": "#/components/schemas/NearYocto" }, "wallet_address": { "$ref": "#/components/schemas/NearAddress" }, "public_key": { "$ref": "#/components/schemas/NearPublicKey" }, "expiration_time": { "$ref": "#/components/schemas/ExpirationTime" } } }, "NearPublicKey": { "type": "string", "description": "Base58 encoded public key prefixed by ed25519, associated with the private key that will be used to sign the transaction.", "example": "ed25519:Cxg2wgFYrdLTEkMu6j5D6aEZqTb3kXbmJygS48ZKbo1S", "pattern": "^ed25519:[a-km-zA-HJ-NP-Z1-9]{22,44}$" }, "CardanoBaseAddress": { "type": "string", "description": "bech32 encoded base address. [Accounts](https://cips.cardano.org/cips/cip19/).", "format": "bech32", "example": "addr1vpu5vlrf4xkxv2qpwngf6cjhtw542ayty80v8dyr49rf5eg0yu80w" }, "EthereumGas": { "type": "integer", "description": "Gas estimation of the transaction", "format": "uint64", "example": 1001 }, "CardanoPoolId": { "type": "string", "description": "bech32 encoded pool id.", "format": "bech32", "example": "pool1ev8fwfccn8gr0zcz3uyps0t0mcrefc6s95wjc6aed3ngc86y5rk" }, "ExpirationTime": { "type": "integer", "description": "Transaction expiration time", "format": "int64", "example": 1689939023 }, "AvalancheAddress": { "type": "string", "description": "Avalanche platform chain address", "pattern": "^([P]|[a-km-zA-HJ-NP-Z1-9]{36,72})-[a-zA-Z]{1,83}1[qpzry9x8gf2tvdw0s3jn54khce6mua7l]{38}$", "example": "P-fuji1g2g0jxcfn5sp59ld7g0t0tp4jrqppvqcfqc7hy" }, "AvalancheValidatorAddress": { "type": "string", "description": "Avalanche validator node address", "pattern": "^NodeID-[A-Za-z0-9]{43}$", "example": "NodeID-B19uSxUKerjjnA215czAJLHMqNJMbsAMWuSxUKerjjW" }, "AvalancheStakingTimestamp": { "type": "integer", "description": "Avalanche staking start time", "format": "int64", "example": 1689939023 }, "AvalancheNano": { "type": "string", "description": "Denomination of Avalanche.", "pattern": "^[1-9]\\d+$", "example": "10000000000" }, "StakeIntentAvalanche": { "type": "object", "description": "Avalanche Stake Intent", "required": [ "validator_address", "unsigned_transaction", "amount", "delegator_address", "start_time", "end_time" ], "properties": { "validator_address": { "$ref": "#/components/schemas/AvalancheValidatorAddress" }, "unsigned_transaction": { "$ref": "#/components/schemas/UnsignedTransaction", "example": "120000007465737477616c6c65742e746573746e65740025150c44ecddfe779c2ca624cae002ef5bf6efbb9167fe3920d6595163574dc585ca49a33e2f0000170000006e6f64656173792e706f6f6c2e663836333937332e6d308e9076d7ec46d5c1d876bb5461c4a31469d50825695a1a23ee873ed532cadb2f0100000002110000006465706f7369745f616e645f7374616b65020000007b7d00c06e31d9100100000000e4d20cc8dcd2b7520000000000" }, "amount": { "$ref": "#/components/schemas/AvalancheNano" }, "delegator_address": { "$ref": "#/components/schemas/AvalancheAddress" }, "start_time": { "$ref": "#/components/schemas/AvalancheStakingTimestamp", "description": "Avalanche staking start time" }, "end_time": { "$ref": "#/components/schemas/AvalancheStakingTimestamp", "description": "Avalanche staking end time" } } }, "BinanceValidatorAddress": { "type": "string", "description": "Binance beacon chain validator address.", "format": "bech32", "pattern": "^bva[0-9a-zA-Z]*$", "example": "bva1mrpf5n5e5knn3z9qng5pnex3m9pvyhg6434j0t" }, "ProcessedComosTransaction": { "type": "object", "description": "Returns back the transactionHash and unsignedTxHex for signing purposes", "required": [ "transactionHash", "unsignedTxHex" ], "properties": { "transaction_hash": { "type": "string", "description": "The SHA-256 hash of the signable transaction in hexadecimal format.", "example": "BD2B84693A0AE959C63A8D4D1F77125449312EED64E53C654D2D7F07E4592BAE" }, "unsigned_transaction_hex": { "type": "string", "description": "The original unsigned transaction encoded in hexadecimal format.", "example": "APOENA93A0AE959C63A8D4D1F77125449312EED64E53C654D2D7F07E4592BAAF" } } } } }, "security": [ { "ApiKeyAuth": [] } ], "paths": { "/v1/stake-intents": { "get": { "summary": "List Your Stake Intents", "operationId": "listStakeIntents", "tags": [ "General" ], "description": "Retrieve a list of all outstanding stake intents.", "parameters": [ { "name": "protocols", "in": "query", "required": false, "description": "Protocol(s) to list stake intents for (one per argument).", "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Protocol" } } }, { "name": "networks", "in": "query", "required": false, "description": "Network(s) to list stake intents for (one per argument).", "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Network" } } }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "name": "from_time", "in": "query", "required": false, "description": "Filter stake intents created on or after this time.", "schema": { "$ref": "#/components/schemas/Timestamp" } }, { "name": "to_time", "in": "query", "required": false, "description": "Filter stake intents created on or before this time.", "schema": { "$ref": "#/components/schemas/Timestamp" } } ], "responses": { "200": { "$ref": "#/components/responses/ListStakeIntents" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "security": [ { "ApiKeyAuth": [] }, { "BearerAuth": [] } ] } } }, "tags": [ { "name": "General", "description": "General endpoints" } ] } ```