Skip to content
LogoLogo

Try Radius

Create a wallet, send SBC, and pay for an API request

View as Markdown

Everything on this page runs on Radius Testnet with test funds. Each step calls the same radius-sdk functions you use in your own code, and links every transaction to the testnet explorer.

1. Create and fund a wallet

Create a wallet, then click Get testnet SBC. The faucet sends 0.5 SBC, the payment asset, and a small amount of RUSD, the native fee asset.

Testnet walletTestnet

Loading wallet…

The private key is generated in your browser and stays in its local storage. The other examples in these docs use the same wallet. In your own code, createRadiusFetch takes the key as signer, and fund() calls the testnet faucet.

2. Send SBC

Send SBC to any address. The default recipient is the testnet faucet, so the test funds go back to it.

Send SBCTestnet

Loading wallet…

The time includes signing, sending, and waiting for the transaction receipt: Radius confirms transactions with sub-second finality. The fee is a fixed gas price paid in RUSD. A wallet that holds only SBC can still send, because the Turnstile converts SBC to RUSD when a transaction needs gas.

3. Pay for an API request

This page's API sells an IP reputation lookup for 0.001 SBC per request, and a full report for 0.05 SBC. Payments go back to the testnet faucet. It is built with radiusPayments from radius-sdk/hono, like the seller in accept payments.

  1. Click Request without paying. The API answers 402 Payment Required and describes the price in the PAYMENT-REQUIRED header.
  2. Click Pay and request. The client reads the offer, checks it against your limit, signs a payment authorization, and sends the request again. The API settles the payment and returns the data in the same response.
  3. Choose the report endpoint and pay again. It costs more than your 0.01 SBC limit, so the client refuses before it signs anything.
Pay for an API requestTestnet

Loading wallet…

The wallet pays without an approval transaction. The Radius facilitator sponsors the one-time Permit2 approval for SBC, so a new wallet needs only SBC to pay. See x402 payments for the full request lifecycle.

Build it yourself