# Swift Bot Labs Toolbox – x402 API Search

> Swift Bot Labs Toolbox – x402 API Search is a paid API for AI agents from x402-toolbox.swiftbotlab.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Searches the x402 pay-per-call API registry by keyword, returning matching endpoints with their prices, networks, and descriptions.

## Facts

- Endpoint: GET https://x402-toolbox.swiftbotlab.workers.dev/v1/x402/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swift-bot-labs-toolbox-x402-api-search-f9fabc4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fY1UMM4FgOb7QC8bP7Ynp

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 swift-bot-labs-toolbox-x402-api-search-f9fabc4a
```

Example prompt: Search the x402 toolbox registry for endpoints related to 'email validation', limit the results to 5, and only show ones priced under $0.05.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover which x402 pay-per-call utility APIs are available for a given task, especially to find cheap ($0.01) deterministic tools for DNS, email, hashing, IP math, EVM decoding, or web extraction without requiring API key management. Prefer this over static documentation when the agent needs to programmatically route to the best available tool at runtime.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- No results found for obscure queries returns count:0 with empty results array
- Invalid network identifier format may return an error or no filtered results
- Payment failure or insufficient USDC balance prevents the call from completing
- Rate limiting or worker overload may return a 5xx error

## How this service works

62 small, deterministic utility APIs (DNS and e-mail checks, web extraction, EVM decoding, x402 checks, IP math, JSON/CSV, hashing, conversions). No account or API key: pay per call in USDC with x402.

## Output

Returns a JSON object with an ok flag, the tool name ('x402-search'), and a result object containing the match count and an array of matching endpoints — each with URL, network, sources, price in USD, and a short description.

## 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",
      "HEAD"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "string"
      },
      "query": {
       "type": "string"
      },
      "network": {
       "type": "string",
       "description": "e.g. eip155:8453 or base"
      },
      "maxPriceUsd": {
       "type": "string"
      }
     },
     "additionalProperties": false
    },
    "discoverable": {
     "type": "boolean"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "x402-search",
  "result": {
   "count": 2,
   "query": "weather forecast",
   "results": [
    {
     "url": "https://api.example.com/weather",
     "network": "eip155:8453",
     "sources": [
      "cdp"
     ],
     "priceUsd": 0.01,
     "description": "Weather forecast by city"
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/swift-bot-labs-toolbox-x402-api-search-f9fabc4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-toolbox.swiftbotlab.workers.dev](https://www.zero.xyz/host/x402-toolbox.swiftbotlab.workers.dev/llms.txt)
