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
| Endpoint | Cost | Category |
|---|
POST /v1/yield/discover | $0.01 | Vault discovery and ranking |
POST /v1/yield/prepare | $0.01 | Strategy and execution prep (deposit, redeem, rebalance) |
POST /v1/yield/execute | Free | Execution |
GET /v1/yield/status | Free | Monitoring |
GET /v1/yield/history | Free | Monitoring |
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:
POST /v1/yield/prepare responds with HTTP 402 Payment Required and payment requirements- Your client attaches the
X-PAYMENT header with the payment proof
- 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:
| Step | Endpoint | Cost |
|---|
| Discover vaults | POST /v1/yield/discover | $0.01 |
| Get strategy + calldata | POST /v1/yield/prepare | $0.01 |
| Execute on-chain | POST /v1/yield/execute | Free (+ gas) |
| Check position | GET /v1/yield/status | Free |
| Total | | $0.02 + gas |
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.
