> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoints

> Complete endpoint surface of the Ryvo Gateway.

This page documents every route exposed by the deployed gateway. Paid Solana routes are enumerated programmatically at [`GET /v1/catalog`](/gateway/catalog), and the full matrix is documented in [Routes](/gateway/routes/solana-rpc).

## Public endpoints

### Health

<ResponseField name="GET /healthz" type="route">
  Returns `{ ok: true, service: "ryvo-gateway", status: "healthy" }`. Use this as a liveness probe.
</ResponseField>

### Catalog

<ResponseField name="GET /v1/catalog" type="route">
  Returns every enabled route with its access mode, price, and schemas. Supports `?provider=alchemy|helius|tokens`. See [Catalog](/gateway/catalog).
</ResponseField>

### Solana RPC

<ResponseField name="POST /v1/x402/solana/{cluster}/{provider}/rpc/{method}" type="route">
  Paid Solana RPC proxy. `cluster` ∈ `mainnet, devnet`. `provider` ∈ `alchemy, helius`. `method` ∈ `getBalance, getAccountInfo, getTransaction, getSignaturesForAddress, getTokenAccountsByOwner, getProgramAccounts` (all providers) plus `getTransactionsForAddress` (Helius-only enhanced history). Access mode `exact`. See [Solana RPC routes](/gateway/routes/solana-rpc).
</ResponseField>

### Solana DAS

<ResponseField name="POST /v1/x402/solana/{cluster}/{provider}/das/{method}" type="route">
  Paid Solana DAS proxy. `cluster` ∈ `mainnet, devnet` (Alchemy DAS is mainnet-only). `provider` ∈ `alchemy, helius`. `method` ∈ `getAsset, getAssetsByOwner, searchAssets`. Access mode `exact`. See [Solana DAS routes](/gateway/routes/solana-das).
</ResponseField>

### Helius Wallet API

<ResponseField name="GET /v1/x402/helius/wallet/identity/:wallet" type="route">
  Paid Helius Wallet API identity lookup (mainnet-only). Accepts a base58 address, SNS `.sol` domain, or ANS custom TLD. Access mode `exact`, 100 credits per call. See [Helius Wallet API routes](/gateway/routes/helius-wallet).
</ResponseField>

<ResponseField name="POST /v1/x402/helius/wallet/batch-identity" type="route">
  Paid Helius Wallet API batch identity lookup. Body: `{ "wallets": string[] }` with 1–100 entries. Access mode `exact`, 100 credits per call.
</ResponseField>

<ResponseField name="GET /v1/x402/helius/wallet/{balances|history|transfers|funded-by}/:wallet" type="route">
  Paid Helius Wallet API data routes (mainnet-only). Query params vary per method. Access mode `exact`, 100 credits per call. See [Helius Wallet API routes](/gateway/routes/helius-wallet).
</ResponseField>

### Tokens API

<ResponseField name="GET /v1/x402/tokens/..." type="route">
  Wallet-authenticated Tokens API proxy. Access mode `siwx`. See [Tokens API routes](/gateway/routes/tokens-api) for the full list.
</ResponseField>

<ResponseField name="POST /v1/x402/tokens/assets/market-snapshots" type="route">
  Batch lookup cached market snapshots for Solana mints. Access mode `siwx`. `mints` + `addresses` combined must contain 1–250 ids.
</ResponseField>

## CORS and OPTIONS

Every public route supports `OPTIONS` preflight with `Access-Control-Allow-Origin: *` and the following headers:

* Allow-methods: the route's canonical method plus `OPTIONS`.
* Allow-headers: `Content-Type, PAYMENT-SIGNATURE, X-PAYMENT, X-PAYMENT-RESPONSE, PAYMENT-RESPONSE, SIGN-IN-WITH-X, Authorization`.
* Expose-headers: `Content-Type, WWW-Authenticate, X-PAYMENT-RESPONSE, PAYMENT-RESPONSE`.

`HEAD` is accepted on every route that accepts `GET`, and returns the same headers with an empty body.

## Discovery

x402 discovery crawlers are supported. Paid routes return `402 Payment Required` even for empty-body probes, so crawlers can inspect schemas and prices without triggering settlement.

## See also

* [Catalog](/gateway/catalog)
* [Access modes](/gateway/access-modes)
* [Payment headers](/gateway/reference/payment-headers)