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.
Transfers are cached for 10 minutes. First requests typically take 2-5 seconds; cached responses return in under 100ms. The sanctions match is made on every request, so a newly designated wallet is flagged as soon as the hourly OFAC ingestion stores it.

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
integer
How many wallet nodes (the queried address included) are on an OFAC sanctions list
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.

Sanctioned wallets

Every wallet node is screened against the OFAC SDN and Consolidated lists, the same lists behind the sanctions screening endpoint. A listed wallet carries sanctioned: true and its list entries, so a graph visualisation can highlight it and a compliance check can tell at a glance whether the queried address has transacted with a designated party. For a one-hop risk summary across chains without the graph, use sanctions exposure.

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.
Highlight wallets on an OFAC list in the network and see exactly which tokens connect them to the queried address.

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