x402 Search API

Search and discovery API for x402 protocol resources

Base URL:https://api.rencom.ai

Payment Protocol

This API uses the x402 protocol for payments. The /x402/v1/paid/search endpoint costs $0.01 USDC per request on the Base network.

The /health endpoint is free.

Endpoints

GET/x402/v1/paid/search$0.01/request

Search x402 resources with x402 payment protocol. Same functionality as /x402/v1/search but requires x402 payment instead of API key. This endpoint is discoverable in the x402 Bazaar (in production).

Query Parameters

qstring

Search query string

sort_bystring

default: recommended

Sort method for results

limitinteger

default: 3

Maximum results to return

Range: 1 - 5

offsetinteger

default:

Offset for pagination

Example Request

GET https://api.rencom.ai/x402/v1/paid/search?q=trading&sort_by=recommended&limit=3

Response

200 OKapplication/json

{
  "results": [
    {
      "id": 123,
      "resource": "https://api.example.com/v1/trading",
      "description": "Real-time trading data API with global coverage",
      "max_amount_required": 1000000,
      "network": "base",
      "final_score": 0.92
    }
  ],
  "has_more": true,
  "limit": 3,
  "offset": 0,
  "query": "trading api",
  "sort_by": "recommended"
}

Response Fields

resultsarrayRequired

Ranked search results

has_morebooleanRequired

Whether more results are available

limitintegerRequired

Requested limit

offsetintegerRequired

Requested offset

queryobject

Original search query

sort_byobject

Sort method used

GET/healthFree

Health check endpoint for Cloud Run probes.

Response

200 OKapplication/json

{
  "status": "healthy",
  "timestamp": "2024-01-15T10:30:00Z"
}

GET/Free

Root endpoint with API info.

Response

200 OKapplication/json

{
  "name": "Rencom API",
  "version": "2.0.0",
  "endpoints": {
    "/x402/v1/paid/search": "Search x402 resources",
    "/health": "Health check"
  }
}