Guides

Stake Pool Delegation#

Stake pool delegation allows users to participate in Cardano's consensus protocol by delegating their stake to a pool that produces blocks. By integrating stake pool delegation into your application, you enable users to earn rewards while supporting the network's security and decentralization without requiring technical expertise in running validator nodes.

API Endpoint#

URL: https://preprod.api.ada-anvil.app/v2/services/transactions/build
Method: POST
Headers: Content-Type: application/json, x-api-key: YOUR_API_KEY

Request Format#

{
  "changeAddress": "addr_test1...",
  "utxos": ["8282...", "8282..."],
  "delegations": [
    {
      "type": "pool",
      "address": "addr_test1...",
      "keyHash": "pool1z5uq..."
    }
  ]
}

Parameter Details#

Parameter Description Example
type Must be "pool" "pool"
address User's full address "addr_test1..."
keyHash Pool ID to delegate to "pool1z5uq..."
utxos Array of UTXOs in CBOR hex format ["8282...", "8282..."]

Implementation Examples#

Using Fetch API:

Deno & FetchUsing Deno & fetch to delegate to a stake pool.

Using cURL:

Bash & cURL

Transaction Signing#

After building the transaction, it must be signed before submission:

Sign Transaction

User Interface Examples#

Stake Pool Delegation

Eternl's Stake Pool delegation interface provides a good reference