Methods
Unless stated otherwise, thestartAt–finishAt range cannot exceed 31 days, and finishNumber cannot be lower than startNumber.
Get Validator Summary
Endpoint: GET /api/v1/{network}/data/validator/summary Supported networks: Ethereum, Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Description: Utilize this endpoint to obtain the general basic information about a validator for the period, such as the different types of rewards earned by the validator, the current stake and APY associated with the validator.Get Validator Stake
Endpoint: GET /api/v1/{network}/data/validator/stakes Supported networks: Ethereum, Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Description: Utilize this endpoint to monitor the current stake of a validator. Regularly check the stake data to assess the validator’s commitment and participation in the network.groupBy selects the aggregation: stakingPeriod (default) aggregates by epoch, day aggregates by calendar day. groupBy=day cannot be combined with startNumber / finishNumber; use startAt / finishAt instead, otherwise the request returns 400.
stake is the total stake balance of the validator. On Ethereum it includes ETH that is still in the deposit or activation queue. With groupBy=day on Ethereum, the response additionally contains the optional fields activeStake (already active on the Beacon Chain) and inactiveStake (still waiting to be activated), which together make up stake. On other networks groupBy=day currently falls back to the staking-period grouping and these two fields are not returned.
Get Validator Rewards
Endpoint: GET /api/v1/{network}/data/validator/rewards Supported networks: Ethereum, Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Description: Utilize this endpoint to track the different types of rewards earned by the validator. Monitor reward data to assess the validator’s performance and profitability.Get Validator APY
Endpoint: GET /api/v1/{network}/data/validator/apy Supported networks: Ethereum, Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Description: Utilize this endpoint to understand the APY associated with the validator. Regularly check APY data for insights into the validator’s long-term performance.Get Validator Fee
Endpoint: GET /api/v1/{network}/data/validator/fee Supported networks: Ethereum, Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Description: Utilize this endpoint to assess the fees charged by the validator. Monitor fee data to understand the financial implications of choosing a particular validator.Get Validator Name
Endpoint: GET /api/v1/{network}/data/validator/name Supported networks: Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Ethereum is not supported. Description: Utilize this endpoint to know the name of the validator.Get Validator State
Endpoint: GET /api/v1/{network}/data/validator/state Supported networks: Ethereum, Solana, Polkadot, Kusama, Sui, TON, Cardano, Celestia. Description: Utilize this endpoint to know the state of the validator. To monitor the number of delegators, use the network-level Get Delegators Count endpoint; there is no per-validator delegators count.Get Validator Statuses
Endpoint: GET /api/v1/{network}/data/validator/statuses Supported networks: Ethereum. Description: Utilize this method to obtain the number of validators created via Staking API in each status. This allows identifying any changes, such as transitions from waiting to active or instances of slashing, and staying informed that you are supporting a reliable and actively participating validator.Get Validator Statuses Detailed
Endpoint: GET /api/v1/{network}/data/validator/statuses/detailed Supported networks: Ethereum. Description: Utilize this method to obtain the status of each individual validator created via Staking API, along with the total count. Each list item contains the validator public key (validator) and its status; use it when the per-status counts from Get Validator Statuses are not granular enough.