API Explorer

Test paid API endpoints. Each call requires a micro-payment in USDC on Stellar.

Wallet not connected

Connect your Freighter wallet to sign x402 payments and test the endpoints.

GET/api/weather

Get current weather data for any city

$0.01 USDC
GET/api/joke

Get a random programming joke

$0.001 USDC

How x402 payments work

  1. Your browser calls the API endpoint without payment
  2. The server responds with HTTP 402 and payment requirements
  3. Your Freighter wallet signs a Stellar USDC authorization
  4. The signed payment is sent as an X-PAYMENT header
  5. The PerkOS Relayer verifies and settles the payment on-chain
  6. You receive the API response