# Boon Protocol x402 Route Directory

> Boon Protocol x402 Route Directory is a paid API for AI agents from api.boonprotocol.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns a searchable, filterable directory of x402-enabled API endpoints recognized by the Boon Protocol network

## Facts

- Endpoint: GET https://api.boonprotocol.com/api/v1/x402/routes
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boon-protocol-x402-route-directory-ba7a7aa8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qOkEkIrUjEcwK8Cl6HIDf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability boon-protocol-x402-route-directory-ba7a7aa8
```

Example prompt: Show me the top 20 best-reviewed x402 payment-enabled API endpoints in the Boon directory — sort by reviewed and include full context so I can see what each one does.

## When to prefer this

Use this endpoint when you need to discover or search for APIs that support the x402 micropayment protocol, especially when you want curated results ranked by community reviews via Boon's recognition system. Prefer this over generic API directories when your use case specifically involves x402-compatible services or when you want community-validated quality signals.

## Known failure modes

- Invalid recognizer address format (not a valid 0x Ethereum address) returns validation error
- Limit out of range (below 1 or above 50) returns schema validation error
- Invalid sort enum value returns 400 bad request
- No matching routes found returns empty list
- Payment not included or insufficient triggers 402 response requiring $0.01 USDC
- Malformed URI in origin filter returns validation error

## How this service works

Boon recognized x402 endpoint directory

## Output

A list of up to 50 x402-enabled API endpoint routes, each with metadata such as method, origin URL, and associated recognition/review context. Results can be sorted by review quality or recency, and filtered by query text, HTTP method, origin URI, or recognizer wallet address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 160
      },
      "sort": {
       "enum": [
        "reviewed",
        "recent"
       ],
       "type": "string",
       "default": "reviewed"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1
      },
      "method": {
       "type": "string"
      },
      "origin": {
       "type": "string",
       "format": "uri"
      },
      "context": {
       "enum": [
        "with",
        "all",
        "raw"
       ],
       "type": "string",
       "default": "with"
      },
      "recognizer": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "routes": [
   {
    "routeId": "0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e",
    "description": {
     "price": {
      "amount": "0.100000",
      "display": "$0.10",
      "currency": "USD",
      "checkedAt": "2026-07-15T21:03:32Z"
     },
     "route": {
      "method": "POST",
      "publicEndpointUrl": "https://api.locus.report/api/locus-property-update"
     },
     "source": {
      "kind": "agentcash-openapi",
      "label": "AgentCash OpenAPI discovery",
      "checkedAt": "2026-07-15T21:03:32Z",
      "trustTier": "origin_hosted"
     },
     "request": {
      "notes": [
       "Run the free Locus coverage preflight before a paid call",
       "Unsupported coverage returns a free diagnostic instead of a paid artifact",
       "A paid job may be partial when an optional PDF or video sidecar fails"
      ],
      "required": [
       "address"
      ]
     },
     "routeId": "0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e",
     "service": "Locus",
     "summary": "Property Decision Check: Recent & Scheduled Changes",
     "version": "boon.x402-route-description/v1",
     "protocols": [
      "x402",
      "mpp"
     ],
     "receiptAuthority": {
      "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
      "signer": null,
      "source": "live-x402-challenge",
      "status": "not_observed",
      "checkedAt": "2026-07-16T18:24:00Z",
      "signerSource": null
     }
    },
    "reviewSummary": {
     "count": 1,
     "indexComplete": true,
     "latestReviewAt": 1784149204,
     "boonBackedCount": 1,
     "selfReportedCount": 0,
     "receiptVerifiedCount": 0,
     "distinctReviewerWalletCount": 1
    }
   }
  ],
  "version": "1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boon-protocol-x402-route-directory-ba7a7aa8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boonprotocol.com](https://www.zero.xyz/host/api.boonprotocol.com/llms.txt)