Get top counterparties of a blockchain wallet with interaction volume, frequency, and flow data via Nansen.
What it does
This endpoint returns the top counterparties that a given wallet address (or named entity) has interacted with on-chain. It supports grouping by individual wallet or by entity, and filtering by source type (Combined, Tokens, ETH). The response includes interaction statistics such as total volume in USD, inflow/outflow breakdowns, interaction count, timing data, and token-level detail for each counterparty relationship.
The endpoint is part of Nansen's Profiler suite and covers 26+ chains including Ethereum, Solana, Base, Arbitrum, BNB, Polygon, and more. Filters are available for smart money labels (Fund, Smart Trader, Exchange, Public Figure, Whale, etc.), volume ranges, and interaction counts. Results are paginated (up to 1000 per page) and sortable by total volume, interaction count, last interaction date, or directional volume.
Pricing is $0.05 per call via the x402 protocol, or 50 credits (free tier) / 5 credits (pro tier) when using a Nansen API key. The API uses OpenAPI 3.1 with full schema definitions. Rate limits are enforced per-second and per-minute, reported via response headers.
Capabilities
Use cases
- —Identify the most frequent transaction partners of a wallet by count and volume
- —Analyze net value flows between a wallet and exchanges or DeFi protocols
- —Detect funding sources and high-value transfer relationships for compliance or research
- —Map DeFi protocol usage and DEX trading counterparties for a specific address
- —Filter counterparties by smart money labels to find interactions with funds or public figures
Fit
Best for
- —Blockchain investigators tracing wallet relationships across chains
- —DeFi researchers analyzing protocol interaction patterns
- —Compliance teams mapping fund flows for specific addresses
- —Trading desks profiling counterparty activity of smart money wallets
Not for
- —Real-time sub-second trade execution signals
- —Non-blockchain data or off-chain identity resolution
- —Free unlimited bulk queries — each call costs $0.05 or credits
Quick start
curl -X POST https://api.nansen.ai/api/v1/profiler/address/counterparties \
-H 'Content-Type: application/json' \
-d '{
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"chain": "ethereum",
"date": {"from": "2025-05-01T00:00:00Z", "to": "2025-05-03T23:59:59Z"},
"source_input": "Combined",
"group_by": "wallet",
"pagination": {"page": 1, "per_page": 10}
}'Example
Request
{
"date": {
"to": "2025-05-03T23:59:59Z",
"from": "2025-05-01T00:00:00Z"
},
"chain": "ethereum",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"group_by": "wallet",
"pagination": {
"page": 1,
"per_page": 10
},
"source_input": "Combined"
}Response
{
"data": [
{
"tokens_info": [
{
"token_name": "USD Coin",
"num_transfer": "15",
"token_symbol": "USDC",
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
],
"volume_in_usd": 600000.25,
"volume_out_usd": 650000.25,
"total_volume_usd": 1250000.5,
"interaction_count": 42,
"counterparty_address": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
"counterparty_address_label": [
"Uniswap V2: Router 2"
]
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.05 via x402), and the endpoint returned 402 confirming it is live. Example response is inferred from schema since no live data sample was captured, but the schema is comprehensive. Crawled docs pages returned 404s so no supplementary documentation was available.
Warnings
- —No supplementary documentation pages were reachable (docs, pricing pages returned 404)
- —Example response is constructed from schema definitions, not captured from a live call
- —High-volume addresses are limited to 180-day date ranges per the API description
Citations
- —Endpoint costs $0.05 per call via x402 protocol, or 50 credits (free) / 5 credits (pro)https://api.nansen.ai
- —Supports grouping by wallet or entity, source filtering (Combined, Tokens, ETH), and smart money label filtershttps://api.nansen.ai
- —Supports 26+ chains including ethereum, solana, base, arbitrum, bnb, polygon, and morehttps://api.nansen.ai
- —Endpoint returned HTTP 402 confirming it is live via MPP protocolhttps://api.nansen.ai/api/v1/profiler/address/counterparties