Skip to main content

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.

​
Payments

Rhaios endpoints use a freemium pricing policy. Monitoring and execution endpoints are free. POST /v1/yield/discover and POST /v1/yield/prepare are priced per call and can be enforced via the x402 protocol.

​
Endpoint pricing policy

EndpointCostCategory
POST /v1/yield/discover$0.01Vault discovery and ranking
POST /v1/yield/prepare$0.01Strategy and execution prep (deposit, redeem, rebalance)
POST /v1/yield/executeFreeExecution
GET /v1/yield/statusFreeMonitoring
GET /v1/yield/historyFreeMonitoring
POST /v1/yield/execute is free to call but submits an on-chain transaction. Your smart wallet pays gas in USDC via the ERC-20 paymaster.
Current pre-prod deployment keeps x402 disabled. That means POST /v1/yield/discover and POST /v1/yield/prepare are currently callable without payment even though the pricing policy is defined.

​
x402 enforcement modes

​
Soft pre-prod mode (current)

  • POST /v1/yield/discover and POST /v1/yield/prepare return normally (no HTTP 402)
  • Use this mode for integration and end-to-end testing

​
Enforced mode (when enabled)

When x402 is enabled on the server:
  1. POST /v1/yield/prepare responds with HTTP 402 Payment Required and payment requirements
  2. Your client attaches the X-PAYMENT header with the payment proof
  3. Request is retried and returns results
Example with x402 payment header: 
curl -X POST https://api.staging.rhaios.com/v1/yield/prepare \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-proof>" \
  -d '{
    "operation": "deposit",
    "asset": "USDC",
    "amount": "1000",
    "agentAddress": "0x...",
    "vaultId": "42"
  }'

​
Cost example

A typical enforced deposit flow costs:
StepEndpointCost
Discover vaultsPOST /v1/yield/discover$0.01
Get strategy + calldataPOST /v1/yield/prepare$0.01
Execute on-chainPOST /v1/yield/executeFree (+ gas)
Check positionGET /v1/yield/statusFree
Total$0.02 + gas
In current soft pre-prod mode, the same flow is effectively gas-only.

​
Runtime interoperability

If you are integrating Rhaios through a larger agent runtime, keep payment handling in the runtime layer and call Rhaios for yield-specific execution prep.