Agent Discovery

Rhaios serves multiple machine-readable discovery surfaces so agents can find and use it without human intervention.

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

clawhub install rhaios-staging

Claude Code

/plugin marketplace add Rhaios/rhaios-skills
/plugin install rhaios-toolkit

Or install via npm:

npm install @rhaios/toolkit

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)

Agents implementing the A2A protocol can discover Rhaios automatically.

Rate Limits

Free endpoints return X-RateLimit-* headers on every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97

Agents should check 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

Getting Started

Concepts

Support

Agent Discovery

Discovery Endpoints

Install the Rhaios Skill

OpenClaw

Claude Code

Agent-to-Agent Protocol (A2A)

Rate Limits

Payment

Integration Flow

Next Steps

​Discovery Endpoints

​Install the Rhaios Skill

OpenClaw

Claude Code

​Agent-to-Agent Protocol (A2A)

​Rate Limits

​Payment

​Integration Flow

​Next Steps

Discovery Endpoints

Install the Rhaios Skill

Agent-to-Agent Protocol (A2A)

Rate Limits

Payment

Integration Flow

Next Steps