Skip to main content
GET
/
api
/
v2
/
graph
/
address
/
{address}
curl -X GET "https://api.credprotocol.com/api/v2/graph/address/vitalik.eth?chain_id=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain_id": 1,
  "chain_name": "Ethereum Mainnet",
  "total_transactions": 150,
  "nodes": [
    { "id": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "label": "0xd8dA...6045", "group": "wallet" },
    { "id": "USDC", "label": "USDC", "group": "token" },
    { "id": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F", "label": "0x71C7...976F", "group": "wallet" }
  ],
  "edges": [
    { "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "to": "USDC", "label": "SENT" },
    { "from": "USDC", "to": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F", "label": "RECEIVED" }
  ]
}

​
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:
MethodHeaderCost
API TokenAuthorization: Bearer YOUR_API_KEY5 Cred Units
x402 PaymentX-PAYMENT: <signed_payment>$0.05 USDC
x402 payments allow instant, accountless access. Pay per request with USDC on Base - no signup required. Try it live →

​
Path Parameters

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

​
Query Parameters

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

​
Supported Networks

ChainChain ID
Ethereum Mainnet1
Optimism10
Binance Smart Chain56
Polygon137
Base8453
Arbitrum42161
Avalanche43114
Scroll534352
Linea59144

​
Response

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

​
Graph Structure

The graph uses a tripartite structure to represent token transfers: 
Wallet A  --SENT-->  TOKEN  --RECEIVED-->  Wallet B
  • 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. 
curl -X GET "https://api.credprotocol.com/api/v2/graph/address/vitalik.eth?chain_id=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain_id": 1,
  "chain_name": "Ethereum Mainnet",
  "total_transactions": 150,
  "nodes": [
    { "id": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "label": "0xd8dA...6045", "group": "wallet" },
    { "id": "USDC", "label": "USDC", "group": "token" },
    { "id": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F", "label": "0x71C7...976F", "group": "wallet" }
  ],
  "edges": [
    { "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "to": "USDC", "label": "SENT" },
    { "from": "USDC", "to": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F", "label": "RECEIVED" }
  ]
}

​
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