{"uid":"cap_vF3FeaneTPPMrIUxmm7xf","slug":"arkham-x402-entity-counterparties-lookup-60b769de","name":"Arkham x402 Entity Counterparties Lookup","description":"Get top Arkham counterparties for an entity. $10.00 per call.","url":"https://api.arkm.com/x402/counterparties/entity","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…"},"entity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The entity ID to query counterparties for."},"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."},"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":1240000000,"flow":"in","chains":["bsc"],"address":{"chain":"bsc","address":"0xE081d4E19D18029Acb1250cDF29Bfd671040f5c7","contract":false,"arkhamLabel":{"name":"\"kyawaung\" on Galxe","address":"0xE081d4E19D18029Acb1250cDF29Bfd671040f5c7","chainType":"evm"},"isUserAddress":false},"transactionCount":1}],"base":[{"usd":107909121.9766097,"flow":"all","chains":["base","ethereum"],"address":{"chain":"base","address":"0x9008D19f58AAbD9eD0D60971565AA8510560ab41","contract":true,"arkhamLabel":{"name":"GPv2Settlement","address":"0x9008D19f58AAbD9eD0D60971565AA8510560ab41","chainType":"evm"},"arkhamEntity":{"id":"cowswap","name":"CoW Protocol","note":"","type":"dex-aggregator","service":null,"twitter":"https://twitter.com/CoWSwap","website":"https://cow.fi"},"isUserAddress":false},"transactionCount":1224},{"usd":1280000000,"flow":"in","chains":["base"],"address":{"chain":"base","address":"0x33929958868F2a7C5bd8123243dDe6D23C5A6c58","contract":false,"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_Lmsj7UxTlQ6ihXFKF4NfM","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 counterparty addresses and transaction flows for a named blockchain entity (wallet intelligence) across multiple chains.","exampleAgentPrompt":"Pull the top counterparties for the 'CoW Protocol' entity on Arkham — I want to see which addresses and chains are sending them the most volume, including flow direction and USD amounts.","exampleUseCases":[{"title":"DeFi protocol counterparty audit","prompt":"Give me the full counterparty breakdown for the Uniswap entity on Arkham — I want to see every address that's been transacting with them, the USD volume, whether it's inbound or outbound, and what chains they're on."},{"title":"Whale wallet transaction tracing","prompt":"Look up the Arkham entity for Binance and show me the top counterparty wallets interacting with them on Ethereum and BSC — I want to know who's moving the biggest amounts in and out."},{"title":"Compliance due-diligence on named entity","prompt":"I need to do a counterparty check on the FTX entity on Arkham — pull all the addresses that transacted with them, including how much USD flowed in versus out and across which chains, so I can flag any suspicious patterns."}],"resultDescription":"A JSON object keyed by chain name (e.g. 'base', 'bsc', 'ethereum'), each containing an array of counterparty records. Each record includes: USD value of transactions, flow direction (in/out/all), list of chains involved, the counterparty address with chain and contract status, optional Arkham label (human-readable name) and Arkham entity metadata (id, name, type, website, twitter), a flag indicating whether it is a user address, and the transaction count.","failureModes":["Unknown entity ID returns empty result or 404","Missing or invalid x402 payment header causes 402 Payment Required","Insufficient USDC balance causes payment failure and no data returned","Entity exists but has no counterparty data on the requested chain returns empty arrays","Rate limiting or authentication errors return 401 or 429","Malformed POST body returns 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need structured, labeled counterparty intelligence for a named blockchain entity (exchange, protocol, whale) with USD volumes and flow directions across multiple chains. Prefer it over raw blockchain explorers when you need Arkham's proprietary entity labeling and aggregation. Best for compliance research, DeFi due diligence, or on-chain investigation workflows where entity-level aggregation is more useful than raw address data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:06.176Z","isFirstParty":false}