Hunt Townh402
Catalog
CryptoPOSTlive

Wallet counterparties

Get the addresses or entities a wallet has transacted with, with interaction counts and volume.

$0.05
per call
Success
100%
p50 latency
1.90s
p95 latency
2.16s
Calls (30d)
3

Provider contract

Call path
/routes/nansen/crypto/wallet-counterparties
Method
POST
Selected provider
nansendefault
Provider price
$0.05
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/wallet-counterparties' \
  -H 'content-type: application/json' \
  -d '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'
CLI
h402 call 'crypto/wallet-counterparties' --provider 'nansen' --method POST --json '{"address":"0x28c6c06298d514db089934071355e5743bf21d60","chain":"ethereum","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

addressstringoptional *

Wallet address to get counterparties for. Provide either walletAddress or entityName.

e.g.
entity_namestringoptional *

Nansen entity name to get counterparties for. Provide either walletAddress or entityName.

e.g.
chainstringrequired

Nansen chain slug for the counterparties. Use 'all' to span every supported chain.

One of
dateobjectrequired

ISO 8601 date-time range for the counterparties, with from and to fields. High-volume addresses are capped at 180 days upstream.

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
source_inputstringoptional

Type of interactions to include.

One of
group_bystringoptional

Group counterparties by wallet or by entity.

One of
paginationobjectoptional

Optional pagination, e.g. { "page": 1, "perPage": 10 }.

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page (max 1000).

Provide at least one of address, entity_name.
POST/routes/nansen/crypto/wallet-counterparties
Request body
{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  }
}

ResponseExample response
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    },
    "data": [
      {
        "counterparty_address": "0x000d2c2155283c4ae283f0298a69ea71998f8aef",
        "counterparty_address_label": [
          "Binance"
        ],
        "interaction_count": 88852,
        "total_volume_usd": 12785545084.752466,
        "volume_in_usd": 6535484560.602552,
        "volume_out_usd": 6250060524.149914,
        "tokens_info": [
          {
            "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "token_symbol": "USDT",
            "token_name": "Tether USD",
            "num_transfer": "232"
          },
          {
            "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
            "token_symbol": "ETH",
            "token_name": "Ethereum",
            "num_transfer": "219"
          },
          {
            "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "token_symbol": "USDT",
            "token_name": "Tether USD",
            "num_transfer": "215"
          }
        ]
      },
      {
        "counterparty_address": "0x363de1a78b9ca98670ccf38f883264ac7d5705ab",
        "counterparty_address_label": [
          "HTX"
        ],
        "interaction_count": 189,
        "total_volume_usd": 164588756.9988589,
        "volume_in_usd": 0,
        "volume_out_usd": 164588756.9988589,
        "tokens_info": [
          {
            "token_address": "0x68749665ff8d2d112fa859aa293f07a622782f38",
            "token_symbol": "XAUT",
            "token_name": "Tether Gold",
            "num_transfer": "28"
          },
          {
            "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "token_symbol": "USDT",
            "token_name": "Tether USD",
            "num_transfer": "18"
          },
          {
            "token_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
            "token_symbol": "ETH",
            "token_name": "Ethereum",
            "num_transfer": "6"
          }
        ]
      },
      {
        "counterparty_address": "0x51c72848c68a965f66fa7a88855f9f7784502a7f",
        "counterparty_address_label": [
          "Wintermute Market Making"
        ],
        "interaction_count": 207,
        "total_volume_usd": 99535965.80426788,
        "volume_in_usd": 0,
        "volume_out_usd": 99535965.80426788,
        "tokens_info": [
          {
            "token_address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
            "token_symbol": "UNI",
            "token_name": "Uniswap",
            "num_transfer": "14"
          },
          {
            "token_address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
            "token_symbol": "SHIB",
            "token_name": "SHIBA INU",
            "num_transfer": "13"
          },
          {
            "token_address": "0x45804880de22913dafe09f4980848ece6ecbaf78",
            "token_symbol": "PAXG",
            "token_name": "Paxos Gold",
            "num_transfer": "11"
          }
        ]
      }
    ]
  },
  "h402": {
    "routeId": "crypto/wallet-counterparties",
    "provider": "nansen",
    "selectedCandidateId": "crypto/wallet-counterparties/nansen",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

nansen
x402
100
Success
100%
p50
1.90s
Calls
3
100%
$0.05$0.050/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider