{"uid":"cap_uQKc8Fot003Krf-eFNE88","slug":"obol-ethereum-address-cluster-lookup-a86f106c","name":"Obol Ethereum Address Cluster Lookup","description":"Obol sells verified blockchain data over x402, settled in USDC on Base.","url":"https://obol.danieldutoit.net/v1/ethereum/address-cluster?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"address":"0x00000000000062c6e2195ae26dff3b084c5c3938","network":"ethereum","coverage":{"match_type":"exact_address","maximum_results":10},"clustered":true,"disclaimer":"Heuristic clustering is not proof of ownership or identity.","assignments":[{"run_id":"v1_h1","cluster_id":"1"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zSev1AKnqd-UrRhOWUcDo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns heuristic cluster assignments for a given Ethereum address, grouping it with related addresses based on on-chain behavioral analysis.","exampleAgentPrompt":"Can you look up the address cluster for Ethereum wallet 0x00000000000062c6e2195ae26dff3b084c5c3938 and tell me which other addresses it's likely grouped with?","exampleUseCases":[{"title":"Wallet attribution for fraud investigation","prompt":"I need to know which Ethereum addresses are likely controlled by the same entity as 0xAbCd1234... — can you run a cluster lookup and show me the cluster ID and any associated addresses?"},{"title":"DeFi risk screening","prompt":"Before we whitelist this Ethereum address 0x1234abcd... for our DeFi protocol, can you check if it clusters with any known addresses so we can flag it for review?"},{"title":"Blockchain analytics enrichment","prompt":"I'm building a report on wallet 0xDeadBeef... — pull the Obol address cluster data so I can see if it's associated with a broader group of wallets on Ethereum."}],"resultDescription":"A JSON object containing the queried Ethereum address, network, coverage details (match type, max results), a boolean indicating whether clustering was found, a disclaimer about heuristic nature, and an array of cluster assignments each with a run_id and cluster_id.","failureModes":["Address not found in cluster database — returns empty assignments array","Invalid Ethereum address format — likely returns a 400 error","Payment failure or insufficient USDC balance — x402 payment rejection before data is returned","Address exists but has no cluster associations — clustered field returns false with empty assignments","Rate limiting or service unavailability — 429 or 5xx response"],"whenToPreferThis":"Choose this endpoint when you need heuristic on-chain address clustering for Ethereum specifically, paid per-call in USDC via x402, with verifiable blockchain settlement. It is ideal for compliance, fraud investigation, or analytics pipelines that require grouped wallet intelligence without standing up proprietary clustering infrastructure. Prefer it over general blockchain explorers when you need structured cluster assignment data rather than raw transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T00:44:58.010Z","isFirstParty":false,"canonicalSlug":"obol-ethereum-address-cluster-lookup-a86f106c"}