Metadata

A series of endpoints that drill down on metadata-related metrics for both delegators and entities (operators).

Eigenlayer Delegations

These endpoints return information about the delegation history on Eigenlayer.

Get delegations by delegator

This endpoint returns the delegation history by delegator address

GET/v1/eigenlayer/delegators/{delegator_address}/delegations

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}/delegations', {
    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": [
    {
      "delegator": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
      "operator": {
        "name": "Bob the Operator",
        "address": "0x74134d0c91798d720a5585364bb4be7396c5b973"
      },
      "fromDate": "2024-10-01T18:13:27.584133"
    }
  ]
}

Using this endpoint, you can query per delegator using its delegator address, and you will see that particular delegator's delegation history per operator. Returned information includes the start date (fromDate) and end dates (toDate) of the delegation. If toDate is None, it means the address is currently delegated to that operator.

Get delegators by operator address

This endpoint returns the delegation history of delegators to an operator address

GET/v1/eigenlayer/entities/{operator_address}/delegations

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}/delegations', {
    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": {
    "0xfff1ce616cf83327981bf61396ad0c04e0c8b771": [
      {
        "delegator": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
        "operator": {
          "name": "Bob the Operator",
          "address": "0x74134d0c91798d720a5585364bb4be7396c5b973"
        },
        "fromDate": "2024-10-01T18:13:27.584133"
      },
      {
        "delegator": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
        "operator": {
          "name": "Patrick the Postman",
          "address": "0x1534d0c91798d720a5585364bb4be7396c5b973"
        },
        "fromDate": "2024-03-28T18:13:27.584133",
        "toDate": "2024-09-21T18:13:27.584133"
      }
    ]
  }
}

This endpoint behaves similar to GET /v1/eigenlayer/delegators/{delegator_address}/delegations endpoint, except that is acts at an operator level. By querying the endpoint using an operator's specific address, you can see the history of delegators that have delegated to this operator. Delegations wherein toDate is None means those are active.

Stake State

Entity Stake State

Get Stake state by Entity.

This endpoint returns the daily stake state of an Entity

GET/v1/eigenlayer/entities/{operator_address}/state

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}/state', {
    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": [
    {
      "date": "2024-10-01",
      "operatorName": "Bob The Operator",
      "operatorAddress": "0xB0bd0c91798d720a5585364bb4be7396c5b9731",
      "strategy": "0x54945180dB7943c0ed0FEE7EdaB2Bd24620256bc",
      "tokenAddress": "0xBe9895146f7AF43049ca1c1AE358B0541Ea49704",
      "totalShares": 32000000000000000000,
      "totalBalance": 32000000000000000000
    }
  ]
}

This endpoint allows you to query the daily stake and shares balance of an operator based on their operator address, the specific strategy, and token address.

Eigenpod Stake State

Get Stake state by Eigenpod.

This endpoint returns the daily stake state of an Eigenpod

GET/v1/eigenlayer/eigenpods/{eigenpod_address}/state

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}/state', {
    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": [
    {
      "date": "2024-10-01",
      "earner": "0x534d0c91798d720a5585364bb4be7396c5b9731",
      "eigenpodAddress": "0x1534d0c91798d720a5585364bb4be7396c5b973",
      "restakedBalance": 32000000000000000000
    }
  ]
}

This endpoint allows you to query the daily stake and shares balance of a specific eigenpod based on their operator address, the specific strategy, and token address.

Delegator Stake State

Get Stake state by delegator.

This endpoint returns the daily stake state of a delegator

GET/v1/eigenlayer/delegators/{delegator_address}/state

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}/state', {
    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": [
    {
      "date": "2024-10-01",
      "earner": "0xB0bd0c91798d720a5585364bb4be7396c5b9731",
      "strategy": "0x54945180dB7943c0ed0FEE7EdaB2Bd24620256bc",
      "tokenAddress": "0xBe9895146f7AF43049ca1c1AE358B0541Ea49704",
      "totalShares": 12000000000000000000,
      "totalBalance": 12000000000000000000
    }
  ]
}

This endpoint allows you to query the daily stake and shares balance of a specific delegator based on their delegator address, given by the earner field in the response.

API Metadata

Get metadata on the Rated Eigenlayer API endpoints

This endpoint returns information about the latest complete data available from Rated's Eigenlayer API endpoints.

GET/v1/eigenlayer/apiMetadata

Header parameters

Response

200400

Successful Response

Body

application/json

rewardsLastFullDay*Rewardslastfullday

rewardsLastSnapshotTimestamp*Rewardslastsnapshottimestamp

rewardsDistributionRootIndex*Rewardsdistributionrootindex

stateLastFullDay*Statelastfullday

Request

JavaScriptCurlPython

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

Response

200400

{
  "rewardsLastFullDay": "2024-12-16",
  "rewardsLastSnapshotTimestamp": 1734393600000,
  "rewardsDistributionRootIndex": 21,
  "stateLastFullDay": "2024-12-30"
}

Use this endpoint to know the latest freshness of the rewards endpoints and the stake state API endpoints for Eigenlayer.