{"uid":"cap_2XUgy9FT5sV3lSe1SyhID","slug":"arkham-counterparties-by-address-01929abb","name":"Arkham Counterparties by Address","description":"Get top Arkham counterparties for an address. $10.00 per call.","url":"https://api.arkm.com/x402/counterparties/address","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"flow":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Transfer direction. Only \"in\" or \"out\" are accepted (omit for both directions)."},"tags":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of counterparty tags to filter by."},"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum number of results to return. Default: 20. Max: 1000."},"chains":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Chains to filter by, as a single comma-separated value (e.g. 'base,bsc'). If omitted, returns counterparties across all…"},"tokens":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Comma-separated list of token addresses or token IDs; matches counterparties involving any of them."},"usdGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to counterparties whose aggregated USD volume is at least this value."},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The address to query counterparties for. A comma-separated list is also accepted — their counterparties are aggregated…"},"timeGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to activity after this time. Accepts RFC 3339, Unix seconds/ms, or YYYY-MM-DD."},"timeLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to activity before this time. Accepts RFC 3339, Unix seconds/ms, or YYYY-MM-DD."},"timeLast":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to activity within this duration before now (e.g. 24h, 7d). Cannot be combined with timeGte/timeLte."}}},"responseSchema":{"type":"json","example":{"bsc":[{"usd":1014571199.420227,"flow":"all","chains":["bsc"],"address":{"chain":"bsc","address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","contract":false,"arkhamLabel":{"name":"Cold Wallet","address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","chainType":"evm"},"arkhamEntity":{"id":"binance","name":"Binance","note":"","type":"cex","service":null,"twitter":"https://twitter.com/binance","website":"https://binance.com","linkedin":"https://www.linkedin.com/company/binance","crunchbase":"https://www.crunchbase.com/organization/binance"},"isUserAddress":false},"transactionCount":78},{"usd":3163.48583984375,"flow":"in","chains":["bsc"],"address":{"chain":"bsc","address":"0xD65448affe1475F101378A744a62C00F04CF50D6","contract":false,"arkhamLabel":{"name":"Hot Wallet","address":"0xD65448affe1475F101378A744a62C00F04CF50D6","chainType":"evm"},"arkhamEntity":{"id":"kanga-exchange","name":"Kanga Exchange","note":"","type":"cex","service":null,"twitter":"https://twitter.com/KangaExchange","website":"https://kanga.exchange/"},"isUserAddress":false},"transactionCount":1}],"base":[{"usd":5252.65185546875,"flow":"out","chains":["base"],"address":{"chain":"base","address":"0x31beec3942E4Faf3F253c86b51537387d16Ada34","contract":false,"arkhamLabel":{"name":"Binance Deposit","address":"0x31beec3942E4Faf3F253c86b51537387d16Ada34","chainType":"evm"},"isUserAddress":false,"depositServiceID":"binance"},"transactionCount":1},{"usd":2028.17822265625,"flow":"in","chains":["base"],"address":{"chain":"base","address":"0x6dcBCe46a8B494c885D0e7b6817d2b519dF64467","contract":false,"arkhamLabel":{"name":"Hot Wallet","address":"0x6dcBCe46a8B494c885D0e7b6817d2b519dF64467","chainType":"evm"},"arkhamEntity":{"id":"coinbase","name":"Coinbase","note":"","type":"cex","service":null,"twitter":"https://twitter.com/coinbase","website":"https://coinbase.com","linkedin":"https://www.linkedin.com/company/coinbase","crunchbase":"https://www.crunchbase.com/organization/coinbase"},"isUserAddress":false},"transactionCount":1}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"10","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":"$10/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"10","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oic1k6BJPFwG3rDg-_w2R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"10","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top counterparty wallets (with entity labels, USD flow, and transaction counts) for a given blockchain address, paid per-request via x402.","exampleAgentPrompt":"Pull the counterparty breakdown for Ethereum address 0xF977814e90dA44bFA03b6295A0616a897441aceC — I want to see which entities it's been transacting with, the USD volume, and whether those flows are inbound or outbound.","exampleUseCases":[{"title":"Identify exchange interactions for a whale wallet","prompt":"Look up the top counterparties for crypto address 0xabc123...def on BSC — I want to know which exchanges or labeled entities it's been sending and receiving funds from, with USD amounts."},{"title":"Due diligence on a counterparty before a large transfer","prompt":"Before I do business with this wallet 0x31beec3942E4Faf3F253c86b51537387d16Ada34 on Base, can you pull its Arkham counterparty data so I can see who they've been transacting with and whether any known entities show up?"},{"title":"Trace suspicious outflows from a flagged address","prompt":"I need to investigate where funds are going from address 0xD65448affe1475F101378A744a62C00F04CF50D6 — can you get me its counterparty breakdown showing top receivers, USD volume, and any entity labels like exchange names?"}],"resultDescription":"A JSON object keyed by chain (e.g. 'bsc', 'base', 'ethereum'), each containing an array of counterparty records. Each record includes: the counterparty address, USD volume transacted, flow direction (in/out/all), transaction count, whether the address is a contract, Arkham entity metadata (name, type, social links), and any Arkham labels applied to the address.","failureModes":["Payment not provided or insufficient USDC — x402 payment required before data is returned","Invalid or malformed blockchain address — 400 error or empty result","Address not found in Arkham database — empty counterparty arrays returned","Unsupported chain specified — no data for that chain key in response","Rate limiting or quota exceeded — HTTP 429","Network timeout on large address history — truncated or partial response"],"whenToPreferThis":"Use this endpoint when you need labeled, entity-resolved counterparty intelligence for a specific blockchain address — particularly when you want to know which named exchanges, funds, or protocols a wallet has interacted with. Prefer this over raw on-chain RPC calls when you need human-readable entity labels (e.g. 'Binance Cold Wallet') rather than raw addresses. Best suited for due diligence, compliance research, or on-chain forensics where Arkham's proprietary entity graph adds value over generic block explorers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:53:05.739Z","isFirstParty":false}