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

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eigenlayer/entities/{operator_address}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "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": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "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. The address used to query is given by the earner field in the response.

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

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eigenlayer/delegators/{delegator_address}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "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": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "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. The address used to query is given by the earner field in the response.

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

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eigenlayer/eigenpods/{eigenpod_address}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "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": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "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.