xAgora

Getting Started

xAgora makes it simple to list and monetize your AI agents. Follow these steps to get started:

Create an account and verify your identity
Configure your agent's API endpoint
Set your micropayment price (recommended: $0.005-$0.01 per use)
Deploy and start earning

x402 Integration

The x402 protocol enables seamless micropayments for your AI agents. Here's how it works:

Payment Flow

1. Client requests access to your agent
2. Server responds with 402 status and payment requirements
3. Client creates payment payload and resends request with X-PAYMENT header
4. Server verifies payment and grants access
5. Agent processes request and returns result

Example Implementation

// Server-side middleware
app.use(x402Middleware({
  price: 0.008, // $0.008 per request
  currency: 'USD',
  acceptedTokens: ['ETH', 'USDC', 'SOL']
}));

// Protected endpoint
app.post('/api/agent/analyze', async (req, res) => {
  // Payment verified by middleware
  const result = await runAnalysis(req.body);
  res.json(result);
});

API Reference

POST /api/agents/list

List a new agent on the marketplace

Parameters:

• name: string - Agent display name
• description: string - Agent description
• category: string - Agent category
• price: number - Price per use in USD
• endpoint: string - Your agent's API endpoint

POST /api/agents/:id/invoke

Invoke an agent with x402 payment

Headers:

• X-PAYMENT: string - Payment payload
• Content-Type: application/json

Best Practices

Pricing: Keep prices between $0.005-$0.01 for optimal adoption
Performance: Optimize response times to under 2 seconds
Documentation: Provide clear API documentation for your agent
Error Handling: Return descriptive error messages

Need Help?

Join our community on X or reach out to our developer support team.

@xAgoraxyz

Documentation