# Yield.xyz Get Wallet Yield Balances

> Yield.xyz Get Wallet Yield Balances is a paid API for AI agents from mcp.stg.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Returns current yield positions, accrued rewards, and pending exits for a wallet address across one or more yield protocols

## Facts

- Endpoint: POST https://mcp.stg.yield.xyz/x402/yields_get_balances?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yield-xyz-get-wallet-yield-balances-d8cbfc8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lMGKC-OMq9qaJZhJ7-GP8

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-get-wallet-yield-balances-d8cbfc8d -d '<json body>'
```

Example prompt: Show me all my current yield positions, accrued rewards, and any pending exits for my wallet 0xAbC123...def456 — I want to see everything before I decide whether to exit.

## When to prefer this

Use this endpoint when you need to read the current state of a wallet's yield positions before taking action (exiting or managing). It is a prerequisite for actions_exit and actions_manage. Prefer this over on-chain direct queries when you want an aggregated, formatted view across multiple yield protocols in a single call.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet address with no yield positions returns empty arrays
- Network or protocol unavailability causes 503 or timeout
- Insufficient payment (x402) results in payment-required error
- Unknown yield ID returns an error or empty result for that position

## How this service works

Get current yield balances and pending actions for a wallet address. Returns active positions, accrued rewards, and pending exits across one or more yields. Call this before actions_exit or actions_manage.

## Output

Returns a structured response containing active yield positions, accrued reward amounts, and pending exit requests associated with the given wallet address across all queried yield protocols. Useful as a prerequisite step before calling exit or manage actions.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yield-xyz-get-wallet-yield-balances-d8cbfc8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.stg.yield.xyz](https://www.zero.xyz/host/mcp.stg.yield.xyz/llms.txt)