Skip to main content

​
GET /v1/yield/status

Free — No payment required.
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

​
userAddress
string
required
User wallet address

​
Example

curl "https://api.staging.rhaios.com/v1/yield/status?userAddress=0x1234567890abcdef1234567890abcdef12345678"

​
Response

{
  "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.