{"uid":"cap_AQvusmT0XRnsdaQP9i1nd","slug":"trustagent-erc-8004-filtered-agent-registry-17ac7f01","name":"TrustAgent ERC-8004 Filtered Agent Registry","description":"The filtered ERC-8004 directory: which registered agents are actually alive, and which accept x402. Around a third of registrations on Base carry both a compliant registration file and a declared service, and roughly one in twelve of those declares x402 — this returns them, rather than making you screen eighty thousand addresses one at a time to find them. GET /v1/registry publishes the current split, free. 100 agents per page. Free alternative: GET /v1/registry. Or 3 free calls of this endpoint per wallet per 24h: https://trust-agent.io/v1/trial.","url":"https://trust-agent.io/v1/registry/agents","method":"GET","headers":{},"bodySchema":{"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","properties":{"chain":{"type":"string","description":"OPTIONAL. Only \"base\" is served. Defaults to base."},"cursor":{"type":"string","description":"OPTIONAL. nextCursor from the previous page. Omit for the first page."},"quality":{"type":"string","description":"OPTIONAL. valid_with_service | valid_no_service | non_compliant | uri_unresolvable | no_uri."},"acceptsX402":{"type":"string","description":"OPTIONAL. true to return only agents whose registration file declares x402."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"description":"agents on this page"},"agents":{"description":"array of {agentId, identifier, quality, acceptsX402, payoutWallet, checkedAt, owner, registeredAt}"},"degraded":{"description":"true when the census cannot currently refresh classifications — the page may omit live agents and include stale ones"},"nextCursor":{"description":"pass back as `cursor` for the next page; null when the registry is exhausted"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010001","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.010001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lJlda4A9x4bvclsMHvAF5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.010001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated list of ERC-8004-registered Base agents that are actually live and optionally accept x402 payments, filtering out dead or non-compliant registrations.","exampleAgentPrompt":"Give me the first page of live ERC-8004 agents on Base that accept x402 payments — I only want the ones with a valid registration file and a declared service.","exampleUseCases":[{"title":"Discover x402-ready agents for payment routing","prompt":"I need a list of Base agents that are actually alive and accept x402 payments so I can route micropayments to them — show me the first page of valid ones."},{"title":"Build curated agent marketplace catalog","prompt":"Pull me a page of ERC-8004-compliant agents on Base that have both a valid registration and a declared service — I'm building a directory and don't want dead registrations."},{"title":"Screen next page of agent registry","prompt":"I already fetched the first page of live Base agents; now get me the next page using cursor abc123xyz so I can keep going through the registry."}],"resultDescription":"A JSON object containing: an array of up to 100 agent records (each with agentId, identifier, quality status, acceptsX402 boolean, checkedAt timestamp, owner address, and registeredAt timestamp), a count of agents on this page, and a nextCursor string (null when the registry is exhausted) to fetch subsequent pages.","failureModes":["Invalid cursor value returns error or empty result","Unsupported chain value (non-Base) may return empty or error","No agents match the requested quality/acceptsX402 filter combination — returns empty agents array with null nextCursor","Payment failure (x402 $0.01 USDC not provided) results in 402 response before data is returned","Rate limiting if called too rapidly in succession"],"whenToPreferThis":"Use this endpoint when you need to discover live, compliant ERC-8004 agents on Base without manually screening tens of thousands of raw registry addresses. It's the right choice when you want to find agents that accept x402 payments, need paginated access to a pre-filtered working agent list, or are building an agent marketplace or routing layer. Prefer it over raw on-chain enumeration when you need quality signals (valid_with_service, valid_no_service, etc.) already computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:35:07.776Z","isFirstParty":false}