Get yield validators

Retrieve a paginated list of validators available for staking or delegation for this yield opportunity.

GET /v1/yields/{yieldId}/validators

Get yield validators

cURL

curl --request GET \
  --url https://api.yield.xyz/v1/yields/{yieldId}/validators \
  --header 'x-api-key: <api-key>'

200

{
  "total": 100,
  "offset": 0,
  "limit": 20,
  "items": [
    {
      "address": "cosmosvaloper1abc...",
      "name": "StakeKit Validator",
      "logoURI": "https://stakekit.com/logo.png",
      "website": "https://stakekit.com",
      "rewardRate": {
        "total": 8.4,
        "rateType": "APR",
        "components": [
          {
            "rate": 6.8,
            "rateType": "APR",
            "token": {
              "symbol": "SOL",
              "name": "Solana"
            },
            "yieldSource": "staking",
            "description": "Solana network inflation rewards"
          },
          {
            "rate": 1.2,
            "rateType": "APR",
            "token": {
              "symbol": "SOL",
              "name": "Solana"
            },
            "yieldSource": "validator_commission",
            "description": "Transaction fees from processed transactions"
          },
          {
            "rate": 0.4,
            "rateType": "APR",
            "token": {
              "symbol": "SOL",
              "name": "Solana"
            },
            "yieldSource": "mev",
            "description": "MEV from Jito block space auctions"
          }
        ]
      },
      "provider": {
        "name": "Provider name",
        "uniqueId": "provider-1",
        "website": "https://provider.com",
        "rank": 1,
        "preferred": true,
        "revshare": {
          "standard": {
            "minRevShare": 0.3,
            "maxRevShare": 0.7
          },
          "pro": {
            "minRevShare": 0.4,
            "maxRevShare": 0.8
          }
        }
      },
      "commission": 0.05,
      "tvlUsd": "18,340,000",
      "tvl": "8250.45",
      "tvlRaw": "8250450000000000000000",
      "votingPower": 0.013,
      "preferred": true,
      "minimumStake": "1.0",
      "remainingPossibleStake": "285,714.28",
      "remainingSlots": 8,
      "nominatorCount": 321,
      "status": "active",
      "providerId": "provider-1",
      "pricePerShare": "1.0",
      "subnetId": 1,
      "subnetName": "Apex",
      "marketCap": "1000000",
      "tokenSymbol": "α"
    }
  ]
}

Authorizations

x-api-key · string · header · required

Path Parameters

yieldId · string · required

The unique identifier of the yield

Query Parameters

offset · number · default: 0

Offset for pagination

Required range: x >= 0

limit · number · default: 20

Number of items per page

Required range: 1 <= x <= 100

name · string

Filter by validator name (case-insensitive, partial match)

address · string

Filter by validator address

provider · string

Filter by provider ID

status · string

Filter by validator status

preferred · boolean

Filter by preferred flag

Response

200

application/json

Returns paginated list of available validators with detailed information

total · number · required

Total number of items available

Example:

100

offset · number · required

Offset of the current page

Example:

0

limit · number · required

Limit of the current page

Example:

20

items · object[]

Show child attributes