# Nansen Related Wallets

> Nansen Related Wallets is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-09).

Returns wallets related to a given blockchain address through on-chain interactions, with relationship type, transaction hash, and timing details.

## Facts

- Endpoint: POST https://api.nansen.ai/api/v1/profiler/address/related-wallets?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Provider: Nansen
- Docs: https://docs.nansen.ai
- Website: https://nansen.ai
- Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data
- Canonical page: https://www.zero.xyz/c/nansen-related-wallets-c50240b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tQ88qhii_avUrk8YcqwPE

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 nansen-related-wallets-c50240b8 -d '<json body>'
```

Example prompt: Can you find all wallets related to the Ethereum address 0x28c6c06298d514db089934071355e5743bf21d60 on Nansen, showing the first 20 results sorted by order descending?

## When to prefer this

Use this endpoint when you need to discover and map on-chain wallet relationships for a specific address across supported chains. It is ideal for blockchain forensics, smart money tracking, counterparty analysis, and building wallet connection graphs. Prefer this over general transaction lookups when the goal is specifically to identify related wallets and the nature of their relationship to the input address.

## Known failure modes

- Invalid or unsupported chain returns a validation error
- Malformed or non-existent address returns empty data or error
- Pagination parameters out of range (e.g. per_page > 1000) return a validation error
- Rate limiting or insufficient payment may return a 402 or 429 error
- Address with no known relationships returns an empty data array

## How this service works

Get wallets that are related to the input address through various types
of blockchain interactions and relationships. Returns detailed information
about each related wallet including the relationship type, transaction details, and timing information.

## Output

A paginated list of wallet records related to the input address, each containing the related wallet address, the type of on-chain relationship, the transaction hash that established the relationship, the block timestamp, an optional address label, and the chain — along with pagination metadata indicating the current page, records per page, and whether it is the last page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProfilerAddressRelatedWalletsRequest",
 "required": [
  "chain"
 ],
 "properties": {
  "chain": {
   "enum": [
    "arbitrum",
    "arc",
    "avalanche",
    "base",
    "bitcoin",
    "bnb",
    "ethereum",
    "injective",
    "iotaevm",
    "linea",
    "mantle",
    "mantra",
    "monad",
    "near",
    "optimism",
    "plasma",
    "polygon",
    "robinhood",
    "sei",
    "solana",
    "sonic",
    "starknet",
    "sui",
    "ton",
    "tron"
   ],
   "type": "string",
   "title": "ProfilerAddressRelatedWalletsChain",
   "description": "Chains supported in profiler related wallets analysis."
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    }
   ],
   "title": "Address",
   "deprecated": true,
   "description": "Deprecated: Use 'wallet_address' instead. Alias of `wallet_address`. If you send both fields, they must contain the same address."
  },
  "order_by": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "type": "object",
      "title": "ProfilerAddressRelatedWalletsSortOrder",
      "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."
  },
  "wallet_address": {
   "type": "string",
   "title": "Wallet Address",
   "examples": [
    "0x28c6c06298d514db089934071355e5743bf21d60",
    "8zFZHuSRuDpuAR7J6FzwyF3vKNx4CVW3DFHJerQhc7Zd"
   ],
   "description": "Wallet address to get related walle
… (truncated)
```

## 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/nansen-related-wallets-c50240b8/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)