# x402 API Finder > x402 API Finder is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-30). Searches and ranks paid x402 micropayment APIs by task description, returning scored endpoints with pricing, demand metrics, and quality flags ## Facts - Endpoint: GET https://1gateway.dev/v1/x402/recommend?utm_source=zero.xyz - Price: $0.009/call - Payment: x402 - Status: unknown - Last checked: 2026-10-30 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402-api-finder-b945596e - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TqAFuwRk2Z8dL5WoGdYzc 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 x402-api-finder-b945596e ``` Example prompt: Find me the best x402 API for Base token honeypot checking — show up to 5 results priced under $0.02 on the Base network. ## When to prefer this Use this endpoint when an AI agent needs to dynamically discover and select a paid x402 micropayment API for a specific task at runtime. It is the right choice when you want demand-validated rankings (real 30-day payer and call counts), quality flags to filter out wash trading or probes, price caps to stay within budget, and network-specific filtering. Prefer this over manual API directories when building autonomous agents that must self-select tools. ## Known failure modes - No results returned if query terms match zero indexed routes above the 30% relevance threshold - max_price filter too restrictive may return empty results - network filter for uncommon chains may match no endpoints - Index may be stale if crawl timestamps are old - Flagged routes still appear by default unless include_flagged=false is set ## How this service works Use when an agent must pick a paid x402 API for a task. Input: q (task in plain words or keywords), optional max_price (USD), network (base, solana or CAIP-2), limit (1-20). Output: JSON ranked endpoints: resource URL, method, description, price, networks, seller, 30-day payers and calls (Bazaar), seller buyers (x402scan), wash/quality flags, score, index as_of. Same rules for every seller. Example: ?q=base+token+honeypot+check&max_price=0.02 ## Output A JSON object with ranked x402 API endpoints matching the query, each including: resource URL, HTTP method, description, price in USD, supported networks, seller host and pay-to address, 30-day payer and call counts from Bazaar, seller buyer counts from x402scan, wash/quality flags (few_payers, inactive_14d, scanner_like, trivial_route, uniform_payers), relevance score, and index metadata (total routes, sellers, crawl timestamps, version). ## 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", "examples": [ "base token honeypot check" ], "maxLength": 300, "description": "What the API should do, in plain words or keywords (e.g. 'korean apartment prices', 'convert pdf to markdown'). Text only: never fetched as a URL" }, "limit": { "type": "integer", "maximum": 20, "minimum": 1, "examples": [ 5 ], "description": "Number of results (default 8)" }, "network": { "type": "string", "pattern": "^[A-Za-z0-9:]{2,60}$", "examples": [ "base" ], "description": "Only endpoints that accept this network: base, solana, polygon, arbitrum, optimism, ethereum, avalanche, worldchain, monad, or a CAIP-2 id (eip155:8453)" }, "max_price": { "type": "number", "maximum": 1000, "minimum": 0, "examples": [ 0.02 ], "description": "Only endpoints priced at or below this many USD per call" }, "include_flagged": { "enum": [ "true", "false" ], "type": "string", "examples": [ "true" ], "description": "false drops routes flagged scanner_like or uniform_payers (suspected probes / wash); default true (flagged routes are kept but ranked lower)" } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "as_of", "query", "matched_total", "results", "index", "ranking", "flag_definitions", "operator_disclosure", "sources" ], "properties": { "as_of": { "type": "string" }, "index": { "type": "object", "properties": { "routes": { "type": "integer" … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "as_of": "2026-10-18", "index": { "routes": 1989, "sellers": 693, "version": "test-20261018", "inclusion": "mainnet USDC-priced routes with >= 3 distinct payers in 30 days (Bazaar quality data)", "bazaar_crawled_at": "2026-10-18T06:29:58.318Z", "x402scan_crawled_at": "2026-10-18T06:32:25.178Z", "bazaar_resources_crawled": 46270, "x402scan_sellers_crawled": 1445 }, "query": { "q": "base token honeypot check", "limit": 3, "terms": [ "base" ], "network": null, "max_price": 0.02, "include_flagged": true }, "ranking": "BM25 text relevance on service name, tags, path and description (only routes reaching 30% of the best match), x query-word coverage, x capped demand (log 30-da…", "results": [ { "rank": 1, "tags": [ "honeypot" ], "flags": [ "few_payers" ], "score": 1.2614, "demand": { "bazaar_last_called": "2026-10-16", "bazaar_route_calls_30d": 4, "x402scan_seller_tx_30d": 1661, "bazaar_route_payers_30d": 4, "x402scan_seller_buyers_30d": 53, "x402scan_seller_volume_usd_30d": 235 }, "method": "GET", "seller": { "host": "onchainpulse.theaslangroupllc.com", "pay_to": "0x50ab2018c06c6e4eaa9ba52057eb55ed284912fc" }, "networks": [ "eip155:137" ], "resource": "https://onchainpulse.theaslangroupllc.com/api/evmtoken", "price_usd": 0.015, "text_match": 1, "description": "Honeypot, rug & token-safety scanner for Robinhood Chain, Base & EVM tokens — instant pre-trade check: sell-simulation honeypot, buy/sell tax, mint, upgradeabl…", "service_name": "OnchainPulse", "matched_terms": [ "base" ] } ], "sources": "CDP Bazaar discovery API (routes, prices, 30-day payers/calls); x402scan.com seller stats (30-day buyers, tx, volume). Heuristic flags; not an endorsement. Ver…", "matched_total": 112, "flag_definitions": { "few_payers": "fewer than 5 distinct payers in 30 days", "inactive_14d": "not called in the 14 days before the crawl", "scanner_like": ">= 10 payers but < 1.3 calls per payer (probes / one-shot scanners)", "trivial_route": "ping/time/uuid-style route", "uniform_payers": ">= 5 routes of one host with the identical payer count (test harness or wash cluster suspected)", "thin_description": "description under 25 characters" }, "operator_disclosure": "The operator of this API (1gateway.dev) also sells x40 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-api-finder-b945596e/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from 1gateway.dev](https://www.zero.xyz/host/1gateway.dev/llms.txt)