Retrieve all operators

GET

operators

curl --request GET \
  --url https://api.eigenexplorer.com/operators \
  --header 'X-API-Token: <x-api-token>'

{
  "data": [
    {
      "address": "0x09e6eb09213bdd3698bd8afb43ec3cb0ecff683a",
      "metadataName": "Example AVS Operator",
      "metadataDescription": "This is an example AVS operator",
      "metadataDiscord": "https://discord.com/invite/abcdefghij",
      "metadataLogo": "<string>",
      "metadataTelegram": "https://t.me/acme",
      "metadataWebsite": "https://acme.com",
      "metadataX": "https://twitter.com/acme",
      "totalStakers": 10,
      "totalAvs": 10,
      "maxApy": "1.0",
      "createdAtBlock": "19631203",
      "updatedAtBlock": "19631203",
      "createdAt": "2024-04-11T08:31:11.000Z",
      "updatedAt": "2024-04-11T08:31:11.000Z",
      "shares": [
        {
          "strategyAddress": "0x93c4b944d05dfe6df7645a86cd2206016c51564d",
          "shares": "135064894598947935263152"
        },
        {
          "strategyAddress": "0x54945180db7943c0ed0fee7edab2bd24620256bc",
          "shares": "9323641881708650182301"
        }
      ],
      "avsRegistrations": [
        {
          "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
          "isActive": true
        },
        {
          "avsAddress": "0xe8e59c6c8b56f2c178f63bcfc4ce5e5e2359c8fc",
          "isActive": false
        }
      ],
      "tvl": {
        "tvl": 1000000,
        "tvlBeaconChain": 1000000,
        "tvlWETH": 1000000,
        "tvlRestaking": 1000000,
        "tvlStrategies": {
          "Eigen": 1000000,
          "cbETH": 2000000
        },
        "tvlStrategiesEth": {
          "stETH": 1000000,
          "cbETH": 2000000
        }
      }
    }
  ],
  "meta": {
    "total": 30,
    "skip": 0,
    "take": 12
  }
}

Headers

X-API-Token

string

required

API Token for authentication

Query Parameters

withTvl

enum<string>

default:false

Toggle whether the route should calculate the TVL from shares

Available options:

true,

false

Example:

"false"

searchByText

string

Case-insensitive search query

Example:

"eigen"

sortByApy

enum<string>

Sort results in asc or desc order of APY

Available options:

asc,

desc

Example:

"desc"

sortByTvl

enum<string>

Sort results in asc or desc order of TVL value

Available options:

asc,

desc

Example:

"desc"

sortByTotalAvs

enum<string>

Sort results in asc or desc order of total AVS (only valid for Operator queries)

Available options:

asc,

desc

Example:

"desc"

sortByTotalStakers

enum<string>

Sort results in asc or desc order of total stakers

Available options:

asc,

desc

Example:

"desc"

skip

string

default:0

The number of records to skip for pagination

Example:

0

take

string

default:12

The number of records to return for pagination

Example:

12

Response

200

application/json

The list of operator records.

data

object[]

required

data.address

string

required

The contract address of the AVS operator

Example:

"0x09e6eb09213bdd3698bd8afb43ec3cb0ecff683a"

data.metadataName

string

required

The name of the AVS operator

Example:

"Example AVS Operator"

data.metadataDescription

string | null

required

The description of the AVS operator

Example:

"This is an example AVS operator"

data.metadataDiscord

string | null

required

The URL of the AVS operator's Discord server

Example:

"https://discord.com/invite/abcdefghij"

data.metadataLogo

string | null

required

The URL of the AVS operator's logo

data.metadataTelegram

string | null

required

The URL of the AVS operator's Telegram channel

Example:

"https://t.me/acme"

data.metadataWebsite

string | null

required

The URL of the AVS operator's website

Example:

"https://acme.com"

data.metadataX

string | null

required

The URL of the AVS operator's X

Example:

"https://twitter.com/acme"

data.totalStakers

number

required

The total number of stakers who have delegated to this AVS operator

Example:

10

data.totalAvs

number

required

The total number of AVS opted by the AVS operator

Example:

10

data.maxApy

string

required

The best strategy APY, representing the maximum value when each strategy's APY is summed across all AVSs, as strategies collect APY from multiple AVSs (it stacks). This reflects the highest APY you can get for a strategy after deducting the operator fee

Example:

"1.0"

data.createdAtBlock

string

required

The block number at which the AVS Operator was registered

Example:

