Skip to main content

​
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

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:

​
Cost example

A typical enforced deposit flow costs: 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.