Discovery

Get yield validators

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

get/v1/yields/{yieldId}/validators

Request

Base URL: https://api.yield.xyz
URL: https://api.yield.xyz/v1/yields/{yieldId}/validators
Auth: API key in header x-api-key

Path parameters

yieldIdstring required

Example:solana-sol-native-multivalidator-staking

The unique identifier of the yield

Query parameters

offsetnumber

Offset for pagination

limitnumber

Example:20

Number of items per page

namestring

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

addressstring

Filter by validator address

providerstring

Filter by provider ID

statusstring

Filter by validator status

preferredboolean

Filter by preferred flag

Response

Returns paginated list of available validators with detailed information

totalnumber required

Total number of items available

offsetnumber required

Offset of the current page

limitnumber required

Limit of the current page

Example response

{
  "total": 100,
  "limit": 20,
  "items": [
    {
      "address": "cosmosvaloper1abc...",
      "name": "StakeKit Validator",
      "logoURI": "https://stakekit.com/logo.png",
      "website": "https://stakekit.com",
      "rewardRate": {
        "total": 6.5,
        "rateType": "APR",
        "components": [
          {
            "rate": 0.04,
            "rateType": "APR",
            "token": {
              "symbol": "ETH",
              "name": "Ethereum",
              "decimals": 18,
              "network": "Ethereum",
              "address": "0x...",
              "logoURI": "https://...",
              "isPoints": true,
              "coinGeckoId": "ethereum"
            },
            "yieldSource": "protocol_incentive",
            "description": "LDO distributed to incentivize stETH adoption via Lido Boost"
          }
        ]
      },
      "provider": {
        "name": "Morpho",
        "id": "morpho",
        "logoURI": "https://morpho.xyz/logo.png",
        "description": "A peer-to-peer DeFi lending protocol",
        "website": "https://morpho.xyz",
        "type": "protocol",
        "rank": 1,
        "preferred": true,
        "revshare": {
          "trial": {
            "minRevShare": 0.3,
            "maxRevShare": 0.7
          },
          "standard": {
            "minRevShare": 0.3,
            "maxRevShare": 0.7
          },
          "pro": {
            "minRevShare": 0.3,
            "maxRevShare": 0.7
          }
        },
        "uniqueId": "luganodes"
      },
      "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",
      "subnet": {
        "id": 1,
        "name": "Apex",
        "tokenSymbol": "α",
        "tvl": "1000000",
        "pricePerShare": "1.0"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.