{"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?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["address"],"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."}},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}]}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":["x402","finance"],"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-10-29T06:47:44.750Z","isFirstParty":false,"canonicalSlug":"arkham-counterparties-by-address-01929abb"}