# Boon x402 Endpoint Recognition Graph

> Boon x402 Endpoint Recognition Graph 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-14).

Queries a graph of recognized x402 payment endpoints, returning structured data about known endpoints with optional filtering by query, recognizer address, origin, sort order, and context level.

## Facts

- Endpoint: GET https://api.boonprotocol.com/api/v1/x402/graph
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boon-x402-endpoint-recognition-graph-981eacbe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qmzJGrbQV-1kdcFp6hWdT

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-x402-endpoint-recognition-graph-981eacbe
```

Example prompt: Search the Boon x402 recognition graph for payment endpoints matching 'weather', sorted by most reviewed, return up to 20 results with full context.

## When to prefer this

Use this endpoint when you need to discover or search the Boon x402 recognition graph — specifically when filtering by keyword, recognizer wallet, origin domain, or wanting context-enriched endpoint metadata from the x402 ecosystem. Prefer over the raw directory endpoint when you want graph-structured data with recognition context and event history.

## Known failure modes

- Invalid recognizer address format (must be 0x hex 40 chars) returns validation error
- Query string exceeding 160 characters returns schema validation error
- Limit exceeding 50 or eventLimit exceeding 500 returns out-of-range error
- No matching endpoints found returns empty graph
- Payment of $0.01 USDC not included or failed returns 402 Payment Required
- Invalid origin URI format returns validation error

## How this service works

Boon x402 endpoint recognition graph

## Output

Returns a structured graph of recognized x402 endpoints matching the query, including endpoint metadata, recognition counts, recognizer wallet addresses, event history (up to 500 events), and contextual data depending on the context parameter (with/all/raw). Results are sorted by review count or recency.

## 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"
      },
      "eventLimit": {
       "type": "integer",
       "default": 200,
       "maximum": 500,
       "minimum": 1
      },
      "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": {
  "edges": [
   {
    "to": "route:0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e",
    "from": "wallet:0x0000000000000000000000000000000000000002",
    "kind": "recognized",
    "relationshipSignals": {
     "directRelatedParty": false
    }
   }
  ],
  "nodes": [
   {
    "id": "route:0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e",
    "kind": "endpoint"
   },
   {
    "id": "wallet:0x0000000000000000000000000000000000000002",
    "kind": "wallet"
   }
  ],
  "version": "1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boon-x402-endpoint-recognition-graph-981eacbe/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)