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 inputoutputAssets— Assets paid as rewardsvalidators— Connected validators using the reward optionproviders— Connected service providersmetrics— Including lockup periods and performance datatype— 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)
Related Types
- Assets — Staking assets
- Providers — Staking providers
- Validators — Validator nodes
- Metrics — Metric data points