# Agents Trust API Recommender > Agents Trust API Recommender is a paid API for AI agents from api.agents-trust.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14). Searches and recommends candidate paid x402 APIs matching a plain-language task description, returning ranked URLs, prices, payment terms, delivery evidence, and risk flags. ## Facts - Endpoint: GET https://api.agents-trust.com/recommend?utm_source=zero.xyz - Price: $0.01/call - Payment: x402 - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/agents-trust-api-recommender-65739997 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BNoxTt4FcJI_mtVoZe3Yb 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 agents-trust-api-recommender-65739997 ``` Example prompt: Search Agents Trust for up to 3 paid APIs that can do weather forecasting, priced under $0.05 each, and show me the compact view with delivery evidence and any risk flags. ## When to prefer this Use this endpoint when an AI agent needs to dynamically discover and evaluate which paid x402 APIs can fulfill a specific subtask before committing payment. Especially valuable when the target API is unknown, when price budgets must be enforced, or when delivery verification evidence is required before trusting a vendor. Prefer over static API directories when freshness, payment proof, and risk assessment matter. ## Known failure modes - No matching APIs found for the given need description — returns empty picks array - need query too vague or too short — validation error - max_price_usd filter too restrictive — results may be empty - chain filter returns no results if no APIs exist on that network - Retrieval floor widening triggered if initial search returns no results; flag set if widening also fails - Response may be unpaid/truncated if x402 fee not settled ## How this service works Which API should my agent use? Describe a task in plain words and let Recommend find the right x402 API: up to five paid APIs that can do it, with URLs, prices, payment networks and how to call each. Agent API recommendations include paid delivery evidence and risk flags to help you choose. Required: need=. Discovery quote only; signed requests without need are rejected. ## Output A JSON object containing a ranked list of candidate API picks, each with: the callable URL, pricing and payment offer details (asset, amount, network, pay_to address), delivery verification evidence level, risk flags (e.g. SELLER_DESCRIPTION_UNVERIFIED), match strength, reason codes, and invocation status. Also includes metadata like result count, match strength summary, and a documentation URL. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method", "queryParams" ], "properties": { "type": { "const": "http" }, "method": { "const": "GET" }, "queryParams": { "type": "object", "required": [ "need" ], "properties": { "live": { "enum": [ 1 ], "type": "integer", "default": 1, "description": "Only live=1 is supported. Returned picks do not always have a current payment challenge. Free demo needs (weather, crypto prices, web search) can skip this check, as can paid answers. Unconstrained picks may use a positive stored liveness probe within 72 hours or remain unknown after a bounded fallback. Explicit chain or price filters require a validated challenge. A pick without a validated challenge has payment_preflight.status=not_checked, has_valid_recent_challenge=false and selected_offer=null. Read liveness_source, liveness_checked_at and payment_preflight.checked_at; none verifies paid delivery." }, "need": { "type": "string", "maxLength": 300, "minLength": 2, "description": "A phrase describing the required work, with at least two letters or digits. The limit counts Unicode characters in the original input, including whitespace. Accepted text is normalized without truncation and matched against indexed endpoint descriptions." }, "view": { "enum": [ "legacy", "compact", "evidence", "debug" ], "type": "string", "default": "legacy", "description": "Legacy preserves successful-response fields and types. The other views use recommend.v2. Compact includes routing facts, evidence adds measurements, and debug adds bounded retrieval diagnostics." }, "chain": { "type": "string", "pattern": "^[a-z0-9-]{2,16}:[A-Za-z0-9_=-]{1,64}$", "description": "Provider payment network in CAIP-2 form, such as eip155:8453. This does not identify the blockchain analyzed by the service." }, "limit": { "type": "integer", "default": 3, "maximum": 5, "minimum": 1, "description": "Maximum number of picks. Fewer results are returned when evidence is insufficient." }, "max_price_usd": { "type": "number", "minimum": 0 … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "meta": { "guidance": "Illustrative candidate using paid delivery evidence observed on 2026-10-11. Recheck task fit, risk flags and current payment terms before paying.", "result_count": 1, "match_strength": "strong", "documentation_url": "https://agents-trust.com/docs/#recommend-contract", "retrieval_floor_widened": false, "retrieval_floor_widening_failed": false }, "need": "weather forecast", "view": "compact", "picks": [ { "url": "https://api.ideafactorylab.org/x402/weather", "ranking": { "order": [ "callable_url", "documented_invocation", "relevance", "provider_tier", "catalog_min_price", "endpoint_id" ], "relevance": null, "model_version": null, "provider_tier": null, "endpoint_score": null, "evidence_score": null, "lexical_weight": 0, "policy_version": "relevance-first.v1", "provider_score": null, "quality_weight": 0 }, "invocation": { "status": "unknown" }, "risk_flags": [ "SELLER_DESCRIPTION_UNVERIFIED", "REQUIRED_INPUT_UNKNOWN" ], "description": "Current weather for any city. Pass ?city=London", "endpoint_id": "f70842d48203c996e2b4a964cd584615b2c31517", "reason_codes": [ "SEMANTIC_CANDIDATE", "RECENT_VALID_402", "DELIVERY_VERIFIED" ], "service_name": "Idea Factory Lab Weather", "match_strength": "strong", "selected_offer": { "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "1000", "pay_to": "0x8A694A869BaDEC00A333E9213E2914DcD90d53Ff", "scheme": "exact", "network": "eip155:8453", "price_usd": 0.001, "checked_at": "2026-10-13T08:16:00Z", "price_basis": "usdc_nominal", "resource_url": "https://api.ideafactorylab.org/x402/weather", "max_timeout_seconds": 300 }, "payment_preflight": { "method": "GET", "status": "valid_402", "checked_at": "2026-10-13T08:13:00Z", "http_status": 402 }, "delivery_verification": { "status": "verified", "evidence_level": "E5", "funding_source": null, "recipe_summary": null, "content_verdict": "exact", "delivery_result": "delivered", "protocol_result": "pass", "last_verified_at": "2026-10-11T11:15:56.110913Z", "settlement_result": "settled" }, "has_valid_recent_challenge": true } ], "generated_at": "2026-10-13T08:30:00Z", "inte … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-trust-api-recommender-65739997/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.agents-trust.com](https://www.zero.xyz/host/api.agents-trust.com/llms.txt)