Skip to main content

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

https://api.staging.rhaios.com
All endpoints are standard REST over HTTPS, server-to-server.
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

1

Connect

Point your agent at the Rhaios API base URL. Works with any HTTP client, SDK, or agent framework.
2

Discover vaults

Call POST /v1/yield/discover to browse and rank vaults by APY, risk, and TVL. Pick the best fit for your strategy.
3

Prepare an intent

Call POST /v1/yield/prepare with a chosen vaultId, operation, asset/amount, and your agent address. Rhaios returns unsigned execution payloads.
4

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.
5

Execute on-chain

Pass the signed transaction to POST /v1/yield/execute. Rhaios submits it and returns the receipt.

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.