API Documentation

Search indexed x402 endpoints by keyword, category, price, or health status.

Query Parameters

Example

GET /api/search?q=crypto&maxPrice=0.05&healthyOnly=true

{
  "count": 12,
  "results": [
    {
      "id": "aHR0cHM6Ly9hcGk...",
      "url": "https://api.example.com/prices",
      "domain": "api.example.com",
      "description": "Real-time crypto prices for BTC, ETH, SOL",
      "priceUsd": 0.001,
      "category": "crypto-data",
      "health": "healthy",
      "tier": "A",
      "score": 87
    }
  ]
}

Get aggregate statistics about all indexed endpoints.

{
  "indexed": "2026-01-29T14:30:00.000Z",
  "total": 523,
  "healthy": 312,
  "healthRate": "59.7%",
  "avgPriceUsd": "0.0156",
  "uniqueDomains": 127
}

List all categories with endpoint counts.

{
  "categories": {
    "ai/ml": 89,
    "crypto-data": 76,
    "defi": 54,
    "content/ipfs": 38,
    "news": 31,
    "weather": 12,
    "other": 223
  }
}

Check USDC balance for any wallet on Base. Useful for verifying agent wallets before transactions.

URL Parameters

Example

GET /api/verify/0xf5b62393d8e26c8ae2f8074adc6f6aec8b1d1bc1

{
  "wallet": "0xf5b62393d8e26c8ae2f8074adc6f6aec8b1d1bc1",
  "usdcBalance": 12.45,
  "basescanUrl": "https://basescan.org/address/0xf5b...#tokentxns",
  "usdcContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "network": "Base (eip155:8453)",
  "verifiedAt": "2026-01-29T14:30:00.000Z"
}

Submit a new x402 endpoint for indexing. We verify it returns 402 before adding.

Request Body (JSON)

Example

POST /api/submit
Content-Type: application/json

{
  "url": "https://myapi.com/data",
  "description": "Real-time market data feed"
}

// Success
{ "success": true, "message": "Verified and added to index!" }

// Error
{ "error": "Not a valid x402 endpoint (got HTTP 200, expected 402)" }

Deep analytics: most reliable endpoints, best value services, price distribution stats.

{
  "mostReliable": [
    { "url": "https://...", "domain": "api.example.com", "ms": 142, "score": 95 }
  ],
  "bestValue": [
    { "url": "https://...", "price": 0.001, "score": 88 }
  ],
  "priceDistribution": { "min": 0.0001, "max": 0.5, "avg": 0.0156 },
  "totalIndexed": 523
}

Discover newest endpoints and top-tier rated services.

{
  "newest": [
    { "url": "https://...", "domain": "...", "price": 0.01, "category": "ai/ml" }
  ],
  "topTier": [
    { "url": "https://...", "domain": "...", "score": 95, "price": 0.005 }
  ]
}

Compare multiple endpoints side-by-side.

Query Parameters

GET /api/premium/compare?urls=https://api1.com/data,https://api2.com/data

{
  "compared": [
    { "url": "https://api1.com/data", "found": true, "price": 0.01, "health": "healthy", "score": 85, "tier": "A" },
    { "url": "https://api2.com/data", "found": true, "price": 0.02, "health": "degraded", "score": 62, "tier": "B" }
  ]
}

AI-powered endpoint recommendations. Describe what you need in plain language.

Query Parameters

GET /api/premium/recommend?need=I need real-time BTC prices&maxPrice=0.01

{
  "need": "I need real-time BTC prices",
  "found": 5,
  "recommendations": [
    {
      "url": "https://...",
      "domain": "crypto-oracle.xyz",
      "description": "Live BTC/USD prices updated every second",
      "matchScore": 85,
      "quality": "A",
      "score": 92,
      "price": 0.001,
      "health": "healthy"
    }
  ]
}

Detailed reputation and reliability history for a specific endpoint.

Query Parameters

{
  "url": "https://api.example.com/data",
  "domain": "api.example.com",
  "description": "Market data API",
  "reputation": {
    "overallScore": 87,
    "tier": "A",
    "uptimePercent": "99.2",
    "avgResponseTime": 156,
    "checksTotal": 10,
    "checksPassed": 10,
    "lastCheck": "2026-01-29T14:25:00.000Z",
    "trend": "stable",
    "healthStatus": "healthy"
  },
  "breakdown": {
    "uptimeScore": 100,
    "speedScore": 100,
    "documentationScore": 70,
    "freshnessScore": 100
  }
}

Get the top-rated endpoint in each category. Find the best service across all categories in one call.

{
  "totalCategories": 11,
  "leaders": {
    "ai/ml": { "url": "https://...", "domain": "ai-oracle.xyz", "score": 95, "tier": "A", "price": 0.02, "health": "healthy" },
    "crypto-data": { "url": "https://...", "domain": "crypto-feed.io", "score": 92, "tier": "A", "price": 0.001, "health": "healthy" },
    "defi": { "url": "https://...", "domain": "defi-api.com", "score": 88, "tier": "A", "price": 0.005, "health": "healthy" }
  }
}

Find highest quality endpoints within your budget. Optimizes for quality-per-dollar (value score).

Query Parameters

GET /api/premium/budget?maxPricePerCall=0.01&category=crypto-data

{
  "budget": 0.01,
  "category": "crypto-data",
  "found": 23,
  "optimized": [
    { "url": "https://...", "domain": "...", "price": 0.001, "quality": 92, "tier": "A", "health": "healthy", "valueScore": 92000 },
    { "url": "https://...", "domain": "...", "price": 0.002, "quality": 85, "tier": "A", "health": "healthy", "valueScore": 42500 }
  ]
}