RelAI Documentation

Everything you need to know about using RelAI for API monetization

RelAI enables instant API monetization using the x402 protocol. Accept micropayments in cryptocurrency for every API call, with automatic payment verification and settlement.

Whether you're an API provider looking to monetize your services or a developer seeking pay-per-use APIs, RelAI makes it simple and secure.

Quick Start

Get started with RelAI in under 5 minutes

Upload Your API

To monetize your API with RelAI, start by uploading your OpenAPI specification:

1. Go to your Dashboard
2. Click "Add New API"
3. Upload your OpenAPI/Swagger specification file (JSON or YAML)
4. RelAI will automatically parse your endpoints and parameters

Set Pricing

Configure pricing for your API endpoints:

• Set price per API call in USD or cryptocurrency
• Different endpoints can have different prices
• Choose between exact pricing or max amount
• Select payment facilitator (PayAI, Dexter, RelAI)

// Example pricing configuration
{
  "endpoint": "/api/data",
  "price": "$0.01",
  "network": "solana",
  "facilitator": "payai"
}

Publish API

Once configured, publish your API to the marketplace:

• Review your API configuration
• Set visibility (public or private)
• Add description and documentation
• Click "Publish" to make it available

Integration Guide

For API Providers

Using RelAI Platform:

1. Create API on RelAI:
   • Go to Dashboard
   • Click "Add New API"
   • Select your network (Solana, Base, SKALE Base)
   • Choose payment facilitator (automatically selected for SKALE Base)
   • Set your pricing (e.g., $0.01 per call)
2. Configure your API:
   • Upload OpenAPI specification
   • Set your payment wallet address
   • Publish to marketplace
3. That's it! RelAI handles all x402 v2 payment processing and gas sponsoring automatically.

Browse APIs

Discover APIs in the RelAI marketplace:

• Browse by category or search
• View pricing and documentation
• Test endpoints before committing

Manage Payments

Track your API usage and payments:

• View transaction history in Dashboard
• Export payment reports

x402 Protocol

RelAI is built on the x402 protocol, an open standard for HTTP payment requests:

• HTTP 402 status code for payment required
• Standardized payment headers and responses
• Support for multiple blockchains (Solana, Base, SKALE)
• Facilitator-based payment verification

Authentication

RelAI supports multiple authentication methods:

• Wallet-based authentication
• API keys for server-to-server
• OAuth 2.0 integration
• Custom authentication schemes

Security

Security best practices:

• All payments verified on-chain
• HTTPS required for all API calls
• Rate limiting and DDoS protection
• Regular security audits

Webhooks

RelAI supports webhooks to notify your server about payment events in real-time. When a payment is successfully processed, RelAI sends a POST request to your configured webhook URL.

Webhook Setup

1. Go to your API Dashboard
2. Open Settings tab for your API
3. Find the Webhook URL field
4. Enter your webhook endpoint URL (must be HTTPS in production)
5. Save changes

Webhook Payload

When a payment is completed, RelAI sends a POST request with the following JSON payload:

{
  "event": "payment.completed",
  "apiId": "1234567890abc",
  "timestamp": "2026-02-05T21:44:00.000Z",
  "transaction": "0x1234...abcd",
  "network": "solana",
  "amount": "0.01",
  "payer": "D1rUgfkappgDW4nB...",
  "recipient": "7xKXtg2CW87d97T...",
  "endpoint": "/api/generate",
  "method": "POST"
}

Payload Fields

Header: X-Webhook-Event: payment.completed

Example Webhook Handler

Node.js / Express example:

app.post('/webhook', express.json(), (req, res) => {
  const event = req.headers['x-webhook-event'];
  
  if (event === 'payment.completed') {
    const { apiId, transaction, amount, payer, network } = req.body;
    
    console.log(`Payment received: ${amount} USD from ${payer}`);
    console.log(`Transaction: ${transaction} on ${network}`);
    
    // Your business logic here
    // e.g., grant access, update database, send confirmation
  }
  
  // Always respond with 200 OK
  res.status(200).json({ received: true });
});