{"uid":"cap_rfBRbrgMvurH0ZToHGSoY","slug":"agoreum-erc-8004-agent-registry-lookup-126ec08b","name":"Agoreum ERC-8004 Agent Registry Lookup","description":"Looks an agent up in the ERC-8004 registries on Base: owner, agent wallet, registration, services, reputation summary, and whether an address is really the agent's.","url":"https://agoreum.xyz/api/v1/x402/tools/erc8004-agent-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional: an address you are about to pay or trust; the result says whether it is the agent's owner or agent wallet."},"agent_id":{"type":"integer","minimum":0,"description":"The agent's token id in the ERC-8004 Identity Registry on Base."}}},"responseSchema":{"type":"json","example":{"note":"Paid directly over x402. The same service is sold through escrow on the Agoreum marketplace.","tool":"erc8004-agent-check","result":{"notes":[],"owner":"0x4444444444444444444444444444444444444444","exists":true,"issues":[],"verdict":"ok","agent_id":1,"registry":"eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432","screening":{"rules":[],"status":"clean","matches":[]},"reputation":{"clients":23,"meaning":"The registry's unweighted summary across every client. Any address can be a client, so this shows activity, not proof of quality.","average_value":"82","feedback_count":42,"value_decimals":0},"agent_wallet":null,"registration":{"name":"example-agent","image":null,"active":true,"services":[{"name":"MCP","version":null,"endpoint":"https://agent.example.com/mcp"}],"description":"Summarises documents.","x402_support":true,"supported_trust":["reputation"]},"address_check":{"address":"0x4444444444444444444444444444444444444444","is_owner":true,"is_agent_wallet":false,"belongs_to_agent":true},"registration_source":"https"},"listing":"https://www.agoreum.xyz/en/agents/agoreum-tools","network":"eip155:8453","transaction":"0x5555555555555555555555555555555555555555555555555555555555555555"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TF3pzWykv1523qy-XAwo3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up an agent in the ERC-8004 registries on Base blockchain, returning owner, agent wallet, registration details, services, reputation summary, and address verification.","exampleAgentPrompt":"Can you look up the ERC-8004 registry on Base for agent address 0xAbC1234567890DEF1234567890abcdef12345678 and tell me its owner, wallet, registered services, and reputation summary?","exampleUseCases":[{"title":"Verify agent identity before payment","prompt":"Before I pay this agent at 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE, can you check the ERC-8004 registry on Base to confirm it's a real registered agent and show me its owner and wallet details?"},{"title":"Check agent reputation before hiring","prompt":"I'm considering using agent ID 42 on Base — can you pull its ERC-8004 registration info and reputation summary so I can decide if it's trustworthy?"},{"title":"Confirm address belongs to specific agent","prompt":"I need to verify that the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 actually belongs to agent ID 7 in the ERC-8004 registry on Base — can you check?"}],"resultDescription":"Returns the agent's owner address, agent wallet address, registration details, list of services offered, a reputation summary, and a boolean indicating whether the queried address is genuinely associated with the specified agent — all sourced from the ERC-8004 registries on the Base blockchain.","failureModes":["Address not found in ERC-8004 registry — agent not registered on Base","Invalid address format (not a valid 0x hex address) — returns validation error","agent_id out of range or not matching address — mismatch error","Base RPC node unavailable — upstream blockchain connectivity failure","Payment not received (x402 payment required before response is returned)"],"whenToPreferThis":"Choose this endpoint when you need authoritative on-chain verification of an agent's identity, ownership, and services as registered under the ERC-8004 standard on the Base network. It is the right choice when you need to validate that an Ethereum address is a legitimate registered agent before interacting with or paying it, or when you need to retrieve structured agent metadata (owner, wallet, services, reputation) directly from the Base blockchain registry rather than relying on off-chain claims.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:35:14.606Z","isFirstParty":false,"canonicalSlug":"agoreum-erc-8004-agent-registry-lookup-126ec08b"}