Methodology

Understanding how metrics are calculated helps you interpret the data correctly. Each entity type has its own set of metrics with specific calculation methodologies.

Asset Metrics

The following table provides a detailed overview of the metrics methodology used to track and measure the performance of a particular asset. To get more information about the object/class itself, please refer to the Assets section.

You can get the data of a particular asset by running the following query, filtered by the asset's symbol. If you need more information about the asset, you can use the assets query with the metrics field. This will return all the metrics available for the asset (you can also add variations, changeAbsolutes and changePercentages).

• changeAbsolutes is the absolute change in the metric value within the last 24h, 7d, 30d, 90d or 1y.
• changePercentages is the percentage change in the metric value within the last 24h, 7d, 30d, 90d or 1y.

Refer to the Global Metrics section for more information.

Get active validators of Ethereum

To get the active validators (which is a Metric) and base data of Ethereum, you can run the following query.

{
  assets(where: { symbols: ["ETH"] }, limit: 1) {
    id
    name
    slug
    description
    symbol
    metrics(where: { metricKeys: ["active_validators"] }, limit: 1) {
      metricKey
      label
      defaultValue
    }
  }
}

{
  "data": {
    "assets": [
      {
        "id": "ID",
        "name": "Ethereum",
        "slug": "ethereum-2-0",
        "description": "the world's largest and most decentralised Layer1 blockchain. The network is used for building dApps, holding assets, transacting and communicating without being controlled by a central authority. The Ethereum vision is to build a digital future on a global scale, that is powerful enough to help all of humanity",
        "symbol": "ETH",
        "metrics": [
          {
            "metricKey": "active_validators",
            "label": "Active Validators",
            "defaultValue": 123456789
          }
        ]
      }
    ]
  }
}

Provider Metrics

The following table provides a detailed overview of the methodology of a provider.

Sample Query

{
  providers(limit: 10) {
    name
    logoUrl
    country
    rewardOptions(limit: 5) {
      id
      type {
        key
        label
      }
      metrics(limit: 10) {
        metricKey
        defaultValue
      }
    }
  }
}

Validator Metrics

The following table provides a detailed overview of the methodology used to track and measure the performance of validators.

Sample Query

{
  validators(order: { address: asc }, limit: 5) {
    id
    address
    metrics(limit: 20) {
      metricKey
      defaultValue
    }
  }
}

Reward Option Metrics

The following table provides a detailed overview of the methodology of Reward Options.

Sample Query

This sample query will return 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
    }
  }
}

Global Metrics

The following table provides a detailed overview of the global metrics methodology. To get more information about metrics, please refer to the Objects/Metrics section.

To query global metrics, make sure to apply a filter that excludes any asset, provider, reward option, or validator relation:

Sample Query

{
  metrics(
    where: {
      asset: null
      provider: null
      rewardOption: null
      validator: null
      metricKeys: ["marketcap"]
    }
    limit: 1
  ) {
    defaultValue
    changeAbsolutes
    changePercentages
    createdAt
  }
}