# Yield.xyz Single Yield Metadata

> Yield.xyz Single Yield Metadata 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-12).

Fetch full metadata for a specific DeFi yield opportunity including current APY, TVL, fees, lock-up periods, reward mechanics, supported tokens, and entry/exit availability.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/yields_get?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yield-xyz-single-yield-metadata-e28f2a96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EaJ8_96U0uBQNx-6zHiHv

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-single-yield-metadata-e28f2a96 -d '<json body>'
```

Example prompt: Before I stake my ETH, pull up the full details for the Lido ETH staking yield on Yield.xyz — I want to see the current APY, TVL, any lock-up or cooldown periods, minimum entry, and whether I can actually enter right now. The yield ID is ethereum-eth-lido-staking.

## When to prefer this

Use this endpoint when you need comprehensive details about a single specific yield before a user commits capital — it provides the full picture including lock-up terms, fees, and live entry/exit status. Prefer over yields_get_all when you already have a yield ID and need deep metadata rather than a broad list.

## Known failure modes

- Invalid or unknown yieldId returns an error — must use IDs from yields_get_all
- Network/protocol outage may return stale or unavailable data
- Payment failure ($0.001 USDC) causes request rejection via x402
- Missing yieldId field causes schema validation error

## How this service works

Get full metadata for a single DeFi yield: current APY, TVL, fees, minimum/maximum entry, lock-up/cooldown/warm-up periods, reward mechanics, supported tokens, and whether entry/exit is currently open. Show this before a user commits to a position.

## Output

Returns comprehensive metadata for the requested yield including current APY, total value locked (TVL), fee structure, minimum and maximum entry amounts, lock-up/cooldown/warm-up periods, reward mechanics and distribution details, supported tokens, and whether entry and exit are currently open or gated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "yieldId": {
   "type": "string",
   "description": "Yield ID from yields_get_all, e.g. \"ethereum-eth-lido-staking\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "ethereum-eth-lido-staking",
  "network": "ethereum",
  "mechanics": {
   "type": "staking",
   "cooldownPeriod": {
    "days": 0
   }
  },
  "rewardRate": {
   "total": 0.032
  },
  "statistics": {
   "tvlUsd": "24000000000"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yield-xyz-single-yield-metadata-e28f2a96/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)