# Nansen Address Counterparties

> Nansen Address Counterparties is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Retrieves counterparty wallet addresses and entities that have transacted with a given blockchain address, using Nansen's smart money and wallet label intelligence.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/profiler/address/counterparties
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-76da879e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oTQnhqsnrWHPDBFGj8xCo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-nansen-ai-76da879e
```

Example prompt: Pull up all the counterparties for Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see which wallets and labeled entities it has transacted with, especially any smart money or known exchange addresses.

## When to prefer this

Use this endpoint when you need to understand the social or transactional graph of a specific blockchain address — especially when you want Nansen's proprietary wallet labels and smart money classifications applied to counterparties. Prefer this over raw on-chain data tools when entity identification and labeling context matters.

## Known failure modes

- Invalid or malformed blockchain address returns a 400 error
- Address has no on-chain transaction history returns empty counterparties list
- Unsupported blockchain network for the queried address
- Rate limiting or quota exceeded returns a 429 error
- Missing or invalid authentication token returns a 401 error
- Payment not received or insufficient balance returns a 402 error

## How this service works

Get Address Counterparties Data

## Output

A list of counterparty wallet addresses and entities that have transacted with the queried address, enriched with Nansen wallet labels, entity names, smart money tags, and interaction metadata such as transaction counts or volumes.

## Example request

```json
{
 "date": {
  "to": "2025-01-31T23:59:59Z",
  "from": "2025-01-01T00:00:00Z"
 },
 "chain": "ethereum",
 "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
 "pagination": {
  "page": 1,
  "per_page": 10
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressCounterpartiesRequest",
 "examples": [
  {
   "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"
  },
  {
   "date": {
    "to": "2025-05-03T23:59:59Z",
    "from": "2025-05-01T00:00:00Z"
   },
   "chain": "ethereum",
   "group_by": "entity",
   "pagination": {
    "page": 1,
    "per_page": 10
   },
   "entity_name": "Vitalik Buterin",
   "source_input": "Combined"
  }
 ],
 "required": [
  "chain",
  "date"
 ],
 "properties": {
  "date": {
   "type": "object",
   "title": "DateRange",
   "properties": {
    "to": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "To",
     "examples": [
      "2025-01-31T23:59:59Z"
     ],
     "description": "End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"
    },
    "from": {
     "anyOf": [
      {
       "type": "string"
      }
     ],
     "title": "From",
     "examples": [
      "2025-01-01T00:00:00Z"
     ],
     "description": "Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"
    }
   },
   "description": "Date range model matching the API schema."
  },
  "chain": {
   "enum": [
    "all",
    "arbitrum",
    "avalanche",
    "base",
    "bitcoin",
    "bnb",
    "ethereum",
    "hyperevm",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "polygon",
    "ronin",
    "scroll",
    "sei",
    "solana",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "ProfilerChain",
   "description": "Chains supported in profiler analysis."
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    }
   ],
   "title": "Address",
   "examples": [
    "0x28c6c06298d514db089934071355e5743bf21d60",
    "8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"
   ],
   "description": "Address to get counterparties for"
  },
  "filters": {
   "anyOf": [
    {
     "type": "object",
     "title": "ProfilerAddressCounterpartiesFilters",
     "properties": {
      "volume_in_usd": {
       "anyOf": [
        {
         "type": "object",
         "title": "NumericRangeFilter",
         "properties": {
          "max": {
           "anyOf": [
            {
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressCounterpartiesResponse",
 "required": [
  "pagination",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ProfilerCounterparty",
    "required": [
     "counterparty_address",
     "interaction_count"
    ],
    "properties": {
     "tokens_info": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "object",
         "title": "TokenInfo",
         "required": [
          "token_address",
          "token_symbol",
          "token_name",
          "num_transfer"
         ],
         "properties": {
          "token_name": {
           "type": "string",
           "title": "Token Name",
           "description": "Token name"
          },
          "num_transfer": {
           "type": "string",
           "title": "Num Transfer",
           "description": "Number of transfers"
          },
          "token_symbol": {
           "type": "string",
           "title": "Token Symbol",
           "description": "Token symbol"
          },
          "token_address": {
           "type": "string",
           "title": "Token Address",
           "description": "Token contract address"
          }
         },
         "description": "Token information for counterparty interactions."
        }
       }
      ],
      "title": "Tokens Info",
      "description": "Information about tokens transferred with this counterparty"
     },
     "volume_in_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Volume In Usd",
      "description": "Incoming transaction volume in USD"
     },
     "volume_out_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Volume Out Usd",
      "description": "Outgoing transaction volume in USD"
     },
     "total_volume_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Total Volume Usd",
      "description": "Total transaction volume in USD"
     },
     "interaction_count": {
      "type": "integer",
      "title": "Interaction Count",
      "description": "Total number of interactions with this counterparty"
     },
     "counterparty_address": {
      "type": "string",
      "title": "Counterparty Address",
      "description": "Counterparty address in hex format"
     },
     "counterparty_address_label": {
      "anyOf": [
       {
        "type": "array",
        "items": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-76da879e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)