Retrieve all operators for a given AVS address

GET

avs

{address}

operators

curl --request GET \
  --url https://api.eigenexplorer.com/avs/{address}/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,
      "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"
        }
      ],
      "restakedStrategies": [
        "0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1"
      ],
      "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

Path Parameters

address

string

required

AVS service manager contract address

Example:

"0x870679e138bcdf293b7ff14dd44b70fc97e12fc0"

Query Parameters

searchMode

enum<string>

default:contains

Search mode

Available options:

contains,

startsWith

Example:

"contains"

searchByText

string

Case-insensitive search query

Example:

"eigen"

withTvl

enum<string>

default:false

Toggle whether the route should calculate the TVL from shares

Available options:

true,

false

Example:

"false"

sortOperatorsByTvl

enum<string>

Sort Operators of a given AVS in asc or desc order of TVL (only valid for individual AVS queries)

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 operators record found for the AVS.

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

number

required

The max APY for the AVS Operator across all the strategies

Example:

1

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.restakedStrategies

string[]

required

The list of restaked strategies

Example:

[
  "0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1"
]

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 stakers for a given AVS address Retrieve all rewards for a given AVS address

curl --request GET \
  --url https://api.eigenexplorer.com/avs/{address}/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,
      "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"
        }
      ],
      "restakedStrategies": [
        "0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1"
      ],
      "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

Retrieve all operators for a given AVS address

Headers

Path Parameters

Query Parameters

Response