Staking State Information

List staking validators for a wallet

Changed on

Returns a list of staking validators for a wallet, and includes the total delegated amount and the amount of accrued rewards.

get/api/staking/v1/{coin}/wallets/{walletId}/validators

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/staking/v1/{coin}/wallets/{walletId}/validators
  • Auth
    none declared

Path parameters

coin'ADA' | 'APT' | 'ASI' | 'KAVACOSMOS' | 'ATOM' | 'AVAXC' | 'AVAXP' | 'BABY' | 'BERA' | 'BLD' | 'BSC' | 'BTC' | 'COREDAO' | 'COREUM' | 'CRONOS' | 'CSPR' | 'DOT' | 'EIGEN' | 'ETH' | 'FLRP' | 'HASH' | 'HYPEEVM' | 'INJECTIVE' | 'MATIC' | 'NEAR' | 'OSMO' | 'POL' | 'POLYX' | 'RETH-ROCKET' | 'SEI' | 'SOMI' | 'SOL' | 'STORY' | 'STX' | 'SUI' | 'SUI:WAL' | 'TAO' | 'TIA' | 'TON' | 'TRX' | 'WETH' | 'WCT' | 'WFLR' | 'XDC' | 'ZETA' required

The staking asset.

walletIdstring required
Example:59cd72485007a239fb00282ed480da1f

The wallet ID.

Query parameters

pageinteger nullable

The page number for pagination.

pageSizeinteger nullable

The page size for pagination.

statusDelegationStatus[]

Comma-separated list of delegation statuses to filter by. Defaults to ACTIVE,PENDING.

validatorAddressstring

Validator address to filter results by. Expect 1 item only.

subTypestring

The delegation staking sub type to filter by (e.g., LIDO, MARINADE, JITO for liquid staking variants).

unstakeableboolean

ETH only. When true, only delegations that can currently be unstaked are aggregated (ACTIVE, not exiting, and active for at least 256 finalized epochs), so the per-provider delegated amount matches the unstakeable delegations list. If the beacon finality lookup fails the request returns an error instead of the unfiltered amounts. Ignored for other coins. Defaults to false.

Response

Successful Retrieving Staking Validators For A Wallet

pageinteger

The page number for paging purposes.

totalPagesinteger

The total number of pages for paging purposes.

totalElementsinteger

The number of elements per page used for paging purposes.

Changes