Schema & Objects

The Staking Rewards API is built on GraphQL, providing a strongly-typed schema that defines all available types, fields, and relationships. This page covers the core object types, their fields, and how they relate to each other.

Object Relationships

Reward Options (Core Concept)

Reward Options are the core and center of the API. Each Reward Option connects to an Asset, Validator, Chain, and Provider.

Examples of Reward Options:

• Depositing ETH into Lido yields stETH
• Staking stETH in Curve produces CRV rewards
• Converting ETH to WETH via smart contract

How Objects Connect

• Metrics are connected to Assets, Reward Options, Providers, and Validators for storing individual object data. This allows you to query performance metrics, staking data, and historical information for any entity.
• Assets are only connected to Reward Options, Metrics, and other Assets — not directly to Validators or Providers. To access provider or validator information for an asset, you must go through Reward Options.
• Validators are connected only to Reward Options and Metrics. They are relevant through Provider relationships, as providers operate validators across different networks.
• Providers are connected to Reward Options, their own Reward Option Types, and Metrics. They represent the entities that offer staking services.

Relationship Diagram

                     Assets
                       ^
                       |
  Providers <-- Reward Options --> Validators
      |                |                |
      v                v                v
   Metrics          Metrics          Metrics

Schema Explorer

Browse all types, fields, and arguments. Click any type name to navigate to its definition. Use the search bar to find specific types or fields.