{"uid":"cap_vH4M-HvgXPJq_bTg4V-XP","slug":"obol-bitcoin-address-cluster-lookup-74ef2760","name":"Obol Bitcoin Address Cluster Lookup","description":"Obol sells verified blockchain data over x402, settled in USDC on Base.","url":"https://obol.danieldutoit.net/v1/bitcoin/address-cluster","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"address":"1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp","cluster":null,"network":"bitcoin","coverage":{"match_type":"exact_address","maximum_results":1},"clustered":false,"disclaimer":"Heuristic public-chain clustering; a cluster is not proof of common ownership or identity."}},"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_milXFFtK5y331kN9TeYpQ","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 the cluster of Bitcoin addresses associated with a given address, grouping addresses likely controlled by the same entity using heuristic blockchain analysis.","exampleAgentPrompt":"Look up the address cluster for Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divfna — I want to know which other addresses are likely controlled by the same entity.","exampleUseCases":[{"title":"Exchange compliance entity resolution","prompt":"I need to check whether Bitcoin address 3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy belongs to the same entity as another address we flagged — can you pull the cluster data for it?"},{"title":"Blockchain investigator tracing funds","prompt":"Trace the address cluster for bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq — I'm investigating where funds moved after a suspicious transaction and need to see all linked addresses."},{"title":"Crypto portfolio de-duplication","prompt":"Can you look up the address cluster for 1FeexV6bAHb8ybZjqQMjJrcCrHGW9sb6uF? I want to see if multiple addresses in my dataset are actually controlled by the same wallet owner."}],"resultDescription":"Returns a cluster object containing the group of Bitcoin addresses likely controlled by the same entity as the queried address, based on on-chain heuristics such as common-input-ownership and change-address analysis.","failureModes":["Invalid or malformed Bitcoin address returns a 400 error","Address not found in the blockchain dataset may return an empty cluster or 404","Payment failure via x402 (insufficient USDC balance) results in a 402 Payment Required response","Network or service downtime returns a 5xx error","Singleton addresses with no detectable cluster relationships return a minimal single-address result"],"whenToPreferThis":"Choose this endpoint when you need verified, paid-quality blockchain address clustering for Bitcoin specifically, billed per-call in USDC via x402. Prefer it over free heuristic tools when data integrity and verifiability matter, such as compliance workflows, fraud investigations, or entity de-duplication tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:07.826Z","isFirstParty":false}