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-03-31T18: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-03-31T18:13:27.584133"
      },
      {
        "delegator": "0xfff1ce616cf83327981bf61396ad0c04e0c8b771",
        "operator": {
          "name": "Bob the Operator",
          "address": "0x74134d0c91798d720a5585364bb4be7396c5b973"
        },
        "fromDate": "2024-03-31T18: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.