{"uid":"cap_oTQnhqsnrWHPDBFGj8xCo","slug":"api-nansen-ai-76da879e","name":"Nansen Address Counterparties","description":"Get Address Counterparties Data","url":"https://api.nansen.ai/api/v1/profiler/address/counterparties","method":"GET","headers":{},"bodySchema":{"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":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"max":1000000,"min":1000}],"description":"Volume in USD range filter"},"volume_out_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"max":1000000,"min":1000}],"description":"Volume out USD range filter"},"total_volume_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"max":1000000,"min":1000}],"description":"Total volume range filter in USD"},"interaction_count":{"anyOf":[{"type":"object","title":"IntegerRangeFilter","properties":{"max":{"anyOf":[{"type":"integer"}],"title":"Max","examples":[100,1000,10000],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"integer"}],"title":"Min","examples":[10,100,1000],"description":"Minimum value (inclusive)"}},"description":"Filter for integer values with optional min/max bounds.\nUse for counts, numbers of items, and other whole number values. - Values between 5 and 100"}],"examples":[{"max":1000,"min":5}],"description":"Interaction count range filter"},"exclude_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"Exclude Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Exclude smart money labels for counterparties"},"include_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"Include Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Include smart money labels for counterparties"}},"description":"Filters for profiler address counterparties endpoint.\n\nThese filters control which counterparties and interactions are included.","additionalProperties":false}],"examples":[{"total_volume_usd":{"min":1000},"interaction_count":{"min":5},"include_smart_money_labels":["Exchange"]}],"description":"Additional filters to apply. Only filters for columns that are being selected will be applied."},"group_by":{"enum":["wallet","entity"],"type":"string","title":"GroupBy","description":"Enum for grouping types in counterparties endpoint."},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SortOrder[ProfilerAddressCounterpartiesSortField]","required":["field","direction"],"properties":{"field":{"enum":["interaction_count","total_volume_usd","last_interaction_date","volume_in_usd","volume_out_usd"],"type":"string","title":"ProfilerAddressCounterpartiesSortField","description":"Enum for sortable fields in profiler address counterparties."},"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.\n\nExamples:\n- [{\"field\": \"total_volume_usd\", \"direction\": \"DESC\"}] - Sort by total volume descending\n- [{\"field\": \"interaction_count\", \"direction\": \"ASC\"}] - Sort by interaction count ascending\n- [{\"field\": \"last_interaction_date\", \"direction\": \"DESC\"}] - Sort by last interaction date descending\n- [{\"field\": \"volume_in_usd\", \"direction\": \"DESC\"}] - Sort by incoming volume descending"},"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."},"entity_name":{"anyOf":[{"type":"string"}],"title":"Entity Name","examples":["Vitalik Buterin","Binance"],"description":"Entity name to get counterparties for"},"source_input":{"enum":["Combined","Tokens","ETH"],"type":"string","title":"SourceInput","description":"Enum for source input types in counterparties endpoint."}},"description":"","additionalProperties":false},"responseSchema":{"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":{"type":"string"}}],"title":"Counterparty Address Label","description":"List of labels associated with this counterparty"}},"description":"Individual profiler counterparty record.\n\nRepresents a counterparty that a wallet has interacted with."},"title":"Data","description":"List of counterparty 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 counterparties endpoint.\n\nContains the filtered counterparties data with metadata."},"example":{"request":{"date":{"to":"2025-01-31T23:59:59Z","from":"2025-01-01T00:00:00Z"},"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","pagination":{"page":1,"per_page":10}},"response":{"data":[{"tokens_info":[{"token_name":"Ethereum","num_transfer":"1","token_symbol":"ETH","token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"}],"volume_in_usd":2108712.542897524,"volume_out_usd":0,"total_volume_usd":2108712.542897524,"interaction_count":1,"counterparty_address":"0x0a4f6ecb214dc1d9acdd99743b4dcc58ccc088b9","counterparty_address_label":["​​Top Circle Depositor [0x0a4f6e]"]},{"tokens_info":[{"token_name":"USD Coin","num_transfer":"3","token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}],"volume_in_usd":0,"volume_out_usd":638397.6188294775,"total_volume_usd":638397.6188294775,"interaction_count":3,"counterparty_address":"0xf20784fb0047fe897919b1cd4264dad364c9d5a3","counterparty_address_label":["​​🤖 Multisig [0xf20784]"]},{"tokens_info":[{"token_name":"USD Coin","num_transfer":"9","token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},{"token_name":"MSTR2100","num_transfer":"1","token_symbol":"MSTR","token_address":"0x42069026eac8eee0fd9b5f7adfa4f6e6d69a2b39"},{"token_name":"ETHEREUM IS GOOD","num_transfer":"1","token_symbol":"EBULL","token_address":"0x71297312753ea7a2570a5a3278ed70d9a75f4f44"}],"volume_in_usd":342095.2555305235,"volume_out_usd":159699.69322461568,"total_volume_usd":501794.94875513914,"interaction_count":11,"counterparty_address":"0xf081470f5c6fbccf48cc4e5b82dd926409dcdd67","counterparty_address_label":["🤖 🏦 KyberSwap: Aggregation Executor [0xf08147]"]},{"tokens_info":[{"token_name":"USD Coin","num_transfer":"8","token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},{"token_name":"LEDOG","num_transfer":"1","token_symbol":"DOG","token_address":"0x864cb5194722d5a1596f4be8b899916d30dad8d8"},{"token_name":"Ethereum","num_transfer":"1","token_symbol":"ETH","token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"},{"token_name":"Neiro","num_transfer":"1","token_symbol":"NEIRO","token_address":"0x812ba41e071c7b7fa4ebcfb62df5f45f6fa853ee"},{"token_name":"ETHEREUM IS GOOD","num_transfer":"1","token_symbol":"EBULL","token_address":"0x71297312753ea7a2570a5a3278ed70d9a75f4f44"}],"volume_in_usd":293994.53903815657,"volume_out_usd":124313.51424072767,"total_volume_usd":418308.05327888427,"interaction_count":12,"counterparty_address":"0x70bf6634ee8cb27d04478f184b9b8bb13e5f4710","counterparty_address_label":["🤖 🏦 0x: Mainnet Settler [0x70bf66]"]},{"tokens_info":[{"token_name":"LEDOG","num_transfer":"3","token_symbol":"DOG","token_address":"0x864cb5194722d5a1596f4be8b899916d30dad8d8"}],"volume_in_usd":0,"volume_out_usd":158616.28458512173,"total_volume_usd":158616.28458512173,"interaction_count":3,"counterparty_address":"0xc9af6f0bbfc651f8b3b21f1110691ba09a06300b","counterparty_address_label":["🤖 🏦 Uniswap: V2 DOG-WETH Liquidity Pool  [0xc9af6f]"]},{"tokens_info":[{"token_name":"Marvin Inu","num_transfer":"1","token_symbol":"MARVIN","token_address":"0x85bea4ee627b795a79583fcede229e198aa57055"}],"volume_in_usd":0,"volume_out_usd":88531.30874205094,"total_volume_usd":88531.30874205094,"interaction_count":1,"counterparty_address":"0x9b49a32b76216ead560d33076b3cabc51dbfe0f0","counterparty_address_label":["🤖 🏦 Uniswap: V2 MARVIN-WETH Liquidity Pool  [0x9b49a3]"]},{"tokens_info":[{"token_name":"USD Coin","num_transfer":"2","token_symbol":"USDC","token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}],"volume_in_usd":74963.37338392923,"volume_out_usd":0,"total_volume_usd":74963.37338392923,"interaction_count":2,"counterparty_address":"0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43","counterparty_address_label":["🤖 🏦 Coinbase [0xa9d1e0]"]},{"tokens_info":[{"token_name":"First City in Mars","num_transfer":"1","token_symbol":"TERMINUS","token_address":"0xcbde0453d4e7d748077c1b0ac2216c011dd2f406"}],"volume_in_usd":0,"volume_out_usd":63939.41685674573,"total_volume_usd":63939.41685674573,"interaction_count":1,"counterparty_address":"0x6bcd2862522c0ab45f4f9fe693e36c791ede0a42","counterparty_address_label":["🤖 🏦 Uniswap: V2 WETH-TERMINUS Liquidity Pool  [0x6bcd28]"]},{"tokens_info":[{"token_name":"Phil","num_transfer":"1","token_symbol":"PHIL","token_address":"0xc328a59e7321747aebbc49fd28d1b32c1af8d3b2"}],"volume_in_usd":0,"volume_out_usd":48892.83663094737,"total_volume_usd":48892.83663094737,"interaction_count":1,"counterparty_address":"0xc3576f38c32e95e36bbd8d91e6cbe646a3723110","counterparty_address_label":["🤖 🏦 Uniswap: V2 WETH-PHIL Liquidity Pool  [0xc3576f]"]},{"tokens_info":[{"token_name":"JOKER","num_transfer":"1","token_symbol":"JOKER","token_address":"0xe0797ec1d0bb0bec541a82c5262c3b0f93f68bfe"}],"volume_in_usd":0,"volume_out_usd":44565.5015666019,"total_volume_usd":44565.5015666019,"interaction_count":1,"counterparty_address":"0xf5f687c7a7800d6bc646b9a729924367a0909747","counterparty_address_label":["🤖 🏦 Uniswap: V2 WETH-JOKER Liquidity Pool  [0xf5f687]"]}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"date":{"to":"2025-01-31T23:59:59Z","from":"2025-01-01T00:00:00Z"},"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","pagination":{"page":1,"per_page":10}},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K5kMnxyaSJi3qfEo1vqJE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves counterparty wallet addresses and entities that have transacted with a given blockchain address, using Nansen's smart money and wallet label intelligence.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-06-04T17:23:53.371Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:48:58.403Z","isFirstParty":false}