# Yield.xyz List Validators

> Yield.xyz List Validators is a paid API for AI agents from mcp.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-30).

Lists validators available for delegation-based staking yields (Cosmos, Polkadot, ETH native staking, etc.) with filtering by name, status, address, provider, or curated preference.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/yields_get_validators?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yield-xyz-list-validators-9c74e693
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FJOmcEC87S_hqSUDHQmQI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability yield-xyz-list-validators-9c74e693 -d '<json body>'
```

Example prompt: Show me the curated validators for Cosmos ATOM native staking on Yield.xyz — filter to preferred ones only so I can pick one to delegate to.

## When to prefer this

Use this endpoint when you need to discover or select a validator before constructing a delegation transaction via actions_enter or actions_exit. Prefer this over generic blockchain explorers when working within the Yield.xyz ecosystem, especially when you want curated/preferred validator recommendations or need to filter by status, provider, or partial name match.

## Known failure modes

- Invalid yieldId returns empty list or error — ensure the yield ID is a valid delegation-based yield (e.g. cosmos-atom-native-staking)
- Filtering by a non-existent address returns empty results
- status filter with unsupported value may return no results or validation error
- Pagination offset beyond total results returns empty array
- Payment failure ($0.001 USDC) blocks the call

## How this service works

List validators for delegation-based yields (Cosmos, Polkadot, ETH native staking, etc.). Use a validator address with actions_enter/actions_exit. Filter to curated validators with preferred=true, or by name/status/address/provider.

## Output

Returns a paginated list of validator objects for the specified yield, each containing the validator's address, name, status (e.g. active, jailed), provider, and whether it is preferred/curated. Use a validator address from this list as input to actions_enter or actions_exit for staking transactions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Filter by validator name (partial, case-insensitive)"
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "offset": {
   "type": "integer",
   "minimum": 0
  },
  "status": {
   "type": "string",
   "description": "e.g. \"active\", \"jailed\""
  },
  "address": {
   "type": "string",
   "description": "Filter by validator address"
  },
  "yieldId": {
   "type": "string",
   "description": "Delegation-based yield ID, e.g. \"cosmos-atom-native-staking\""
  },
  "provider": {
   "type": "string"
  },
  "preferred": {
   "type": "boolean",
   "description": "Return only curated/recommended validators"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "name": "Everstake",
    "status": "active",
    "address": "cosmosvaloper1abc…",
    "preferred": true,
    "commission": 0.05,
    "rewardRate": {
     "total": 0.18,
     "rateType": "apr"
    }
   }
  ],
  "limit": 5,
  "total": 180,
  "offset": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yield-xyz-list-validators-9c74e693/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.yield.xyz](https://www.zero.xyz/host/mcp.yield.xyz/llms.txt)