Counterparties

profiler/address/counterparties

post

This endpoint includes the addresses which have the most common interactions with the input address and their volume and transaction counts.

Parameters

Parameter	Type	Description
wallet_addresses	String	Comma separated list of addresses.
source_value	Enum	ETH/Tokens/Combined
date_from	String	Date range start input, format YYYY-MM-DD
date_to	String	Date range end input, format YYYY-MM-DD
group_by	String	'wallet' or 'entity

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/profiler/address/counterparties HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "parameters": {
    "walletAddresses": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ],
    "chain": "ethereum",
    "sourceInput": null,
    "groupBy": null,
    "dateFrom": "1970-01-01T00:00:00Z",
    "dateTo": "2050-01-01T00:00:00Z",
    "timeRange": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  }
}

[
  {
    "chain": "text",
    "interactingWalletAddress": "text",
    "interactingWalletLabel": "text",
    "volumeOut": "text",
    "volumeIn": "text",
    "numberOfOutgoingTransactions": "text",
    "numberOfIncomingTransactions": "text",
    "netInflowInUsd": "text",
    "info": "text"
  }
]

profiler/address/related-wallets

post

This endpoint gives information about related wallets of an input address. The relation can be any of 'First Funder', 'Signer', 'Previous Signer', 'Multisig Signer of', 'Previous Multisig Signer of', 'Deployed via', 'Deployed by', 'Deployed Contract', 'Created Contract', 'Created by'.

Parameters

Parameter	Type	Description
wallet_addresses	Array(String)	Hexadecimal representation of an address.

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/profiler/address/related-wallets HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "parameters": {
    "chain": "ethereum",
    "walletAddresses": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ]
  }
}

[
  {
    "addressHex": "text",
    "addressName": "text",
    "relation": "text",
    "transactionHash": "text"
  }
]