x402.direct -- Service Directory

The x402.direct API is a directory of x402-enabled services. It indexes services that accept x402 payments (HTTP 402 + crypto) and provides search, browsing, and trust scoring.

Base URL: https://x402.direct

Endpoints

1. Search (Paid -- $0.001 via x402)

GET /api/search?q=<query>

Full-text search across all indexed services. Results ranked by blended text relevance + trust score. Protected by x402 middleware -- first request returns HTTP 402, re-send with payment proof.

Parameters:

Example:

curl "https://x402.direct/api/search?q=weather+api&minScore=60&limit=5"

Response shape:

{
  "query": "weather api",
  "count": 3,
  "results": [
    {
      "id": 42,
      "resourceUrl": "https://example.com/api/weather",
      "description": "Real-time weather data for any location",
      "category": "weather",
      "provider": "example.com",
      "network": "base-mainnet",
      "price": "1000",
      "priceUsd": "0.001",
      "scoutScore": 85,
      "scoutVerdict": "safe",
      "relevance": 0.3214,
      "score": 58.11
    }
  ]
}

x402 payment flow:

1. Send GET to /api/search?q=... with no payment header.
2. Server returns HTTP 402 with payment details in the response body (price, network, payTo address, facilitator URL).
3. Pay $0.001 USDC on Base (via agent wallet or Coinbase Agentic Wallet).
4. Re-send the same request with X-402-Payment: <proof> header.
5. Server verifies payment via facilitator and returns search results.

If using an x402-aware HTTP client (e.g., x402 npm package), the payment is handled automatically:

import { createX402Client } from "x402";
const client = createX402Client({ wallet: agentWallet });
const resp = await client.fetch("https://x402.direct/api/search?q=weather+api");

2. Browse Services (Free)

GET /api/services

Paginated list of all indexed services.