/wallets/{address}/counterparties

The addresses this wallet transacted with most, by combined transfer volume over a window.

GET https://data.vike.io/v1/onchain/wallets/{address}/counterparties

The addresses this wallet transacted with most, by combined transfer volume over a window. Returns counterparty address, total volume, amount sent and received, transaction count, first and last seen, and labels where the label cascade knows the address. sent_usd and received_usd are from {address}'s side: in the capture below, wintermute's received_usd is what Binance 14 received from wintermute, not what wintermute received.

first_seen is the first contact inside the window, not the first ever

In the capture below every first_seen lands within a minute of 2026-09-18T22:43, which is exactly 30 days before the call — the window=30d boundary, not a fact about the relationship. Widen the window and these dates move. For a genuine lifetime first-seen, use /wallets/{address}, whose all block carries one.

cURL

# who the wallet deals with most over 30 days, ranked by combined sent-and-received volume
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/counterparties?limit=3&window=30d"

# the full ranking the route serves: 50 counterparties, at the default 30d window
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/counterparties?limit=50"

# who it dealt with this week
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/counterparties?window=7d&limit=20"

# the long-run ranking over all recorded history, to diff against the 7d one for newly appeared counterparties
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/counterparties?window=all&limit=50"

# the same wallet address on BSC
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/counterparties?chain=bsc&window=30d&limit=20"

# just the addresses, to feed /wallets/compare or /wallets/{address}/trace
curl -s -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/onchain/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/counterparties?limit=10" \
  | jq -r '.[].wallet'

addresspathrequired

Wallet address

chainqueryoptional

ethereum | bsc | base. Default ethereum

windowqueryoptional

24h | 7d | 30d | 90d | 180d | all. Default 30d

limitqueryoptional

Route default 100; applied cap 50

A live response for the Binance 14 hot wallet, captured 2026-10-18T22:42 UTC — all three rows, as returned for limit=3. The response is a bare JSON array, not an object with a wrapper key. The USD fields are plain USD, the same unit as /trace and /wallets/compare (until 2026-10-12 they came back in micro-USD, 1,000,000 times too large).

Example response

[
  {
    "wallet": "0xeae7380dd4cef6fbd1144f49e4d1e6964258a4f4",
    "total_volume_usd": 7002510803.927959,
    "sent_usd": 0.0,
    "received_usd": 7002510803.927959,
    "tx_count": 8379,
    "first_seen": "2026-09-18T22:43:23",
    "last_seen": "2026-10-18T22:32:47",
    "entity": "wintermute",
    "wallet_type": "market_maker"
  },
  {
    "wallet": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",
    "total_volume_usd": 5490247267.861948,
    "sent_usd": 5490247267.861948,
    "received_usd": 0.0,
    "tx_count": 2756,
    "first_seen": "2026-09-18T22:42:59",
    "last_seen": "2026-10-18T22:02:35",
    "entity": "binance",
    "wallet_type": "cex"
  },
  {
    "wallet": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
    "total_volume_usd": 5152670603.627958,
    "sent_usd": 5152670603.627958,
    "received_usd": 0.0,
    "tx_count": 2807,
    "first_seen": "2026-09-18T22:42:59",
    "last_seen": "2026-10-18T22:22:23",
    "entity": "binance",
    "wallet_type": "cex"
  }
]