Skip to main content

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.

Paid x402 routes are priced from each upstream provider’s public PAYG schedule plus a flat gateway settlement surcharge of $0.0006 per paid call. This surcharge covers the Solana transaction cost required to settle each exact-payment request. x402 paid routes settle in USDC on Solana mainnet. Ryvo channel routes are denominated in official devnet USDC token amounts and settle later through Ryvo Protocol bundle settlement.

​
Alchemy - Compute Unit pricing

Alchemy routes are priced on their Solana PAYG compute-unit schedule.
  • Reference price: $0.45 per 1,000,000 CU
  • Pricing source checked: official Alchemy Solana PAYG docs on 2026-04-18.
Per-method Compute Units used by the gateway:

​
RPC

MethodCompute Units
getBalance10
getAccountInfo10
getTransaction40
getSignaturesForAddress40
getTokenAccountsByOwner10
getProgramAccounts20

​
DAS

MethodCompute Units
getAsset80
getAssetsByOwner480
searchAssets480
The per-call USDC price is: 
price_usd = ( ceil( (cu × 450_000) / 1_000_000 ) + 600 ) / 1_000_000
Where the numerator is in USDC micro-units (six decimal places), and 600 micro-USDC is the flat transaction-fee surcharge.

​
Helius - per-credit pricing

Helius routes are priced on their additional-credits schedule.
  • Reference price: $5 per 1,000,000 credits
  • Pricing source checked: official Helius docs on 2026-04-18.
Per-method credits used by the gateway:

​
RPC

MethodCredits
getBalance1
getAccountInfo1
getTransaction1
getSignaturesForAddress1
getTokenAccountsByOwner1
getProgramAccounts10
getTransactionsForAddress50

​
DAS

MethodCredits
getAsset10
getAssetsByOwner10
searchAssets10

​
Helius Wallet API

Helius Wallet API routes are available on mainnet and devnet path families. Every route costs the same flat amount.
MethodCredits
identity100
batchIdentity100
balances100
history100
transfers100
fundedBy100
Per-call USDC price: 
price_usd = ( ceil( (credits × 5_000_000) / 1_000_000 ) + 600 ) / 1_000_000
Again, 600 micro-USDC is the fixed surcharge applied to every x402 paid route.

​
Tokens API - no per-call price

Tokens API routes are auth-only. The gateway holds the Tokens API key server-side and exposes it to clients via a SIWX signature. There is no per-request USDC settlement. Tokens API routes still sit behind the x402 challenge/response flow, the client must present a valid wallet signature, but no transfer is created. See Access modes for the mechanics.

​
Ryvo channel pricing

For /v1/ryvo-channel/... routes, the catalog publishes token-denominated pricing:
FieldValue
accessModeryvo-channel
priceTokenAmountSix-decimal official devnet USDC amount
tokenSymbolUSDC
tokenDecimals6
tokenMint4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
V1 channel prices are derived 1:1 from the existing USD schedule into nominal devnet USDC amounts, then compared as integer six-decimal token amounts. Tokens API routes remain SIWX/auth-only and do not use payment channels.

​
How prices are advertised

Every x402 paid route advertises its price in two places:
  1. In the route’s 402 Payment Required envelope as maxAmountRequired, expressed in micro-USDC.
  2. In the catalog entry as priceUsd, expressed as a decimal string.
Clients that use @x402/fetch or any x402 library will pick up the price automatically from the challenge envelope, there is no need to hard-code prices. Channel-backed routes advertise priceTokenAmount in the catalog and require the client to increment its signed cumulative commitment by exactly that amount.

​
See also