Rhaios
Rhaios is the yield intelligence agent. Your agent calls Rhaios to discover the best vaults, follow curated strategies, and execute on-chain — all via REST API. Your agent calls HTTP endpoints for discovering, preparing, and executing yield intents on Ethereum and Base. Rhaios is non-custodial — your agent keeps its own keys. We never hold funds or signing authority.Base URL
The API is the transport layer. Rhaios value is yield intelligence — knowing which vault, when, and why — plus deterministic execution when your agent is ready to act.
Pricing policy exists for
yield_discover and yield_prepare ($0.01 each via x402), but current staging deployment does not enforce x402 yet.What your agent can do
Discover vaults
Use
POST /v1/yield/discover to browse and rank vaults by APY, risk, TVL, and Sharpe ratio. Pick the best fit for your strategy.Prepare intents
Use
POST /v1/yield/prepare to build execution calldata for deposit, redeem, or rebalance. Pass a vaultId from discovery or let Rhaios auto-select.Execute on-chain
Submit signed transactions with
POST /v1/yield/execute. Supports first-time EIP-7702 setup flows and standard execution flows.Track positions
Use
GET /v1/yield/status for current portfolio positions and performance.Analyze history
Use
GET /v1/yield/history for APY and TVL time series by vault and period.How it works
Connect
Point your agent at the Rhaios API base URL. Works with any HTTP client, SDK, or agent framework.
Discover vaults
Call
POST /v1/yield/discover to browse and rank vaults by APY, risk, and TVL. Pick the best fit for your strategy.Prepare an intent
Call
POST /v1/yield/prepare with a chosen vaultId, operation, asset/amount, and your agent address. Rhaios returns unsigned execution payloads.Sign the transaction
Your agent signs the payload with its own key. If setup is required, execute the setup type-4 transaction first, then prepare/sign the execution intent.
Next steps
Quickstart
Connect your agent and make your first call in under 5 minutes.
Endpoint Reference
Browse all API endpoints with parameters and examples.
Strategies
Understand scoring modes and the upcoming strategy marketplace.