Staking Data
Objects

Reward Options

Learn about the Reward Option object type, its fields, and how to query staking mechanisms.

Reward Options

A reward option describes the mechanism by which validators or stakers receive compensation for their participation in the consensus process. There are two main participation methods:

  • Delegating — Indirect participation through third-party validators
  • Running validators — Direct infrastructure setup and transaction validation

Queryable Properties

The Reward Option object includes:

  • inputAssets — Assets used as input
  • outputAssets — Assets paid as rewards
  • validators — Connected validators using the reward option
  • providers — Connected service providers
  • metrics — Including lockup periods and performance data
  • type — Reward option type (ListItem)
  • chain — Chain information (ListItem)
  • isActive — Active status (Boolean)
  • rewardFormula — Formula for reward calculation (String)

Sample Queries

Query by Input Asset and Type

{
  rewardOptions(
    where: {
      inputAsset: { symbols: ["ETH"] }
      typeKeys: ["solo-staking", "pos"]
    }
    limit: 10
  ) {
    metrics(limit: 10) {
      metricKey
      defaultValue
      changePercentages
      createdAt
    }
  }
}

Search by Provider

{
  rewardOptions(limit: 10,
    where:{
      providers: {search: "rund"}
    }) {
    id
    providers(limit: 10) {
      name
    }
  }
}

Reward Options with Validators

This sample query returns the first 10 reward options that have ETH as an input asset, and the first 5 active validators for each reward option.

{
  rewardOptions(
    where: { inputAsset: { symbols: ["ETH"] } }
    limit: 10
  ) {
    id
    inputAssets(limit: 100) {
      slug
    }
    validators(limit: 5) {
      id
    }
  }
}

Input vs Output Assets:

  • inputAsset = token deposited (e.g., ETH)
  • outputAsset = proof of deposit received (e.g., stETH)

On this page