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

# Introduction

> Connect your AI agent to DeFi yield — deposit, redeem, and rebalance via REST API. Non-custodial.

# 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

```text theme={null}
https://api.staging.rhaios.com
```

All endpoints are standard REST over HTTPS, server-to-server.

<Note>
  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.
</Note>

<Note>
  Pricing policy exists for `yield_discover` and `yield_prepare` (\$0.01 each via x402), but current staging deployment does not enforce x402 yet.
</Note>

## What your agent can do

<CardGroup cols={2}>
  <Card title="Discover vaults" icon="magnifying-glass">
    Use `POST /v1/yield/discover` to browse and rank vaults by APY, risk, TVL, and Sharpe ratio. Pick the best fit for your strategy.
  </Card>

  <Card title="Prepare intents" icon="lightbulb">
    Use `POST /v1/yield/prepare` to build execution calldata for deposit, redeem, or rebalance. Pass a vaultId from discovery or let Rhaios auto-select.
  </Card>

  <Card title="Execute on-chain" icon="bolt">
    Submit signed transactions with `POST /v1/yield/execute`. Supports first-time EIP-7702 setup flows and standard execution flows.
  </Card>

  <Card title="Track positions" icon="chart-line">
    Use `GET /v1/yield/status` for current portfolio positions and performance.
  </Card>

  <Card title="Analyze history" icon="chart-line">
    Use `GET /v1/yield/history` for APY and TVL time series by vault and period.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Connect">
    Point your agent at the Rhaios API base URL. Works with any HTTP client, SDK, or agent framework.
  </Step>

  <Step title="Discover vaults">
    Call `POST /v1/yield/discover` to browse and rank vaults by APY, risk, and TVL. Pick the best fit for your strategy.
  </Step>

  <Step title="Prepare an intent">
    Call `POST /v1/yield/prepare` with a chosen `vaultId`, operation, asset/amount, and your agent address. Rhaios returns unsigned execution payloads.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Execute on-chain">
    Pass the signed transaction to `POST /v1/yield/execute`. Rhaios submits it and returns the receipt.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Connect your agent and make your first call in under 5 minutes.
  </Card>

  <Card title="Endpoint Reference" icon="wrench" href="/tools/yield_discover">
    Browse all API endpoints with parameters and examples.
  </Card>

  <Card title="Strategies" icon="chess" href="/concepts/strategies">
    Understand scoring modes and the upcoming strategy marketplace.
  </Card>
</CardGroup>