{"uid":"cap_IdVa6KgX6yYjylL9V7o-C","slug":"api-nansen-ai-db563b44","name":"Nansen Address Related Wallets","description":"Get Address Related Wallets Data","url":"https://api.nansen.ai/api/v1/profiler/address/related-wallets","method":"GET","headers":{},"bodySchema":{"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},"responseSchema":{"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."},"example":{"request":{"chain":"ethereum","address":"0x28c6c06298d514db089934071355e5743bf21d60"},"response":{"data":[{"chain":"ethereum","order":1,"address":"0x00799bbc833d5b168f0410312d2a8fd9e0e3079c","relation":"First Funder","address_label":"🏦 Binance [0x00799b]","block_timestamp":"2021-04-22T06:34:00","transaction_hash":"0x7671e86accfb3cd75a9000e2d7eabced7fedab72aadeb93a4232cf1729b4e219"},{"chain":"ethereum","order":3,"address":"0xe2572ce62688019a99d00a613d63e8f411410fc7","relation":"Previous Multisig Signer of","address_label":"​​🤖 Multisig Wallet [0xe2572c]","block_timestamp":"2024-04-05T13:08:23","transaction_hash":"0x54951af9124751e9e1e985cf6e90193ba22ea52584041856d9261781aaeb4ff0"},{"chain":"ethereum","order":5,"address":"0x2b959bca871b51de6cdf306daa2048728fe97a01","relation":"Deployed Contract","address_label":"​​🏦 Token Channel [0x2b959b]","block_timestamp":"2023-05-04T21:51:47","transaction_hash":"0xa84c5fc6cf57ab42397116e3d6aa4359fd8e6ecdd1039fe9e4346d5bcaf99510"},{"chain":"ethereum","order":5,"address":"0x8ed76e6a8816f57ed46ffd9b49cecd96f1baa8cd","relation":"Deployed Contract","address_label":"​​🏦 Channel [0x8ed76e]","block_timestamp":"2023-05-04T21:52:23","transaction_hash":"0xe57e2d7c85ac6aedf2d454bd3b973ca290b433896d948c5f069f967a04693dc9"},{"chain":"ethereum","order":5,"address":"0xf99d2f4a886efaadf7870cb3c215f63a98ae32ad","relation":"Deployed Contract","address_label":"​​🤖 Channel [0xf99d2f]","block_timestamp":"2023-05-04T21:53:11","transaction_hash":"0x3f49c4e7d2a1e5274bd09308c6eae98cd3b80c9aaaa48e48e065d67a20f67bcc"},{"chain":"ethereum","order":5,"address":"0xd2c68a94ad198e7abc67ce3a10e8af4f18aa0344","relation":"Deployed Contract","address_label":"​​🤖 Channel [0xd2c68a]","block_timestamp":"2023-05-04T21:54:11","transaction_hash":"0x8c9b4b7c1f38766cb7e84ef67da01f1aa1e9c541717ee01c4a257919734e221e"},{"chain":"ethereum","order":5,"address":"0xa3ef64747b2586c8604f81a80cda6096c223c0ae","relation":"Deployed Contract","address_label":"​​🤖 Channel [0xa3ef64]","block_timestamp":"2023-05-04T21:58:35","transaction_hash":"0x6df7edd91b12292e3d38580a68cc18a26da488cbf9807c04743d3e1a36b193e1"},{"chain":"ethereum","order":7,"address":"0xf8ba4a0efe0609159bb5dbc53371ab7e2f7812ba","relation":"Deployed via","address_label":"​​CLIPS Token Channel Manager [0xf8ba4a]","block_timestamp":"2023-05-04T21:51:47","transaction_hash":"0xa84c5fc6cf57ab42397116e3d6aa4359fd8e6ecdd1039fe9e4346d5bcaf99510"}],"pagination":{"page":1,"per_page":10,"is_last_page":true}}},"exampleRequest":{"chain":"ethereum","address":"0x28c6c06298d514db089934071355e5743bf21d60"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.50","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7tAPQQl7lRrKE0bi-sykj","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_3fnYxYncpL9EaFoBwRHCP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns wallets that are related to a given blockchain address, surfacing connected or associated wallet clusters using Nansen's on-chain analytics.","exampleAgentPrompt":"Using Nansen, find all wallets related to or associated with the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see which other wallets are connected to it.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-06-04T17:23:51.788Z","lastSuccessfullyRanAt":"2026-06-04T17:23:51.788Z","lastHealthCheckAt":"2026-09-15T13:00:18.152Z","isFirstParty":false}