Retrieve an operator by address

GET

operators

{address}

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

{
  "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": false,
      "metadataName": "Example AVS",
      "metadataDescription": "This is an example AVS",
      "metadataDiscord": "https://discord.com/invite/abcdefghij",
      "metadataLogo": "<string>",
      "metadataTelegram": "https://t.me/acme",
      "metadataWebsite": "https://acme.com",
      "metadataX": "https://twitter.com/acme",
      "metadataUrl": "https://example.json",
      "curatedMetadata": {
        "metadataName": "Example AVS",
        "metadataDescription": "This is an example AVS",
        "metadataDiscord": "https://discord.com/invite/abcdefghij",
        "metadataLogo": "<string>",
        "metadataTelegram": "https://t.me/acme",
        "metadataWebsite": "https://acme.com",
        "metadataX": "https://twitter.com/acme",
        "metadataGithub": "https://github.com/acme",
        "metadataTokenAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
        "tags": [
          "Example tag 1",
          "Example tag 2"
        ],
        "isVisible": false,
        "isVerified": false
      },
      "restakeableStrategies": [
        "<string>"
      ],
      "totalStakers": 80000,
      "totalOperators": 200,
      "tvlEth": "3000000",
      "createdAtBlock": 19592323,
      "updatedAtBlock": 19592323,
      "createdAt": "2024-04-05T21:49:59.000Z",
      "updatedAt": "2024-04-05T21:49:59.000Z",
      "address": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
      "maxApy": "1.0",
      "rewardsSubmissions": [
        {
          "id": 1,
          "submissionNonce": 0,
          "rewardsSubmissionHash": "0x2bc2f7cef0974f7064dbdae054f9a0e5ea1c2293d180a749c70100506382d85",
          "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
          "strategyAddress": "0x0fe4f44bee93503346a3ac9ee5a26b130a5796d6",
          "multiplier": "1000000000000000000",
          "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "amount": "300000000000000000",
          "startTimestamp": 1720000000,
          "duration": 2500000,
          "createdAtBlock": 20495824,
          "createdAt": "2024-08-10T04:28:47.000Z"
        }
      ]
    }
  ],
  "tvl": {
    "tvl": 1000000,
    "tvlBeaconChain": 1000000,
    "tvlWETH": 1000000,
    "tvlRestaking": 1000000,
    "tvlStrategies": {
      "Eigen": 1000000,
      "cbETH": 2000000
    },
    "tvlStrategiesEth": {
      "stETH": 1000000,
      "cbETH": 2000000
    }
  },
  "rewards": [
    {
      "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
      "maxApy": 0.1,
      "strategyApys": [
        {
          "strategyAddress": "0xbeac0eeeeeeeeeeeeeeeeeeeeeeeeeeeeeebeac0",
          "apy": 0.1,
          "tokens": [
            {
              "tokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
              "apy": 0.1
            }
          ]
        }
      ]
    }
  ]
}

Headers

X-API-Token

string

required

API Token for authentication

Path Parameters

address

string

required

The address of the operator

Example:

"0x00107cfdeaddc0a3160ed2f6fedd627f313e7b1a"

Query Parameters

withTvl

enum<string>

default:false

Toggle whether the route should calculate the TVL from shares

Available options:

true,

false

Example:

"false"

withAvsData

enum<string>

default:false

Toggle whether to return additional data for each AVS registration for a given Operator

Available options:

true,

false

Example:

"false"

withRewards

enum<string>

default:false

Toggle whether the route should return Avs/Operator rewards APY data

Available options:

true,

false

Example:

"false"

Response

200

application/json

The record of the requested operator.

address

string

required

The contract address of the AVS operator

Example:

"0x09e6eb09213bdd3698bd8afb43ec3cb0ecff683a"

metadataName

string

required

The name of the AVS operator

Example:

"Example AVS Operator"

metadataDescription

string | null

required

The description of the AVS operator

Example:

"This is an example AVS operator"

metadataDiscord

string | null

required

The URL of the AVS operator's Discord server

Example:

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

metadataLogo

string | null

required

The URL of the AVS operator's logo

metadataTelegram

string | null

required

The URL of the AVS operator's Telegram channel

Example:

"https://t.me/acme"

metadataWebsite

string | null

required

The URL of the AVS operator's website

