# Nansen Address Related Wallets

> Nansen Address Related Wallets is a paid API for AI agents from api.nansen.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-09-13, last successful call 2026-06-04).

Returns wallets that are related to a given blockchain address, surfacing connected or associated wallet clusters using Nansen's on-chain analytics.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/profiler/address/related-wallets
- Price: $0.01/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-09-13
- Last successful call: 2026-06-04
- Success rate: 50% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-nansen-ai-db563b44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IdVa6KgX6yYjylL9V7o-C

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-db563b44
```

Example prompt: Using Nansen, find all wallets related to or associated with the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see which other wallets are connected to it.

## When to prefer this

Use this endpoint when you need to discover wallet clusters or associated addresses for a given on-chain account — especially useful for tracking smart money flows, investigating entity relationships, or de-anonymizing wallet groups. Prefer over generic blockchain explorers when Nansen's labeled wallet intelligence and clustering is needed.

## Known failure modes

- Invalid or malformed wallet address returns 400 error
- Address not found in Nansen's database returns empty results
- Unsupported blockchain/network returns error or empty set
- Payment failure (x402) blocks the request
- Rate limiting returns 429 if too many requests

## How this service works

Get Address Related Wallets Data

## Output

A list of wallet addresses that are related to or associated with the queried address, potentially including wallet labels, entity names, and clustering metadata from Nansen's proprietary on-chain graph analysis.

## Example request

```json
{
 "chain": "ethereum",
 "address": "0x28c6c06298d514db089934071355e5743bf21d60"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressRelatedWalletsRequest",
 "required": [
  "address",
  "chain"
 ],
 "properties": {
  "chain": {
   "enum": [
    "arbitrum",
    "avalanche",
    "base",
    "bitcoin",
    "bnb",
    "ethereum",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "polygon",
    "ronin",
    "scroll",
    "sei",
    "solana",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "ProfilerAddressRelatedWalletsChain",
   "description": "Chains supported in profiler related wallets analysis."
  },
  "address": {
   "type": "string",
   "title": "Address",
   "examples": [
    "0x28c6c06298d514db089934071355e5743bf21d60",
    "8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"
   ],
   "description": "Address to get related wallets for"
  },
  "order_by": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "type": "object",
      "title": "SortOrder[ProfilerAddressRelatedWalletsSortField]",
      "required": [
       "field",
       "direction"
      ],
      "properties": {
       "field": {
        "enum": [
         "order"
        ],
        "type": "string",
        "title": "ProfilerAddressRelatedWalletsSortField",
        "description": "Enum for sortable fields in profiler address related wallets."
       },
       "direction": {
        "enum": [
         "ASC",
         "DESC"
        ],
        "type": "string",
        "title": "SortDirection",
        "description": "Enum for sort directions."
       }
      }
     }
    }
   ],
   "title": "Order By",
   "description": "Custom sort order to override the endpoint's default ordering"
  },
  "pagination": {
   "type": "object",
   "title": "PaginationRequest",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Page number (1-based)"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page (max 1000)"
    }
   },
   "description": "Pagination parameters for API requests."
  }
 },
 "description": "",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressRelatedWalletsResponse",
 "required": [
  "pagination",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ProfilerRelatedWallet",
    "required": [
     "address",
     "relation",
     "transaction_hash",
     "block_timestamp",
     "order",
     "chain"
    ],
    "properties": {
     "chain": {
      "type": "string",
      "title": "Chain",
      "description": "The chain of the relation"
     },
     "order": {
      "type": "integer",
      "title": "Order",
      "description": "The order of the relation"
     },
     "address": {
      "type": "string",
      "title": "Address",
      "description": "Hexadecimal representation of the related address"
     },
     "relation": {
      "type": "string",
      "title": "Relation",
      "description": "The type of relation between the address and the input address"
     },
     "address_label": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Address Label",
      "description": "The label of the address"
     },
     "block_timestamp": {
      "type": "string",
      "title": "Block Timestamp",
      "description": "The timestamp of the transaction"
     },
     "transaction_hash": {
      "type": "string",
      "title": "Transaction Hash",
      "description": "Hexadecimal representation of the transaction hash"
     }
    },
    "description": "Individual profiler related wallet record.\n\nRepresents a wallet that is related to the input address."
   },
   "title": "Data",
   "description": "List of related wallet records"
  },
  "pagination": {
   "type": "object",
   "title": "PaginationInfo",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Current page number"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page"
    },
    "is_last_page": {
     "type": "boolean",
     "title": "Is Last Page",
     "default": true,
     "description": "Whether this is the last page"
    }
   },
   "description": "Pagination information for API responses."
  }
 },
 "description": "Response model for profiler address related wallets endpoint.\n\nContains the related wallets data with metadata."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-nansen-ai-db563b44/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)