"19631203"

data.updatedAtBlock

string

required

The block number at which the AVS Operator registration was last updated

Example:

"19631203"

data.createdAt

string

required

The time stamp at which the AVS Operator was registered

Example:

"2024-04-11T08:31:11.000Z"

data.updatedAt

string

required

The time stamp at which the AVS Operator registration was last updated

Example:

"2024-04-11T08:31:11.000Z"

data.shares

object[]

required

The strategy shares held in the AVS operator

Example:

[
  {
    "strategyAddress": "0x93c4b944d05dfe6df7645a86cd2206016c51564d",
    "shares": "135064894598947935263152"
  },
  {
    "strategyAddress": "0x54945180db7943c0ed0fee7edab2bd24620256bc",
    "shares": "9323641881708650182301"
  }
]

data.avsRegistrations

object[]

required

Operator AVS registrations and their participation status

Example:

[
  {
    "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
    "isActive": true
  },
  {
    "avsAddress": "0xe8e59c6c8b56f2c178f63bcfc4ce5e5e2359c8fc",
    "isActive": false
  }
]

data.tvl

object

The total value locked (TVL) in the AVS operator

data.tvl.tvl

number

required

The combined TVL of all restaking strategies in ETH

Example:

1000000

data.tvl.tvlBeaconChain

number

required

The TVL of Beacon Chain restaking strategy in ETH

Example:

1000000

data.tvl.tvlRestaking

number

required

The combined TVL of all liquid restaking strategies in ETH

Example:

1000000

data.tvl.tvlWETH

number

required

The TVL of WETH restaking strategy in ETH

Example:

1000000

data.tvl.tvlStrategies

object

required

The TVL of each individual restaking strategy in its native token

Example:

{ "Eigen": 1000000, "cbETH": 2000000 }

data.tvl.tvlStrategiesEth

object

required

The TVL of each individual restaking strategy in ETH

Example:

{ "Eigen": 1000000, "cbETH": 2000000 }

Example:

{
  "tvl": 1000000,
  "tvlBeaconChain": 1000000,
  "tvlWETH": 1000000,
  "tvlRestaking": 1000000,
  "tvlStrategies": { "Eigen": 1000000, "cbETH": 2000000 },
  "tvlStrategiesEth": { "stETH": 1000000, "cbETH": 2000000 }
}

meta

object

required

Retrieve all registration events for a given AVS address Retrieve all operator addresses

curl --request GET \
  --url https://api.eigenexplorer.com/operators \
  --header 'X-API-Token: <x-api-token>'

{
  "data": [
    {
      "address": "0x09e6eb09213bdd3698bd8afb43ec3cb0ecff683a",
      "metadataName": "Example AVS Operator",
      "metadataDescription": "This is an example AVS operator",
      "metadataDiscord": "https://discord.com/invite/abcdefghij",
      "metadataLogo": "<string>",
      "metadataTelegram": "https://t.me/acme",
      "metadataWebsite": "https://acme.com",
      "metadataX": "https://twitter.com/acme",
      "totalStakers": 10,
      "totalAvs": 10,
      "maxApy": "1.0",
      "createdAtBlock": "19631203",
      "updatedAtBlock": "19631203",
      "createdAt": "2024-04-11T08:31:11.000Z",
      "updatedAt": "2024-04-11T08:31:11.000Z",
      "shares": [
        {
          "strategyAddress": "0x93c4b944d05dfe6df7645a86cd2206016c51564d",
          "shares": "135064894598947935263152"
        },
        {
          "strategyAddress": "0x54945180db7943c0ed0fee7edab2bd24620256bc",
          "shares": "9323641881708650182301"
        }
      ],
      "avsRegistrations": [
        {
          "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
          "isActive": true
        },
        {
          "avsAddress": "0xe8e59c6c8b56f2c178f63bcfc4ce5e5e2359c8fc",
          "isActive": false
        }
      ],
      "tvl": {
        "tvl": 1000000,
        "tvlBeaconChain": 1000000,
        "tvlWETH": 1000000,
        "tvlRestaking": 1000000,
        "tvlStrategies": {
          "Eigen": 1000000,
          "cbETH": 2000000
        },
        "tvlStrategiesEth": {
          "stETH": 1000000,
          "cbETH": 2000000
        }
      }
    }
  ],
  "meta": {
    "total": 30,
    "skip": 0,
    "take": 12
  }
}

Introduction

Quick Start

API Endpoints

Headers

Query Parameters

Response