HomeDocumentationCommmunityLegal

Rewards

A series of endpoints that drill down on rewards metrics for both entities (operators), delegators, and eigenpods.

Entity Rewards

This entity rewards endpoint give you a breakdown of all rewards earned by an entity over a specified time period across all networks that they are involved in, broken down per token.

Get rewards by Operator.

This endpoint returns the daily rewards of an Operator

GET/v1/eigenlayer/entities/{operator_address}/rewards
Path parameters
operator_address*Operator Address
Query parameters
Header parameters
Response

Successful Response

Body
previousPrevious
nextNext
pages*Pages
results*Results
Request
const response = await fetch('/v1/eigenlayer/entities/{operator_address}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "distributionRootIndex": 1,
      "date": "2024-10-01",
      "activatedAt": 1726599623,
      "amount": 1432232,
      "delegatorAddress": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
      "token": {
        "name": "Wrapped Ether",
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "symbol": "WETH",
        "decimals": 18
      },
      "snapshotTimestamp": 1726358400000,
      "prices": {
        "ethAmount": 0.0232,
        "usdAmount": 58.74,
        "ethPrice": 0.99829323,
        "usdPrice": 2532.14
      },
      "operators": [
        {
          "name": "Bob the Operator",
          "address": "0x74134d0c91798d720a5585364bb4be7396c5b973"
        }
      ]
    }
  ]
}

Using this endpoint, you can query per eigenlayer operator using its operator address, and you will see that particular operator's rewards history, broken down per token. It gives the amount per token, the date when they were distributed (date), and the date when they are claimable (activatedAt; given in milliseconds). The ETH and USD prices of the token are also given based on the day when the rewards are claimable.

Delegator Rewards

Similar to the Entity Rewards endpoint, this endpoint gives you a breakdown of all rewards earned by a delegator over a specified time period.

Get rewards by Delegator.

This endpoint returns the daily rewards of an Delegator

GET/v1/eigenlayer/delegators/{delegator_address}/rewards
Path parameters
delegator_address*Delegator Address
Query parameters
Header parameters
Response

Successful Response

Body
previousPrevious
nextNext
pages*Pages
results*Results
Request
const response = await fetch('/v1/eigenlayer/delegators/{delegator_address}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "distributionRootIndex": 1,
      "date": "2024-10-01",
      "activatedAt": 1726599623,
      "amount": 1432232,
      "delegatorAddress": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
      "token": {
        "name": "Wrapped Ether",
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "symbol": "WETH",
        "decimals": 18
      },
      "snapshotTimestamp": 1726358400000,
      "prices": {
        "ethAmount": 0.0232,
        "usdAmount": 58.74,
        "ethPrice": 0.99829323,
        "usdPrice": 2532.14
      },
      "operators": [
        {
          "name": "Bob the Operator",
          "address": "0x74134d0c91798d720a5585364bb4be7396c5b973"
        }
      ]
    }
  ]
}

Using this endpoint, you can query per delegator using its delegator address, and you will see that particular delegator's rewards history, broken down per token. It gives the amount per token, the date when they were distributed (date), and the date when they are claimable (activatedAt; given in milliseconds). The ETH and USD prices of the token are also given based on the day when the rewards are claimable.

Eigenpod Rewards

The rewards endpoint for eigenpods gives a breakdown of rewards attributed to that eigenpod.

Get rewards by Eigenpod.

This endpoint returns the daily rewards of an Eigenpod

GET/v1/eigenlayer/eigenpods/{eigenpod_address}/rewards
Path parameters
eigenpod_address*Eigenpod Address
Query parameters
Header parameters
Response

Successful Response

Body
previousPrevious
nextNext
pages*Pages
results*Results
Request
const response = await fetch('/v1/eigenlayer/eigenpods/{eigenpod_address}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "distributionRootIndex": 1,
      "date": "2024-10-01",
      "activatedAt": 1726599623,
      "amount": 1432232,
      "delegatorAddress": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
      "token": {
        "name": "Wrapped Ether",
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "symbol": "WETH",
        "decimals": 18
      },
      "snapshotTimestamp": 1726358400000,
      "prices": {
        "ethAmount": 0.0232,
        "usdAmount": 58.74,
        "ethPrice": 0.99829323,
        "usdPrice": 2532.14
      },
      "operators": [
        {
          "name": "Bob the Operator",
          "address": "0x74134d0c91798d720a5585364bb4be7396c5b973"
        }
      ]
    }
  ]
}

Using this endpoint, you can query it using the eigenpod address and you will see the particular rewards related to that eigenpod, broken down per token. It gives the amount per token, the date when they were distributed (date), and the date when they are claimable (activatedAt; given in milliseconds). The ETH and USD prices of the token are also given based on the day when the rewards are claimable.

PreviousEigenlayerNextMetadata

Last updated