Example:

"https://acme.com"

metadataX

string | null

required

The URL of the AVS operator's X

Example:

"https://twitter.com/acme"

totalStakers

number

required

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

Example:

10

totalAvs

number

required

The total number of AVS opted by the AVS operator

Example:

10

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"

createdAtBlock

string

required

The block number at which the AVS Operator was registered

Example:

"19631203"

updatedAtBlock

string

required

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

Example:

"19631203"

createdAt

string

required

The time stamp at which the AVS Operator was registered

Example:

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

updatedAt

string

required

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

Example:

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

object[]

required

The strategy shares held in the AVS operator

Example:

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

avsRegistrations

object[]

required

Detailed AVS registrations information for the operator

avsRegistrations.avsAddress

string

required

The address of the AVS contract

Example:

"0x870679e138bcdf293b7ff14dd44b70fc97e12fc0"

avsRegistrations.isActive

boolean

required

True indicates operator is an active participant while False indicates it used to be one but not anymore

Example:

false

avsRegistrations.metadataName

string

required

The name of the AVS

Example:

"Example AVS"

avsRegistrations.metadataDescription

string | null

required

The description of the AVS

Example:

"This is an example AVS"

avsRegistrations.metadataDiscord

string | null

required

The URL of the AVS's Discord server

Example:

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

avsRegistrations.metadataLogo

string | null

required

The URL of the AVS's logo

avsRegistrations.metadataTelegram

string | null

required

The URL of the AVS's Telegram channel

Example:

"https://t.me/acme"

avsRegistrations.metadataWebsite

string | null

required

The URL of the AVS's website

Example:

"https://acme.com"

avsRegistrations.metadataX

string | null

required

The URL of the AVS's X

Example:

"https://twitter.com/acme"

avsRegistrations.metadataUrl

string

required

URL for AVS metadata

Example:

"https://example.json"

avsRegistrations.restakeableStrategies

string[]

required

The list of restakeable strategies for AVS

avsRegistrations.totalStakers

number

required

Total number of stakers

Example:

80000

avsRegistrations.totalOperators

number

required

Total number of operators

Example:

200

avsRegistrations.tvlEth

string

required

Total TVL in ETH

Example:

"3000000"

avsRegistrations.createdAtBlock

number

required

The block number at which the AVS was created

Example:

19592323

avsRegistrations.updatedAtBlock

number

required

The block number at which the AVS was last updated

Example:

19592323

avsRegistrations.createdAt

string

required

The time stamp at which the AVS was created

Example:

"2024-04-05T21:49:59.000Z"

avsRegistrations.updatedAt

string

required

The time stamp at which the AVS was last updated

Example:

"2024-04-05T21:49:59.000Z"

avsRegistrations.address

string

required

AVS service manager contract address

Example:

"0x870679e138bcdf293b7ff14dd44b70fc97e12fc0"

avsRegistrations.maxApy

string

required

The max APY for the AVS across all the strategies

Example:

"1.0"

avsRegistrations.rewardsSubmissions

object[]

required

List of rewards submissions associated with AVS

avsRegistrations.curatedMetadata

object

Curated metadata information for AVS

avsRegistrations.curatedMetadata.metadataName

string

required

The name of the AVS

Example:

"Example AVS"

avsRegistrations.curatedMetadata.metadataDescription

string | null

required

The description of the AVS

Example:

"This is an example AVS"

avsRegistrations.curatedMetadata.metadataDiscord

string | null

required

The URL of the AVS's Discord server

Example:

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

avsRegistrations.curatedMetadata.metadataLogo

string | null

required

The URL of the AVS's logo

avsRegistrations.curatedMetadata.metadataTelegram

string | null

required

The URL of the AVS's Telegram channel

Example:

"https://t.me/acme"

avsRegistrations.curatedMetadata.metadataWebsite

string | null

required

The URL of the AVS's website

Example:

"https://acme.com"

avsRegistrations.curatedMetadata.metadataX

string | null

required

The URL of the AVS's X

Example:

"https://twitter.com/acme"

avsRegistrations.curatedMetadata.metadataGithub

string | null

required

The URL of the AVS's Github

Example:

"https://github.com/acme"

avsRegistrations.curatedMetadata.metadataTokenAddress

string | null

required

