View Delegation Details

Overview

Staking delegates assets to a staking address. Depending on the asset, the staking address could be the validator's address, an address linked to your wallet, or a smart-contract address.

Depending on the asset, multiple staking requests could result in 1 or more staking delegations. For example, ETH is staked in multiples of 32, and if you create a staking request for 64 ETH, it results in 2 staking delegations. Conversely, NEAR doesn't require staking in multiples. You can create multiple NEAR staking requests, from the same wallet, all the requests tie to the same staking delegation.

Once staked, you can retrieve the following details from a delegation:

  • Delegated balance
  • Delegation address
  • Delegation ID
  • Expected APR or APY
  • Rewards accrued on the delegation
  • Withdrawal address (for unstaking)

Prerequisites

Steps

  • SDK
  • API
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 export const BitgoWalletDelegationsQuery = gql` query BitgoWalletDelegationsQuery($coin: String!, $walletId: String!) { bitgoWalletDelegations(coin: $coin, walletId: $walletId) @rest( type: "BitgoWalletDelegationsResponse" path: "api/staking/v1/{args.coin}/wallets/{args.walletId}/delegations" ) { delegations { id delegationsAddress withdrawalAddress delegated coin walletId status rewards pendingUnstake apy unstakingMin unstakingFee } page totalPages totalElements } } `;

Step Result

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 { "page": 1, "totalPages": 1, "totalElements": 2, "delegations": [ { "id": "e0225adbc-66a3-4ccd-9a9d-726a05bca0cf", "delegationAddress": "0x5a6406c9710f588ca733360bfa8033d0ef9ecdy5", "withdrawalAddress": "0x5a6406c9710f588ca733360bfa8033d0ef9ecd7c", "delegated": 3200000000000000000, "status": "ACTIVE", "rewards": 0, "pendingUnstake": 3200000000000000000, "apy": 8.3, "coin": "eth", "walletId": "2032e75g451052000636831abd797bd3", "unstakingFee": 100000000000000, "unstakingMin": 0 }, { "id": "e0225adbc-55b43-5tta-9a9d-726a05bca0ai", "delegationAddress": "0x3b6406c9710f588ca733360bfa8033d0ef9ecre4", "withdrawalAddress": "0x5a6406c9710f588ca733360bfa8033d0ef9ecd7c", "delegated": 3200000000000000000, "status": "ACTIVE", "rewards": 0, "pendingUnstake": 0, "apy": 8.3, "coin": "eth", "walletId": "2032e75g451052000636831abd797bd3", "unstakingFee": 1000000000000000, "unstakingMin": 0 } ] }

Next Steps

Use the delegation ID to Create Unstaking Request.

See Also

API Reference: Retrieve Staking Wallet Delegations