Address Counterparties

Get counterparties and their interaction statistics for any address or entity.

Common Scenarios

You can use this endpoint to find correct entity name format to use in this Profiler Endpoint: Click Here

Usecase	Required Parameters	Expected Output
Get counterparties for a single address	address = "0x28c6c06298d514db089934071355e5743bf21d60", chain = "ethereum", group_by: "address"	List of counterparties with interaction stats (volume, frequency, timing)
Get counterparties for an entity (e.g., Coinbase)	entity_name = "Coinbase", chain = "all", group_by: "entity"	Aggregated counterparties across all entity wallets with interaction stats

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Results are served from a server-side cache: once a requested date range has fully settled (about two days after it closes) it is cached for up to 7 days, while ranges that include today or a recently-closed window use a short cache of up to 5 minutes.

Get Address Counterparties Data

post

Get top counterparties that wallet addresses have interacted with, supporting different grouping options (wallet or entity) and source filtering (Combined, Tokens, ETH). Returns interaction statistics including volume, frequency, and timing data.

What it helps to answer:

• Most frequent transaction partners by count and volume

• Net value flows between addresses (inflows vs outflows)

• Exchange and protocol interaction patterns

• DeFi protocol usage and DEX trading counterparties

• High-value transfer relationships and funding sources

Authorizations

apikeystringRequired

API key for authentication

Body

addressany ofOptional

Address to get counterparties for

Example: 0x6df064f04ddfb2bb53da21af9d56701726700145

stringOptional

entity_nameany ofOptional

Entity name to get counterparties for

Example: Vitalik Buterin

stringOptional

chainstring · enumRequired

Blockchain chain for the counterparties data

Example: ethereumPossible values:

source_inputstring · enumOptional

Type of interactions to include

Default: CombinedPossible values:

group_bystring · enumOptional

Group counterparties by wallet or entity

Default: walletPossible values:

filtersany ofOptional

Additional filters to apply. Only filters for columns that are being selected will be applied.

Example: {"include_smart_money_labels":["Exchange"],"interaction_count":{"min":5},"total_volume_usd":{"min":1000}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "total_volume_usd", "direction": "DESC"}] - Sort by total volume descending
• [{"field": "interaction_count", "direction": "ASC"}] - Sort by interaction count ascending
• [{"field": "volume_in_usd", "direction": "DESC"}] - Sort by incoming volume descending

Responses

200

Address counterparties data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/profiler/address/counterparties

POST /api/v1/profiler/address/counterparties HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 226

{
  "address": "0x6df064f04ddfb2bb53da21af9d56701726700145",
  "chain": "ethereum",
  "date": {
    "from": "2025-05-01T00:00:00Z",
    "to": "2025-05-03T23:59:59Z"
  },
  "group_by": "wallet",
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "source_input": "Combined"
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "counterparty_address": "text",
      "counterparty_address_label": [
        "text"
      ],
      "interaction_count": 1,
      "total_volume_usd": 1,
      "volume_in_usd": 1,
      "volume_out_usd": 1,
      "tokens_info": [
        {
          "token_address": "text",
          "token_symbol": "text",
          "token_name": "text",
          "num_transfer": "text"
        }
      ]
    }
  ]
}