---
title: "Get yield validators"
method: GET
path: "/v1/yields/{yieldId}/validators"
tags: ["Discovery"]
---

# Get yield validators

`GET /v1/yields/{yieldId}/validators`

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

## Path parameters

- `yieldId` string, required

## Query parameters

- `offset` number
- `limit` number
- `name` string
- `address` string
- `provider` string
- `status` string
- `preferred` boolean

## Response `200`

Returns paginated list of available validators with detailed information

- object
  - `total` number, required — Total number of items available
  - `offset` number, required — Offset of the current page
  - `limit` number, required — Limit of the current page
  - `items` ValidatorDto[]
    - `address` string, required — Validator address or ID
    - `name` string — Validator display name
    - `logoURI` string — Validator logo URI
    - `website` string — Link to validator website
    - `rewardRate` RewardRateDto
      - `total` number, required — Estimated underlying integration reward rate across all sources. May include an additional campaign component when an active campaign applies to this project.
      - `rateType` string, required — Whether this reward rate is APR or APY
      - `components` RewardDto[], required — Breakdown of reward rates by source
        - `rate` number, required — Reward rate as a decimal (e.g. 0.04 = 4%)
        - `rateType` string, required — Whether this rate is APR or APY
        - `token` TokenDto, required
          - `address` string — Token contract address
          - `symbol` string, required — Token symbol
          - `name` string, required — Token name
          - `decimals` number, required — Token decimals
          - `logoURI` string — Token logo URI
        - `yieldSource` 'staking' | 'liquid_staking' | 'restaking' | 'protocol_incentive' | 'campaign_incentive' | 'points' | 'lending' | 'mev' | 'real_world_asset_yield' | 'vault', required — Structured source of yield (e.g. staking, protocol incentive)
        - `description` string — Optional human-readable description of this reward
    - `provider` ValidatorProviderDto
      - `name` string, required — Provider name
      - `id` string, required — Provider ID
      - `logoURI` string, required — Provider logo URI
      - `description` string, required — Short description of the provider
      - `website` string, required — Provider website
      - `tvlUsd` object, nullable, required — Total TVL across the entire provider in USD
      - `type` 'protocol' | 'validator_provider', required — Type of provider (protocol or validator provider)
      - `references` string[], nullable — Optional social/media references or audit links
      - `rank` number, required — Provider ranking (lower numbers indicate higher preference)
      - `preferred` boolean, required — Whether this provider is marked as preferred
      - `revshare` RevShareTiersDto
        - `trial` RevShareDetailsDto
          - `minRevShare` number, required — Minimum revenue share percentage (0-1)
          - `maxRevShare` number, required — Maximum revenue share percentage (0-1)
        - `standard` RevShareDetailsDto
          - `minRevShare` number, required — Minimum revenue share percentage (0-1)
          - `maxRevShare` number, required — Maximum revenue share percentage (0-1)
        - `pro` RevShareDetailsDto
          - `minRevShare` number, required — Minimum revenue share percentage (0-1)
          - `maxRevShare` number, required — Maximum revenue share percentage (0-1)
      - `uniqueId` string — Provider ID (deprecated, use `id` instead)
      - `createdAt` string, date-time — Creation timestamp (deprecated)
      - `updatedAt` string, date-time — Last update timestamp (deprecated)
    - `commission` number — Commission rate charged by validator
    - `tvlUsd` string — Total value locked with this validator in USD
    - `tvl` string — Total value locked with this validator in native token
    - `tvlRaw` string — Raw total value locked with this validator (full precision)
    - `votingPower` number — Validator's voting power share (0–1)
    - `preferred` boolean — Whether this validator is flagged as preferred
    - `minimumStake` string — Minimum stake allowed in native token
    - `remainingPossibleStake` string — Maximum available stake before hitting cap in native token
    - `remainingSlots` number — Number of remaining nominator/delegator slots (for capped chains)
    - `nominatorCount` number — Number of current nominators
    - `status` string — Validator status description (active, jailed, unbonding, etc.)
    - `providerId` string — ID of the provider backing this validator
    - `subnet` ValidatorSubnetDto
      - `id` number, required — Subnet ID
      - `name` string — Subnet name
      - `tokenSymbol` string — Subnet token symbol
      - `tvl` string — TAO-side reserve of the subnet AMM pool (subnet-level TVL in TAO)
      - `pricePerShare` string — Spot price of the subnet alpha token in TAO

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Yield not found with the specified ID
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/yield/apis/yield-xyz-api.md) · [All operations](https://skmtc.net/yield/apis/yield-xyz-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yield/yield-xyz-api/revisions/acfa80015ca5/schema)