{"uid":"cap_Z-iX1znYLTTo1zOVgakCc","slug":"agents-trust-api-recommender-0508d89a","name":"Agents Trust API Recommender","description":"Which x402 API should I call? Agents Trust Recommend ranks candidate paid APIs for a task: agent API recommendations, x402 endpoint discovery, API search and marketplace search. Returns URLs, API pricing, reliability, live challenge checks, paid delivery evidence and risk flags. Tasks: weather forecast, web search, stock prices. Fee: 0.01 USDC on Base or Solana. Evidence tiers are provisional, not an endorsement.","url":"https://api.agents-trust.ai/recommend?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":"Every returned endpoint must answer a payment challenge during this request. live=0 is unsupported."},"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 embedded for semantic retrieval."},"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,"description":"Maximum nominal USD price of the selected provider offer. Separate from the 0.01 USDC recommendation fee. The provider challenge at call time is authoritative."}},"additionalProperties":false}}},"output":{"type":"object","properties":{"type":{"const":"json"},"example":{"type":"object","anyOf":[{"properties":{"meta":{},"picks":{}}},{"properties":{"meta":{},"picks":{}}}],"required":["schema_version","generated_at","need","interpretation","view","picks","meta"],"properties":{"meta":{"type":"object","required":["result_count","match_strength","guidance","documentation_url","retrieval_floor_widening_failed"]},"need":{"type":"string"},"view":{"const":"compact"},"picks":{"type":"array"},"generated_at":{"type":"string"},"interpretation":{"type":"object"},"schema_version":{"const":"recommend.v2"}}}},"description":"Successful compact answer. Error responses and payment headers: https://agents-trust.com/openapi.json#/paths/~1recommend/get/responses"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o2MivSVkhmxkmuiH311Wf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks and recommends candidate x402 paid APIs for a given task, with live challenge checks, pricing, reliability, and risk flags","exampleAgentPrompt":"I need to find the best paid x402 API for getting live weather forecasts — can you recommend up to 3 options ranked by reliability, show me their prices, and make sure they pass a live payment challenge right now?","exampleUseCases":[{"title":"Finding the best API for stock prices","prompt":"I want to build an agent that fetches real-time stock prices — recommend me up to 3 x402 paid APIs for that, filtered to under $0.05 per call, and make sure they actually respond to live payment challenges."},{"title":"Discovering APIs for web search tasks","prompt":"Which paid x402 APIs would you recommend for doing web searches? Give me the top 3 options with pricing and reliability info, using the evidence view so I can see the measurement details."},{"title":"Routing an agent to the right paid API","prompt":"My AI agent needs to call a paid API for cryptocurrency price lookups — can you find and rank the best x402 endpoints for that on the Base network, limited to 2 results, and flag any risk issues?"}],"resultDescription":"A ranked list of up to 5 candidate paid API endpoints (URLs) matching the requested task, each annotated with pricing, reliability scores, live payment challenge results, paid delivery evidence tiers, and risk flags. Response also includes metadata such as schema version, generation timestamp, task interpretation, and the selected view format.","failureModes":["Missing or too-short 'need' parameter returns validation error","live=0 is unsupported and will error","Invalid CAIP-2 chain format returns a pattern mismatch error","Insufficient evidence for a task may return fewer results than requested limit","0.01 USDC payment challenge failure results in no response delivered","max_price_usd filtering may yield zero results if threshold is too low"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to dynamically discover and route to the best available x402 paid API for a given task, rather than hardcoding a specific provider. Especially useful when comparing multiple API candidates by price, reliability, and live availability before committing a payment. Prefer this over manual API registries when you need real-time challenge verification and risk flagging.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:05:47.317Z","isFirstParty":false,"canonicalSlug":"agents-trust-api-recommender-0508d89a"}