Documentation

Build with Payprr

Integrate X402 micropayments into your AI agents or monetize your APIs. Pay-per-request, instant settlement, no subscriptions.

How It Works

Payprr uses the X402 protocol to enable pay-per-request API calls. When you make a request, payment happens atomically with the API call.

1
Request
Send API request with X402 payment header
2
Verify
Payment is verified by the facilitator
3
Settle
USDG transfers instantly to the provider
No subscriptions, no monthly fees
Pay exactly for what you use. $0.001 per request means 1000 requests = $1.

Making Requests

To call a Payprr API, include the X402 payment payload in your request header. The payment is processed atomically with your API call.

example.ts
import { createX402Payment } from '@x402/sdk';

// Create payment payload
const payment = await createX402Payment({
  amount: '0.001', // Price in USD
  asset: 'USDG',
  network: 'eip155:4663', // Robinhood Chain
  recipient: 'payprr.eth',
});

// Make the API call
const response = await fetch('https://payprr.com/api/x402/weather?location=Paris', {
  headers: {
    'X-Payment': payment.payload,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
// { success: true, data: { location: {...}, current: {...} } }

Required Headers

X-PaymentX402 payment payload (required)
Content-Typeapplication/json (for POST requests)

Available Services

All services are available at https://payprr.com

ServiceEndpointPrice
Weather API
Real-time weather data for any location
GET /api/x402/weather$0.001
Crypto News Feed
Aggregated crypto news from major sources
GET /api/x402/news$0.001
Token Screener
Token analysis and risk scoring
POST /api/x402/screen$0.003
Weekend Risk Score
Market timing risk analysis
POST /api/x402/risk$0.002
Twitter/X Feed
Twitter search and user timelines
GET /api/x402/twitter$0.002

For Providers

Deploy your API on Payprr and earn per request. Set your price, we handle payments.

my-service.ts
import { serve } from '@payprr/sdk';

export default serve({
  name: 'My Weather Service',
  description: 'Real-time weather data',
  price: 0.001, // $0.001 per request

  handler: async (req) => {
    const { city } = await req.json();

    // Your logic here
    const weather = await fetchWeatherData(city);

    return {
      temperature: weather.temp,
      conditions: weather.description,
      humidity: weather.humidity,
    };
  },
});

// Deploy with: npx payprr deploy

What you get

  • Instant USDG payouts
  • Only 1% platform fee
  • Built-in discovery
  • Analytics dashboard

Requirements

  • Node.js 18+ or compatible runtime
  • HTTP endpoint that returns JSON
  • EVM wallet to receive USDG

FAQ

What is USDG?

USDG is a stablecoin on Robinhood Chain, pegged 1:1 to USD. Prices are set in USD, payments settle in USDG.

Do I need crypto knowledge?

Minimal. You need an EVM wallet to receive payments. No gas fees to manage as a provider - the payer covers transaction costs.

How fast are payments?

Instant. Payments settle on-chain with each API request. No invoicing, no net-30 terms.

What is the platform fee?

Just 1%. If you earn $100, you keep $99. Compare that to 20%+ on other API marketplaces.

Can I use this with my AI agent?

Yes! Payprr is designed for AI-to-AI payments. Your agent can autonomously call APIs and pay per request.

Ready to get started?

Browse available services or deploy your own API.