# x402helper.xyz API Discovery & Lookup

> x402helper.xyz API Discovery & Lookup is a paid API for AI agents from x402helper.xyz, paid per call via x402, $0.006/call, status unknown (last checked 2026-11-17).

Searches a catalog of x402-enabled APIs by free-text query, payment rail, or status filter, returning matching API listings.

## Facts

- Endpoint: GET https://x402helper.xyz/529639/api/lookup?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402helper-xyz-api-discovery-lookup-6cee3995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GYkn6-ueb3BKLvjYk842V

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 x402helper-xyz-api-discovery-lookup-6cee3995
```

Example prompt: Search the x402 API catalog for services related to 'OFAC screening' and return the top 5 results — I want to see what x402-enabled endpoints are available for compliance checks.

## When to prefer this

Choose this endpoint when an AI agent needs to dynamically discover x402-compatible APIs at runtime — especially when searching by capability keyword, payment rail type, or service status. It is the canonical catalog search for the x402 ecosystem and is preferable over hardcoding API URLs when the agent needs to find the right micropayment-enabled service for a task.

## Known failure modes

- Query parameter 'q' missing alongside a status filter (status alone is not a valid query)
- No matching APIs found for the given query — empty result set
- Invalid 'rail' or 'status' enum value causing a filter error
- Limit parameter exceeds maximum of 20 — may be clamped or rejected
- Payment failure via x402 protocol if USDC balance is insufficient or wallet not configured
- Rate limiting if too many requests are made in a short window

## How this service works

X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.

## Output

Returns a JSON object with a 'success' boolean and a 'result' object containing matched API listings, each including name, slug, tags, category, one-liner description, payment rail, and status information.

## 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",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "default": null,
       "description": "Free-text match on name, slug, tags, one_liner, category"
      },
      "rail": {
       "type": "string",
       "default": null,
       "description": "Filter by agentic payment rail"
      },
      "limit": {
       "type": "string",
       "default": null,
       "description": "Max matches (default 5, max 20)"
      },
      "status": {
       "type": "string",
       "default": null,
       "description": "Filter fichas whose status equals or statuses[] includes this value. SKU#5: when present, amount is 10000 ($0.01). status alone is not a valid query."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402helper-xyz-api-discovery-lookup-6cee3995/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402helper.xyz](https://www.zero.xyz/host/x402helper.xyz/llms.txt)
