v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB

Discovery

Get yield validators

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

get/v1/yields/{yieldId}/validators

Path parameters

yieldIdstring required

The unique identifier of the yield

Query parameters

offsetnumber

Offset for pagination

limitnumber

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": 150,
  "limit": 100,
  "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": {
              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6
            },
            "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"
      }
    }
  ]
}