GET
Get staking totals at the enterprise level
Retrieve staking totals across all coins for a given enterprise, including delegated balances, rewards, and staking metadata.
Path Params
-
enterpriseIdstring requiredThe enterprise ID.
Query Params
-
pageinteger nullableThe page number for pagination. -
pageSizeinteger nullableThe page size for pagination. -
stakedbooleanFilter results to only include staked assets if true, or unstaked if false.
Responses
200
Successful response containing staking totals for the enterprise across all coins.
Response Body
object
-
enterpriseStakingInfoarray of objectsA paginated list of staking information for the enterprise, grouped by coin.enterpriseStakingInfo object
-
enterpriseIdstringThe ID of the enterprise where the staking request was created from. -
coinstringThe staking asset. -
delegatedstringThe delegated staked amount in base units. -
rewardsstringThe reward accrual amount in base units. -
apystringReward accrual annual percentage rate. Estimated yearly based on the last 7 days. Same methodology as leading beacon chain validator aggregators (e.g. https://beaconcha.in/validators). -
pendingStakestringThe pending stake amount in base units. -
pendingUnstakestringThe pending unstake amount in base units. -
pendingClaimRewardsstringThe pending claimable rewards in base units. -
baseUnitstringThe coin base unit (e.g., wei for ETH). -
isTokenbooleanTrue if the staking asset is a token. -
isTssbooleanTrue if the staking wallet uses threshold signatures (TSS). -
isMultiSigbooleanTrue if the staking wallet uses multisig. -
l1Chainstring nullableThe underlying L1 chain if the staking asset is on a different chain (e.g., ETH for L2 assets). -
comingSoonbooleanTrue if the staking feature for this asset is marked as coming soon. -
disclaimerobjectSpendable disclaimer attributes for a staking wallet.disclaimer object
-
stakingobjectDisclaimer information specific to staking.staking object
-
stakeWarmupPeriodDescstring nullableOptional description of the staking warmup period. -
rewardPercentageRatestring decimal nullableOptional reward percentage rate for staking. -
apyMarginOfErrorstring decimal nullableOptional margin of error for the APY rate. -
rewardsCompoundingbooleanTrue if rewards are compounded. -
periodobjectEstimation period details for staking.period object
-
periodLowstringLower bound of the period in seconds or blocks. -
periodHighstringUpper bound of the period in seconds or blocks. -
coinstringCoin associated with the period. -
typestring enumType of period (WARMUP, EXIT, COOLDOWN).WARMUPEXITCOOLDOWN
-
-
minStakestringMinimum amount required to stake. -
minStakeMorestring nullableMinimum additional amount to add to an active stake. -
stakingSubTypesarray of objects nullableOptional list of staking sub-types with their own disclaimers.stakingSubTypes object
-
typestringSub-type identifier. -
namestringSub-type display name. -
infoarray of stringsList of disclaimer messages for the sub-type. -
transactionsNeededintegerNumber of transactions required for the sub-type. -
rewardsCompoundingbooleanTrue if rewards are compounded for this sub-type. -
periodobjectEstimation period details for staking.period object
- Same shape as
EstimationPeriodAttributes.
- Same shape as
-
minStakestringMinimum staking amount for this sub-type. -
minStakeMorestring nullableOptional minimum additional stake required for this sub-type. -
urlstring nullableOptional URL for more information about this sub-type. -
iconNamestring nullableOptional icon name for UI representation. -
defaultApystring decimal nullableOptional default APY for this sub-type. -
stakeWarmupPeriodDescstring nullableOptional description of the staking warmup period for this sub-type. -
rewardPercentageRatestring decimal nullableOptional reward percentage rate for this sub-type. -
apyMarginOfErrorstring decimal nullableOptional margin of error for the APY rate for this sub-type. -
rewardCycleinteger nullableOptional time in seconds between reward distributions for this staking subtype. When present, this value overrides the base-level nextRewards.rewardCycle for this specific staking method.
-
-
infoarray of stringsList of disclaimer messages. -
transactionsNeededintegerNumber of transactions required.
-
-
unstakingobjectDisclaimer information specific to unstaking.unstaking object
-
unStakeCooldownPeriodDescstring nullableOptional description of the cooldown period before unstaking. -
periodobjectEstimation period details for staking.period object
- Same shape as
EstimationPeriodAttributes.
- Same shape as
-
unstakingSubTypesarray of objects nullableOptional list of unstaking sub-types with their own disclaimers.unstakingSubTypes object
-
namestringSub-type display name. -
typestringSub-type identifier. -
maxUnstakestring nullableOptional maximum unstakeable amount for this sub-type. -
unStakeCooldownPeriodDescstring nullableOptional human-readable description of the cooldown period for this sub-type. -
periodobjectEstimation period details for staking.period object
- Same shape as
EstimationPeriodAttributes.
- Same shape as
-
urlstring nullableOptional URL for more information about this unstaking sub-type. -
iconNamestring nullableOptional icon name for UI representation. -
infoarray of stringsList of disclaimer messages. -
transactionsNeededintegerNumber of transactions required.
-
-
infoarray of stringsList of disclaimer messages. -
transactionsNeededintegerNumber of transactions required.
-
-
claimRewardsobjectDisclaimer information for claiming rewards.claimRewards object
-
infoarray of stringsList of disclaimer messages. -
transactionsNeededintegerNumber of transactions required.
-
-
nextRewardsobjectInformation about the next rewards cycle.nextRewards object
-
rewardCycleintegerTime in seconds until the next reward cycle.
-
-
switchValidatorobjectDisclaimer information for switching validators.switchValidator object
-
cooldownPeriodstringCooldown period as a string (e.g., "24h"). -
infoarray of stringsList of disclaimer messages. -
transactionsNeededintegerNumber of transactions required.
-
-
-
walletCountintegerThe number of wallets with delegations in this enterprise for the given coin. -
rewardCoinstring nullableThe coin used for rewards (if different from the staked asset). -
rewardPairsarray of objectsReward pairs associated with the staking asset.rewardPairs object
-
tokenAddressstring nullableThe optional token address. -
amountstring requiredThe total amount of the reward pair in base units. -
activeAmountstring requiredThe currently active amount in base units. -
coinstring nullableThe optional coin for this reward pair.
-
-
-
pageintegerThe page number for paging purposes. -
totalPagesintegerThe total number of pages for paging purposes. -
totalElementsintegerThe number of elements per page used for paging purposes.
400
Bad Request
Response Body
object
-
errorstring -
errorNamestring -
reqIdstring -
contextobject
401
Unauthorized
Response Body
object
-
errorstring -
errorNamestring -
reqIdstring -
contextobject
403
Forbidden
Response Body
object
-
errorstring -
errorNamestring -
reqIdstring -
contextobject
404
Not Found
Response Body
object
-
errorstring -
errorNamestring -
reqIdstring -
contextobject
409
Conflict
Response Body
object
-
errorstring -
errorNamestring -
reqIdstring -
contextobject
500
Server Error - Transient error please try again
Response Body
object
-
errorstring -
errorNamestring -
reqIdstring -
contextobject