> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhaios.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/yield/status

> Get agent's yield positions and performance.

# GET /v1/yield/status

<Note>**Free** — No payment required.</Note>

Get agent's yield positions and performance. Returns:

* All active positions for the given wallet
* Current value and unrealized yield
* APY for each position
* Total portfolio value

## Parameters

<ParamField query="userAddress" type="string" required>
  User wallet address
</ParamField>

## Example

```bash theme={null}
curl "https://api.staging.rhaios.com/v1/yield/status?userAddress=0x1234567890abcdef1234567890abcdef12345678"
```

## Response

```json theme={null}
{
  "positions": [
    {
      "vaultId": "42",
      "vaultName": "Aave V3 USDC",
      "protocol": "Aave V3",
      "chain": "base",
      "depositedAmount": "10000",
      "currentValue": "10243.67",
      "apy": 0.162,
      "unrealizedYield": "243.67",
      "depositTimestamp": "2026-01-15T10:00:00Z"
    }
  ],
  "totalValueUsd": 10243.67,
  "totalDeposited": 10000,
  "totalYieldEarned": 243.67,
  "positionCount": 1
}
```

Each position in the `positions` array includes: `vaultId`, `vaultName`, `protocol`, `chain`, `depositedAmount`, `currentValue`, `apy`, `unrealizedYield`, and `depositTimestamp`.