Discovery Endpoints
| File | URL | Purpose |
|---|---|---|
| A2A Agent Card | /.well-known/agent.json | Google A2A protocol discovery — capabilities, skills, auth |
| Agent Card | /agent-card.json | Full tool schemas, pricing, examples |
| llms.txt | /llms.txt | Concise resource map for LLM retrieval |
| llms-full.txt | /llms-full.txt | Complete machine integration reference |
| OpenAPI spec | https://api.staging.rhaios.com/openapi.json | OpenAPI 3.1 schema for all endpoints |
| agents.txt | /agents.txt | Agent policy (rate limits, auth, payment) |
| robots.txt | /robots.txt | Crawler policy with agent surface allowlists |
Install the Rhaios Skill
The fastest way to integrate is to install the agent skill:OpenClaw
Claude Code
Agent-to-Agent Protocol (A2A)
Rhaios publishes a Google A2A Agent Card at/.well-known/agent.json. This declares:
- Skills: what the agent can do (discover vaults, prepare intents, execute transactions, etc.)
- Authentication: none required (non-custodial — agents bring their own signing keys)
- Input/output modes: JSON over REST
- Payment protocol: x402 (optional on staging)
Rate Limits
Free endpoints returnX-RateLimit-* headers on every response:
X-RateLimit-Remaining and back off when approaching zero. Paid endpoints (gated by x402) bypass rate limits.
Payment
Rhaios supports the x402 protocol for agent-native micropayments. When enabled,yield_prepare returns HTTP 402 with payment instructions that agents fulfill inline using stablecoins.
On staging, x402 is not enforced — all endpoints are free for testing.
Integration Flow
Next Steps
- Installation — step-by-step setup guide
- Quickstart — full API walkthrough
- Architecture — how EIP-7702 delegation works