Address Relationship Mapper

WHAT IT DOES

Address Relationship Mapper is a read-only analytics tool that visualizes the network of on-chain relationships between wallet addresses. It scans transaction histories, transfer events, token transfers, contract interactions, and counterparty addresses to build a comprehensive relationship graph. The tool tracks transaction timestamps, transaction values, gas usage patterns, interaction frequency, common counterparties, transaction volumes between addresses, and first and last interaction timestamps. Results are presented as an interactive graph showing the central address and its connected counterparties, with edge weights representing interaction frequency, along with detailed tables of top counterparties and interaction frequency bars.

HOW TO USE

Enter any wallet address and click Map Relationships. The tool scans incoming and outgoing Transfer events to identify all counterparties that have interacted with the address, then builds a relationship graph. Results include total counterparties, total transactions sampled, a visual graph showing the central address connected to its top counterparties, a detailed table of top counterparties with interaction counts and first/last block timestamps, and interaction frequency bar charts. Each counterparty address links to a block explorer for further investigation.

ADAPTIVE LOG-CHUNKING WITH BACKOFF

Public RPC providers enforce wildly different eth_getLogs block range limits — some allow 10,000 blocks, others cap at 1,000, and many reject requests that exceed their internal buffer. Instead of guessing a safe range and failing on the first rejection, this mapper walks backwards from the latest block in dynamically sized chunks. When a request is rejected, the chunk size is halved and retried immediately. This guarantees that the scan completes on any provider without overwhelming the endpoint, and without giving up after a single refusal. The tool separately scans incoming and outgoing Transfer events to build a complete picture of the address's relationship network, then aggregates this data into weighted graph connections.

WHAT IT CANNOT SEE

This tool cannot detect off-chain relationships or social connections. It cannot identify address ownership or wallet clusters across multiple addresses. It cannot access centralized exchange internal transfer data. It cannot detect private or unmined transactions. It cannot map relationships from networks without full historical data. It cannot distinguish between bots and human-controlled addresses. It cannot detect intent behind interactions. The graph represents only on-chain Transfer events and may not capture all forms of interaction, such as contract calls that do not emit Transfer events.

PLEASE NOTE

EVM ONLY. Supports all Ethereum-compatible networks (Ethereum, Goerli, Sepolia, Optimism, Arbitrum, Polygon, and others). No Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. Relationship mapping is based on sampled transaction data and may not represent the complete interaction history for addresses with extremely high transaction volumes. Always cross-check findings with block explorers for verification.