Skip to main content
GET

Overview

Generates a transaction graph for any Ethereum address, showing ERC-20 token transfer relationships as nodes and edges. The graph is a tripartite structure: wallets connect to tokens, which connect to other wallets.
Results are cached for 10 minutes. First requests typically take 2-5 seconds; cached responses return in under 100ms.

Authentication

This endpoint supports two authentication methods:
x402 payments allow instant, accountless access. Pay per request with USDC on Base - no signup required. Try it live →

Path Parameters

string
required
Ethereum address or ENS name (e.g., vitalik.eth or 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045)

Query Parameters

integer
default:"1"
Chain ID of the blockchain network to analyze. Defaults to Ethereum Mainnet.

Supported Networks

Response

string
The resolved Ethereum address (checksummed)
integer
The chain ID that was queried
string
Human-readable name of the blockchain network
integer
Total number of ERC-20 token transfers found for this address on the specified chain
array
Array of graph nodes representing wallets and tokens.
array
Array of graph edges representing token transfer relationships.

Graph Structure

The graph uses a tripartite structure to represent token transfers:
  • Wallet nodes represent Ethereum addresses involved in transfers
  • Token nodes represent ERC-20 tokens that were transferred
  • Edges connect wallets to tokens with a direction (SENT or RECEIVED)
This structure makes it easy to identify which tokens flow between which counterparties.

Use Cases

Identify the major counterparties for a wallet — who they transact with most and through which tokens.
Spot circular transfer patterns where tokens flow between a small set of wallets, indicating potential wash trading.
Trace how funds move through a network of addresses to understand capital flows and identify intermediary wallets.
Build interactive graph visualizations to explore transaction relationships in dApps, dashboards, or compliance tools.

Performance

  • Response Time: 2-5 seconds (uncached), under 100ms (cached)
  • Caching: Results cached for 10 minutes per address/chain combination
  • Data Source: Etherscan API V2 (ERC-20 token transfers only)
  • Scope: All historical token transfers for the address on the specified chain