# Aayat AI x402 Service Discovery

> Aayat AI x402 Service Discovery is a paid API for AI agents from aayatai.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Accepts a plain-English job description and returns ranked, live-checked x402 micropayment services from a 17,000+ listing catalogue that best match the task

## Facts

- Endpoint: GET https://aayatai.com/x402/find?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-x402-service-discovery-d52f48c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KKjyutOBZVAVT7r2M66rF

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 aayat-ai-x402-service-discovery-d52f48c8
```

Example prompt: Find me the best x402 service for scraping a web page to markdown — budget $0.01 per call max, show the top 5 results with uptime and buyer counts.

## When to prefer this

Choose this endpoint when an AI agent needs to dynamically discover which x402-compatible micropayment API to call for a given task, rather than hardcoding a specific service. Ideal for agentic pipelines that need to route jobs to the best available paid API at runtime, want to compare cost and reliability across providers, or need to stay current as the x402 ecosystem evolves. Covers 17,000+ listings across crypto, scraping, search, LLMs, and enrichment categories.

## Known failure modes

- Query too vague — returns low-relevance or no results
- No services match the maxPrice filter — returns empty results array
- minPayers too high — filters out most services
- Network filter too restrictive — no services on that chain
- Catalogue temporarily stale if lastFullPass is old
- q parameter missing or too short (min 2 chars) — validation error

## How this service works

Describe a job in plain English, such as 'scrape a web page to markdown', and get the best working x402 services for it, ranked on fit, real buyers (30 days), our uptime and speed checks, and price, with reasons and how to call each. You can set a budget per call. Covers the whole x402 Bazaar catalogue: crypto, search, scraping, LLMs, enrichment and more. For a shortlist re-checked right now, use /x402/find/live.

## Output

A JSON object with a ranked array of matching x402 services, each including: service name, resource URL, price in USD, uptime percentage over 7 days, median response time in ms, number of buyers in the last 30 days, the network(s) it accepts payment on, plain-English reasons why it fits the query, and an input example showing how to call it. Also includes catalogue stats (total services, services with buyers, last full check timestamp) and metadata about how the query was interpreted.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 300,
       "minLength": 2,
       "description": "The job in plain English, e.g. 'check if a Base token is a rug pull' or 'scrape a web page to markdown'."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "minimum": 1,
       "description": "Most results."
      },
      "network": {
       "type": "string",
       "maxLength": 60,
       "description": "Only services paid on this network, e.g. eip155:8453 (Base) or solana."
      },
      "maxPrice": {
       "type": "number",
       "maximum": 100,
       "minimum": 0,
       "description": "Your budget: highest price per call in USD."
      },
      "minPayers": {
       "type": "integer",
       "default": 0,
       "maximum": 100000,
       "minimum": 0,
       "description": "Only services with at least this many buyers in 30 days."
      },
      "includeNovelty": {
       "type": "boolean",
       "default": false,
       "description": "Also show joke/dice/test endpoints (hidden unless you ask for them)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "",
  "avoid": [],
  "query": "check if a token is a rug pull",
  "matched": 42,
  "results": [
   {
    "why": [
     "Matches your words: rug, honeypot, risk.",
     "It is a crypto & on-chain data service, the kind of job you described.",
     "23 different buyers paid for it in the last 30 days.",
     "Answered 100% of our 12 unpaid checks this week, typically in 410 ms.",
     "Costs $0.01 per call."
    ],
    "name": "x402node.dev chain honeypot",
    "rank": 1,
    "score": 27.4,
    "method": "GET",
    "calls30d": 114,
    "category": "crypto",
    "checks7d": 12,
    "medianMs": 410,
    "networks": [
     "eip155:8453"
    ],
    "priceUsd": 0.01,
    "resource": "https://api.x402node.dev/chain/honeypot",
    "uptime7d": 100,
    "buyers30d": 23,
    "x402Valid": true,
    "description": "Heuristic honeypot and risk check for an ERC20 token via on-chain eth_call - detects active owner control and transfer restrictions that can trap buyers",
    "inputExample": {
     "method": "GET",
     "queryParams": {
      "chain": "string",
      "token": "string",
      "address": "string"
     }
    },
    "lastCalledAt": "2026-09-28T04:23:51.282Z",
    "categoryTitle": "Crypto & on-chain data"
   }
  ],
  "catalogue": {
   "services": 17786,
   "withBuyers": 17750,
   "lastFullPass": "2026-09-28T06:00:00Z"
  },
  "understood": {
   "category": "crypto",
   "searchWords": [
    "check",
    "token",
    "rug",
    "pull",
    "wallet",
    "onchain",
    "crypto"
   ],
   "categoryTitle": "Crypto & on-chain data"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-x402-service-discovery-d52f48c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)
