Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-test.rye.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
What is x402?

x402 is an open protocol for paying for HTTP requests inline with a signed stablecoin transfer. Rye exposes an x402-native endpoint at https://x402.rye.com that accepts purchases from any x402-compatible client — instead of authenticating with a Rye API key, the caller pays for each request with a signed USDC transfer. It is built for AI agents and other automated clients that hold a crypto wallet but do not have a Rye developer account. It is a thin wrapper around Rye’s standard Checkout Intent flow — the same offer retrieval, order placement, and refund logic — exposed over the x402 wire format. If you already have a Rye API key, you do not need this endpoint. Use the standard Universal Checkout API — x402 is also available there as a payment method on /v1/checkout-intents/:id/confirm.

​
When to use it

Use x402 if all of the following are true:
  • Your client signs HTTP requests from a crypto wallet (Base, Solana, or Tempo)
  • You do not have, or do not want to manage, a Rye API key
  • You are integrating with AgentCash or another x402-native runtime

​
Base URL

EnvironmentBase URL
Productionhttps://x402.rye.com

​
Endpoints

MethodPathFee (USDC)Description
POST/v1/checkout-intents$0.02Create an intent and start offer retrieval
GET/v1/checkout-intents/:idFreeRead intent state and the retrieved offer
POST/v1/checkout-intents/:id/confirmPurchase total + $0.03Confirm the intent and place the order
The exact amount due is quoted in the PAYMENT-REQUIRED header on each 402 response. GET is free so polling does not accrue cost.

​
Flow at a glance

​
Supported networks

NetworkChain ID (CAIP-2)
Baseeip155:8453
Solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Tempoeip155:4217
USDC is the only accepted token on every supported network.

​
Wallet identity

There is no Authorization header and no X-Wallet-Address header on paid calls. The wallet is whatever resolves from authorization.from inside the signed PAYMENT-SIGNATURE payload. A signed request is the authentication — payment and identity are the same.

​
Discovery

The endpoint publishes an OpenAPI 3.1.0 document with x-payment-info annotations on each paid operation, so AgentCash and other x402 clients can discover prices and schemas without prior knowledge of the API: 
curl https://x402.rye.com/openapi.json

​
Next steps

Quickstart with AgentCash

Walkthrough using the AgentCash SDK

Endpoint Reference

Request and response shapes for each call