x402-directDiscover and search x402-enabled services via the x402.direct directory API. Use when an agent needs to find paid API services that accept x402 payments, browse the x402 ecosystem, look up service details, check trust scores, or search for specific capabilities (AI, image, weather, search, data, audio, video, developer, finance, language, storage). Triggers on "find x402 service", "x402 directory", "search x402", "x402 API", "paid API search", "x402.direct", agent-to-agent payments, crypto-native API discovery.
Install via ClawdBot CLI:
clawdbot install JovannyEspinal/x402-directThe 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
```
GET /api/search?q=
```
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:
| Param | Type | Required | Description |
|----------|---------|----------|--------------------------------------|
| q | string | yes | Search query (max 500 chars) |
| category | string | no | Filter by category |
| network | string | no | Filter by blockchain network |
| maxPrice | string | no | Max price in atomic units (bigint) |
| minScore | integer | no | Minimum trust score (0-100) |
| limit | integer | no | Max results (default 20, max 50) |
Example:
```bash
curl "https://x402.direct/api/search?q=weather+api&minScore=60&limit=5"
```
Response shape:
```json
{
"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:
/api/search?q=... with no payment header.X-402-Payment: header.If using an x402-aware HTTP client (e.g., x402 npm package), the payment is handled automatically:
```typescript
import { createX402Client } from "x402";
const client = createX402Client({ wallet: agentWallet });
const resp = await client.fetch("https://x402.direct/api/search?q=weather+api");
```
```
GET /api/services
```
Paginated list of all indexed services. No payment required.
Parameters:
| Param | Type | Default | Description |
|----------|---------|---------|--------------------------------------|
| page | integer | 1 | Page number |
| limit | integer | 50 | Results per page (max 100) |
| category | string | -- | Filter by category |
| network | string | -- | Filter by network |
| sort | string | score | Sort: score, newest, price |
| minScore | integer | -- | Minimum trust score (0-100) |
Examples:
```bash
curl "https://x402.direct/api/services?category=ai&sort=score&limit=10"
curl "https://x402.direct/api/services?network=base-mainnet&sort=newest"
curl "https://x402.direct/api/services?minScore=70&sort=score"
```
Response shape:
```json
{
"services": [
{
"id": 1,
"resourceUrl": "https://example.com/api/generate",
"type": "x402",
"description": "AI text generation endpoint",
"category": "ai",
"provider": "example.com",
"network": "base-mainnet",
"scheme": "exact",
"price": "5000",
"priceUsd": "0.005",
"scoutScore": 92,
"scoutVerdict": "safe",
"lastSeen": "2025-05-01T12:00:00.000Z",
"createdAt": "2025-04-15T08:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 127,
"totalPages": 3
}
}
```
```
GET /api/services/:id
```
Full details for a single service including payment options, raw metadata, and facilitator info.
Example:
```bash
curl "https://x402.direct/api/services/42"
```
Response shape:
```json
{
"id": 42,
"resourceUrl": "https://example.com/api/weather",
"type": "x402",
"x402Version": "1",
"description": "Real-time weather data for any location",
"mimeType": "application/json",
"category": "weather",
"provider": "example.com",
"network": "base-mainnet",
"scheme": "exact",
"price": "1000",
"priceUsd": "0.001",
"payTo": "0xAbC123...",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"scoutScore": 85,
"scoutVerdict": "safe",
"accepts": [{"scheme": "exact", "network": "base-mainnet", "maxAmountRequired": "1000", "asset": "..."}],
"metadata": {"description": "...", "mimeType": "application/json"},
"lastSeen": "2025-05-01T12:00:00.000Z",
"lastUpdated": "2025-05-01T12:00:00.000Z",
"createdAt": "2025-04-15T08:00:00.000Z",
"facilitator": {
"name": "x402.org",
"url": "https://x402.org/facilitator",
"facilitatorId": "x402-org-mainnet"
}
}
```
```
GET /api/stats
```
High-level directory statistics. Good for dashboards or understanding the ecosystem at a glance.
Example:
```bash
curl "https://x402.direct/api/stats"
```
Response shape:
```json
{
"services": 247,
"providers": 38,
"categories": 12,
"facilitators": 3,
"avgScoutScore": 62,
"networks": [
{ "network": "base-mainnet", "count": 180 },
{ "network": "base-sepolia", "count": 45 },
{ "network": "polygon", "count": 15 },
{ "network": "solana", "count": 7 }
]
}
```
Categories: ai, image, weather, search, data, audio, video, developer, finance, language, storage, other
Networks: base-mainnet, base-sepolia, polygon, solana (more may appear as the ecosystem grows)
Sort options: score (trust score, default), newest (creation date), price (cheapest first)
Every service is scored 0-100 based on automated trust signals:
Verdicts:
| Score Range | Verdict | Meaning |
|-------------|-----------|----------------------------------------|
| 70-100 | safe | Well-documented, mainnet, custom domain |
| 40-69 | caution | Some trust signals missing |
| 0-39 | avoid | Missing critical trust signals |
Recommendation: Use minScore=60 or higher when searching for production-ready services. Use minScore=0 only when exploring or debugging.
Find a service for a specific task:
```bash
curl "https://x402.direct/api/services?category=image&sort=score&minScore=60&limit=5"
```
Search with specific capability in mind (paid):
```bash
curl "https://x402.direct/api/search?q=text+to+speech&minScore=70" \
-H "X-402-Payment:
```
Get full details before calling a service:
```bash
curl "https://x402.direct/api/services/42"
```
Check ecosystem health:
```bash
curl "https://x402.direct/api/stats"
```
| Goal | Endpoint | Cost |
|-----------------------------------|-------------------|-------|
| Browse by category/network | /api/services | Free |
| Get service payment details | /api/services/:id | Free |
| Natural language search | /api/search | $0.001 |
| Ecosystem overview | /api/stats | Free |
Prefer /api/services with filters when the category is known. Use /api/search when the agent needs semantic/keyword matching across descriptions and providers.
Generated Mar 1, 2026
An AI agent needs to find a paid API for image generation that accepts x402 payments. The agent uses the search endpoint to query for image APIs, filters by trust score to ensure reliability, and completes the payment flow to access results, enabling seamless integration of external services.
A developer building a decentralized application requires weather data APIs that support crypto payments. They browse the directory to find services on Base mainnet, check details for pricing and network compatibility, and integrate the API using an x402-aware client for automated payments.
A company wants to curate a list of trusted paid APIs for internal use, focusing on finance and data categories. They use the browse endpoint to filter by high trust scores and categories, then retrieve service details to evaluate providers and set up whitelists for secure access.
An autonomous agent needs to pay another agent for language processing services. It searches the directory for language APIs, verifies payment details via the service endpoint, and uses the x402 payment flow with proof headers to automate transactions without manual intervention.
A startup launching a new API service registers it in the x402 directory to gain visibility. They monitor their trust score and use the details endpoint to provide transparency to users, helping attract customers by showcasing payment options and reliability metrics.
The directory charges a small fee ($0.001) for each search query via x402 payments, generating revenue from users discovering services. This model incentivizes high-quality listings and scales with increased API usage across the ecosystem.
Basic listing and browsing are free to encourage adoption, while premium features like enhanced visibility or analytics could be offered for a subscription or one-time fee. This attracts a broad user base and monetizes advanced needs.
Revenue is generated by charging service providers for trust score assessments or verification badges, ensuring reliability for users. This adds value by reducing risk and can be bundled with directory inclusion fees.
💬 Integration Tip
Use an x402-aware HTTP client like the x402 npm package to automate payment handling; always check trust scores and network compatibility before integrating services to ensure reliability.
Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever.
ERC-8004 Trustless Agents - Register, discover, and build reputation for AI agents on Ethereum. Use when registering agents on-chain, querying agent registries, giving/receiving reputation feedback, or interacting with the AI agent trust layer.
Autonomous crypto trading on Base via Bankr. Use for trading tokens, monitoring launches, executing strategies, or managing a trading portfolio. Triggers on "trade", "buy", "sell", "launch", "snipe", "profit", "PnL", "portfolio balance", or any crypto trading task on Base.
Deploy ERC20 tokens on Base using Clanker SDK. Create tokens with built-in Uniswap V4 liquidity pools. Supports Base mainnet and Sepolia testnet. Requires PRIVATE_KEY in config.
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
Interact with Solana blockchain via Helius APIs. Create/manage wallets, check balances (SOL + tokens), send transactions, swap tokens via Jupiter, and monitor addresses. Use for any Solana blockchain operation, crypto wallet management, token transfers, DeFi swaps, or portfolio tracking.