Retrieve all AVS

GET

avs

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

{
  "data": [
    {
      "address": "0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1",
      "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",
      "totalStakers": 10,
      "totalOperators": 10,
      "maxApy": "1.0",
      "createdAtBlock": "19631203",
      "updatedAtBlock": "19631203",
      "createdAt": "2024-04-11T08:31:11.000Z",
      "updatedAt": "2024-04-11T08:31:11.000Z",
      "curatedMetadata": {
        "avsAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
        "metadataName": "Example AVS",
        "metadataDescription": "This is an example AVS",
        "metadataDiscord": "https://discord.com/invite/example",
        "metadataLogo": "The URL of the AVS's logo",
        "metadataTelegram": "The URL of the AVS's Telegram channel",
        "metadataWebsite": "https://example.com",
        "metadataX": "https://twitter.com/example",
        "metadataGithub": "https://github.com/example",
        "metadataTokenAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
        "tags": [
          "Example tag 1",
          "Example tag 2"
        ],
        "isVisible": true,
        "isVerified": true
      },
      "shares": [
        {
          "strategyAddress": "0x93c4b944d05dfe6df7645a86cd2206016c51564d",
          "shares": "1000000000000000000000"
        },
        {
          "strategyAddress": "0x54945180db7943c0ed0fee7edab2bd24620256bc",
          "shares": "1000000000000000000000"
        }
      ],
      "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"

withCuratedMetadata

enum<string>

default:false

Toggle whether the route should send curated metadata

Available options:

true,

false

Example:

"false"

searchMode

enum<string>

default:contains

Search mode

Available options:

contains,

startsWith

Example:

"contains"

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"

sortByTotalStakers

enum<string>

Sort results in asc or desc order of total stakers

Available options:

asc,

desc

Example:

"desc"

sortByTotalOperators

enum<string>

Sort results in asc or desc order of total AVS (only valid for 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 list of AVS records.

data

object[]

required

data.address

string

required

AVS service manager contract address

Example:

"0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1"

data.metadataName

string

required

The name of the AVS

Example:

"Example AVS"

data.metadataDescription

string | null

required

The description of the AVS

Example:

"This is an example AVS"

data.metadataDiscord

string | null

required

The URL of the AVS's Discord server

Example:

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

data.metadataLogo

string | null

required

The URL of the AVS's logo

data.metadataTelegram

string | null

required

The URL of the AVS's Telegram channel

Example:

"https://t.me/acme"

data.metadataWebsite

string | null

required

The URL of the AVS's website

Example:

"https://acme.com"

data.metadataX

string | null

required

The URL of the AVS's X

Example:

"https://twitter.com/acme"

data.totalStakers

number

required

The total number of stakers staking in the AVS

Example:

10

data.totalOperators

number

required

The total number of operators operating the AVS

Example:

10

data.maxApy

string

required

The max APY for the AVS across all the strategies

Example:

"1.0"

data.createdAtBlock

string

required

The block number at which the AVS was created

Example:

"19631203"

data.updatedAtBlock

string

required

The block number at which the AVS was last updated

Example:

"19631203"

data.createdAt

string

required

The time stamp at which the AVS was created

Example:

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

data.updatedAt

string

required

The time stamp at which the AVS was last updated

Example:

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

data.shares

object[]

required

The strategy shares held in the AVS

Example:

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

data.curatedMetadata

object

To curate visibility and additional information of the AVS

data.curatedMetadata.metadataName

string

required

The name of the AVS

Example:

"Example AVS"

data.curatedMetadata.metadataDescription

string | null

required

The description of the AVS

Example:

"This is an example AVS"

data.curatedMetadata.metadataDiscord

string | null

required

The URL of the AVS's Discord server

Example:

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

data.curatedMetadata.metadataLogo

string | null

required

The URL of the AVS's logo

data.curatedMetadata.metadataTelegram

string | null

required

The URL of the AVS's Telegram channel

Example:

"https://t.me/acme"

data.curatedMetadata.metadataWebsite

string | null

required

The URL of the AVS's website

Example:

"https://acme.com"

data.curatedMetadata.metadataX

string | null

required

The URL of the AVS's X

Example:

"https://twitter.com/acme"

data.curatedMetadata.metadataGithub

string | null

required

The URL of the AVS's Github

Example:

"https://github.com/acme"

data.curatedMetadata.metadataTokenAddress

string | null

required

The Token Address of the AVS

Example:

"0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552"

data.curatedMetadata.avsAddress

string

required

AVS service manager contract address

Example:

"0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1"

data.curatedMetadata.tags

string[]

required

Tags to describe the AVS

Example:

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

data.curatedMetadata.isVisible

boolean

required

Indicates if AVS visibility is allowed

Example:

false

data.curatedMetadata.isVerified

boolean

required

Indicates if the AVS has been verified by the EigenExplorer team

Example:

false

Example:

{
  "avsAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
  "metadataName": "Example AVS",
  "metadataDescription": "This is an example AVS",
  "metadataDiscord": "https://discord.com/invite/example",
  "metadataLogo": "The URL of the AVS's logo",
  "metadataTelegram": "The URL of the AVS's Telegram channel",
  "metadataWebsite": "https://example.com",
  "metadataX": "https://twitter.com/example",
  "metadataGithub": "https://github.com/example",
  "metadataTokenAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
  "tags": ["Example tag 1", "Example tag 2"],
  "isVisible": true,
  "isVerified": true
}

data.tvl

object

The total value locked (TVL) in the AVS

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 historical deposit aggregate data Retrieve all AVS addresses

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

{
  "data": [
    {
      "address": "0x35f4f28a8d3ff20eed10e087e8f96ea2641e6aa1",
      "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",
      "totalStakers": 10,
      "totalOperators": 10,
      "maxApy": "1.0",
      "createdAtBlock": "19631203",
      "updatedAtBlock": "19631203",
      "createdAt": "2024-04-11T08:31:11.000Z",
      "updatedAt": "2024-04-11T08:31:11.000Z",
      "curatedMetadata": {
        "avsAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
        "metadataName": "Example AVS",
        "metadataDescription": "This is an example AVS",
        "metadataDiscord": "https://discord.com/invite/example",
        "metadataLogo": "The URL of the AVS's logo",
        "metadataTelegram": "The URL of the AVS's Telegram channel",
        "metadataWebsite": "https://example.com",
        "metadataX": "https://twitter.com/example",
        "metadataGithub": "https://github.com/example",
        "metadataTokenAddress": "0x2344c0fe02ccd2b32155ca0ffcb1978a6d96a552",
        "tags": [
          "Example tag 1",
          "Example tag 2"
        ],
        "isVisible": true,
        "isVerified": true
      },
      "shares": [
        {
          "strategyAddress": "0x93c4b944d05dfe6df7645a86cd2206016c51564d",
          "shares": "1000000000000000000000"
        },
        {
          "strategyAddress": "0x54945180db7943c0ed0fee7edab2bd24620256bc",
          "shares": "1000000000000000000000"
        }
      ],
      "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