API Documentation

Complete reference for OMA-AI REST API

Base URL

https://oma-ai.com/api

Authentication

Most endpoints require authentication via Bearer token. Include the token in the Authorization header:

Authorization: Bearer YOUR_TOKEN_HERE

Rate Limiting

Tier	Requests/min	Daily Limit
Free	60	1,000
Pro	300	50,000
Enterprise	Unlimited	Unlimited

Response Format

// Success Response
{
  "success": true,
  "data": { ... },
  "pagination": { ... }
}

// Error Response
{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}

x402 Payments

OMA-AI uses x402 (EIP-3009) for payment authorization. Some MCP endpoints require payment before access.

Call /api/x402/sign with amount and MCP ID
Receive signed EIP-712 authorization
Include in request header: X-Payment-Authorization
MCP executes call and receives payment via transfer