{"uid":"cap_tQ88qhii_avUrk8YcqwPE","slug":"nansen-related-wallets-c50240b8","name":"Nansen Related Wallets","description":"Get wallets that are related to the input address through various types\nof blockchain interactions and relationships. Returns detailed information\nabout each related wallet including the relationship type, transaction details, and timing information.","url":"https://api.nansen.ai/api/v1/profiler/address/related-wallets?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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 wallets for. Required, unless the deprecated `address` field is sent."}},"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":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"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"}]},"paymentMethods":[{"uid":"pm_Wmq9oTgVfpMSAjc3MYFWE","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns wallets related to a given blockchain address through on-chain interactions, with relationship type, transaction hash, and timing details.","exampleAgentPrompt":"Can you find all wallets related to the Ethereum address 0x28c6c06298d514db089934071355e5743bf21d60 on Nansen, showing the first 20 results sorted by order descending?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:54:55.039Z","isFirstParty":false,"canonicalSlug":"nansen-related-wallets-c50240b8"}