# Arkham Counterparties by Address

> Arkham Counterparties by Address is a paid API for AI agents from api.arkm.com, paid per call via x402, $10/call, status unknown (last checked 2026-09-14).

Returns the top counterparty wallets (with entity labels, USD flow, and transaction counts) for a given blockchain address, paid per-request via x402.

## Facts

- Endpoint: POST https://api.arkm.com/x402/counterparties/address
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-counterparties-by-address-01929abb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2XUgy9FT5sV3lSe1SyhID

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability arkham-counterparties-by-address-01929abb -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get top Arkham counterparties for an address. $10.00 per call.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-counterparties-by-address-01929abb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)