The Token Address of the AVS

Example:

"0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552"

avsRegistrations.curatedMetadata.tags

string[]

required

Tags to describe the AVS

Example:

["Example tag 1", "Example tag 2"]

avsRegistrations.curatedMetadata.isVisible

boolean

required

Indicates if AVS visibility is allowed

Example:

false

avsRegistrations.curatedMetadata.isVerified

boolean

required

Indicates if the AVS has been verified by the EigenExplorer team

Example:

false

rewards

object[]

required

The reward details for the operator, including strategies and APYs

tvl

object

The total value locked (TVL) in the AVS operator

tvl.tvl

number

required

The combined TVL of all restaking strategies in ETH

Example:

1000000

tvl.tvlBeaconChain

number

required

The TVL of Beacon Chain restaking strategy in ETH

Example:

1000000

tvl.tvlRestaking

number

required

The combined TVL of all liquid restaking strategies in ETH

Example:

1000000

tvl.tvlWETH

number

required

The TVL of WETH restaking strategy in ETH

Example:

1000000

tvl.tvlStrategies

object

required

The TVL of each individual restaking strategy in its native token

Example:

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

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 }
}

Retrieve all operator addresses Retrieve rewards info for an operator

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

{
  "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": false,
      "metadataName": "Example AVS",
      "metadataDescription": "This is an example AVS",
      "metadataDiscord": "https://discord.com/invite/abcdefghij",
      "metadataLogo": "<string>",
      "metadataTelegram": "https://t.me/acme",
      "metadataWebsite": "https://acme.com",
      "metadataX": "https://twitter.com/acme",
      "metadataUrl": "https://example.json",
      "curatedMetadata": {
        "metadataName": "Example AVS",
        "metadataDescription": "This is an example AVS",
        "metadataDiscord": "https://discord.com/invite/abcdefghij",
        "metadataLogo": "<string>",
        "metadataTelegram": "https://t.me/acme",
        "metadataWebsite": "https://acme.com",
        "metadataX": "https://twitter.com/acme",
        "metadataGithub": "https://github.com/acme",
        "metadataTokenAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
        "tags": [
          "Example tag 1",
          "Example tag 2"
        ],
        "isVisible": false,
        "isVerified": false
      },
      "restakeableStrategies": [
        "<string>"
      ],
      "totalStakers": 80000,
      "totalOperators": 200,
      "tvlEth": "3000000",
      "createdAtBlock": 19592323,
      "updatedAtBlock": 19592323,
      "createdAt": "2024-04-05T21:49:59.000Z",
      "updatedAt": "2024-04-05T21:49:59.000Z",
      "address": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
      "maxApy": "1.0",
      "rewardsSubmissions": [
        {
          "id": 1,
          "submissionNonce": 0,
          "rewardsSubmissionHash": "0x2bc2f7cef0974f7064dbdae054f9a0e5ea1c2293d180a749c70100506382d85",
          "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
          "strategyAddress": "0x0fe4f44bee93503346a3ac9ee5a26b130a5796d6",
          "multiplier": "1000000000000000000",
          "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "amount": "300000000000000000",
          "startTimestamp": 1720000000,
          "duration": 2500000,
          "createdAtBlock": 20495824,
          "createdAt": "2024-08-10T04:28:47.000Z"
        }
      ]
    }
  ],
  "tvl": {
    "tvl": 1000000,
    "tvlBeaconChain": 1000000,
    "tvlWETH": 1000000,
    "tvlRestaking": 1000000,
    "tvlStrategies": {
      "Eigen": 1000000,
      "cbETH": 2000000
    },
    "tvlStrategiesEth": {
      "stETH": 1000000,
      "cbETH": 2000000
    }
  },
  "rewards": [
    {
      "avsAddress": "0x870679e138bcdf293b7ff14dd44b70fc97e12fc0",
      "maxApy": 0.1,
      "strategyApys": [
        {
          "strategyAddress": "0xbeac0eeeeeeeeeeeeeeeeeeeeeeeeeeeeeebeac0",
          "apy": 0.1,
          "tokens": [
            {
              "tokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
              "apy": 0.1
            }
          ]
        }
      ]
    }
  ]
}

Introduction

Quick Start

API Endpoints

Headers

Path Parameters

Query Parameters

Response