Skip to main content
GET
/
v1
/
yields
/
{yieldId}
/
validators
Get yield validators
curl --request GET \
  --url https://api.yield.xyz/v1/yields/{yieldId}/validators \
  --header 'x-api-key: <api-key>'
{
  "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

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[]