{"uid":"cap_eMCUXEjzFvoQ24KTGFjFm","slug":"ens-bulk-reverse-resolver-f0f153e5","name":"ENS Bulk Reverse Resolver","description":"Reverse-resolve a batch of Ethereum addresses to ENS primary names + avatar URLs (up to 50 per call). Returns one row per address with name (or null), displayName (with checksum if no name), and avatar URI. Use to label transaction lists, wallet leaderboards, or NFT holder snapshots with human-readable names instead of 0xabc… stubs.","url":"https://agent402.tools/api/ens-bulk-resolve","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"addresses":{"type":"array","description":"1-50 Ethereum addresses (0x-prefixed 40-hex)."}}},"responseSchema":{"type":"json","example":{"count":2,"source":"ensideas","results":[{"name":"vitalik.eth","avatar":"https://...","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","displayName":"vitalik.eth"},{"name":null,"avatar":null,"address":"0x000000000000000000000000000000000000dead","displayName":"0x0000…dead"}],"namedPct":50,"namedCount":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RTaWVeQsvAqSMJnqBB133","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reverse-resolves up to 50 Ethereum addresses in a single call to their ENS primary names and avatar URLs","exampleAgentPrompt":"Can you look up the ENS names and avatar URLs for these Ethereum addresses: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B, and 0x1db3439a222c519ab44bb1144fc28167b4fa6ee6?","exampleUseCases":null,"resultDescription":"Returns one row per input address containing: the ENS primary name (or null if none registered), a displayName (ENS name if available, otherwise checksum-formatted address), and the avatar URI from ENS records. Results are ordered to match the input address array.","failureModes":["More than 50 addresses submitted — request rejected","Invalid address format (not 0x-prefixed 40-hex) — may return error or null for that entry","Address has no ENS primary name — returns null for name field but still returns checksum displayName","ENS resolver or upstream node temporarily unavailable — service error","Payment not processed (x402 protocol failure) — request not fulfilled"],"whenToPreferThis":"Use this endpoint when you need to label multiple Ethereum addresses with human-readable ENS names and avatars in a single API call. It is ideal for enriching transaction lists, wallet leaderboards, or any UI that displays multiple wallet addresses at once. Prefer this over single-address resolvers when you have 2–50 addresses to resolve, as it batches all lookups into one call and one payment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:06.459Z","isFirstParty":false}