AVS
Retrieve an AVS by address
Quick Start
API Endpoints
- System Status
- Ecosystem Metrics
- Historical Metrics
- AVS
- GETRetrieve all AVS
- GETRetrieve all AVS addresses
- GETRetrieve an AVS by address
- GETRetrieve all stakers for a given AVS address
- GETRetrieve all operators for a given AVS address
- GETRetrieve all rewards for a given AVS address
- GETRetrieve all reward events for a given AVS address
- GETRetrieve all registration events for a given AVS address
- GET
- Operators
- Stakers
- Withdrawals
- Deposits
- Rewards
- Events
- Operator-Sets
AVS
Retrieve an AVS by address
Returns a single AVS record by address.
GET
/
avs
/
{address}
curl --request GET \
--url https://api.eigenexplorer.com/avs/{address} \
--header 'X-API-Token: <x-api-token>'
{
"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
}
},
"rewards": {
"strategyApys": [
{
"strategyAddress": "0xbeac0eeeeeeeeeeeeeeeeeeeeeeeeeeeeeebeac0",
"apy": 0.1,
"tokens": [
{
"tokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"apy": 0.1
}
]
}
]
}
}
Headers
API Token for authentication
Path Parameters
AVS service manager contract address
Example:
"0x870679e138bcdf293b7ff14dd44b70fc97e12fc0"
Query Parameters
Toggle whether the route should calculate the TVL from shares
Available options:
true
, false
Example:
"false"
Toggle whether the route should send curated metadata
Available options:
true
, false
Example:
"false"
Toggle whether the route should return Avs/Operator rewards APY data
Available options:
true
, false
Example:
"false"
Response
200
application/json
The AVS record found.
The response is of type object
.
curl --request GET \
--url https://api.eigenexplorer.com/avs/{address} \
--header 'X-API-Token: <x-api-token>'
{
"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
}
},
"rewards": {
"strategyApys": [
{
"strategyAddress": "0xbeac0eeeeeeeeeeeeeeeeeeeeeeeeeeeeeebeac0",
"apy": 0.1,
"tokens": [
{
"tokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"apy": 0.1
}
]
}
]
}
}