# GET /x402/find: $0.002 per call

Describe a job in plain English and get the best working x402 services for it, ranked: fit, real buyers (30 days), our uptime and speed checks, and price, with reasons and how to call each. Covers the whole x402 Bazaar catalogue (crypto, search, scraping, LLMs, enrichment...). ?q=scrape a web page to markdown&maxPrice=0.01. Re-checked now: /x402/find/live.

- **Price:** $0.002 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Tier:** cached
- **Answers cached for:** 10 min
- **Data sources:** CDP Bazaar (free), our daily index; our unpaid uptime checks
- **Lane:** x402 market guide ([OpenAPI](/openapi/x402-guide.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/x402-find](/sample/x402-find). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/x402-find"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/x402/find?q=check+if+a+token+is+a+rug+pull&maxPrice=0.02"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/x402/find?q=check+if+a+token+is+a+rug+pull&maxPrice=0.02");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("x402-find", {"q":"check if a token is a rug pull","maxPrice":0.02});
```

## Inputs

- `q` **(required)** (string): The job in plain English, e.g. 'check if a Base token is a rug pull' or 'scrape a web page to markdown'.
- `network` (string): Only services paid on this network, e.g. eip155:8453 (Base) or solana.
- `maxPrice` (number): Your budget: highest price per call in USD.
- `minPayers` (integer; default `0`): Only services with at least this many buyers in 30 days.
- `limit` (integer; default `10`): Most results.
- `includeNovelty` (boolean; default `false`): Also show joke/dice/test endpoints (hidden unless you ask for them).

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "query": "check if a token is a rug pull",
  "understood": {
    "category": "crypto",
    "categoryTitle": "Crypto & on-chain data",
    "searchWords": [
      "check",
      "token",
      "rug",
      "pull",
      "wallet",
      "onchain",
      "crypto"
    ]
  },
  "results": [
    {
      "rank": 1,
      "name": "x402node.dev chain honeypot",
      "resource": "https://api.x402node.dev/chain/honeypot",
      "method": "GET",
      "category": "crypto",
      "categoryTitle": "Crypto & on-chain data",
      "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",
      "priceUsd": 0.01,
      "networks": [
        "eip155:8453"
      ],
      "buyers30d": 23,
      "calls30d": 114,
      "lastCalledAt": "2026-09-28T04:23:51.282Z",
      "uptime7d": 100,
      "checks7d": 12,
      "medianMs": 410,
      "x402Valid": true,
      "inputExample": {
        "method": "GET",
        "queryParams": {
          "address": "string",
          "chain": "string",
          "token": "string"
        }
      },
      "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."
      ],
      "score": 27.4
    }
  ],
  "avoid": [],
  "matched": 42,
  "catalogue": {
    "services": 17786,
    "withBuyers": 17750,
    "lastFullPass": "2026-09-28T06:00:00Z"
  },
  "note": ""
}
```

## Related

- [GET /tools/find](/services/find-best-tool) ($0.002): Find the best tool for a job.
- [GET /x402/find/live](/services/x402-find-live) ($0.01): Like /x402/find, but the shortlist is re-checked right now: we send each top candidate one unpaid request and keep only those answering with a valid x402 price 
- [GET /x402/check](/services/x402-check) ($0.002): Live health check of any x402 endpoint before you pay it: is it up and answering 402, is the payment request valid, prices in USD per network, pay-to wallets, x
- [GET /x402/recommend](/services/x402-recommend) ($0.03): Describe a job and get the best x402 services to do it: we search the whole Bazaar catalogue, then an AI compares the candidates on real buyer numbers, recent u
- [GET /x402/trends](/services/x402-trends) ($0.01): What's growing in the x402 economy: services with the biggest rise in unique buyers over the last N days, from our own daily history of the Bazaar catalogue (hi

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).