# Arkham x402 Entity Counterparties Lookup

> Arkham x402 Entity Counterparties Lookup 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 counterparty addresses and transaction flows for a named blockchain entity (wallet intelligence) across multiple chains.

## Facts

- Endpoint: POST https://api.arkm.com/x402/counterparties/entity
- 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-x402-entity-counterparties-lookup-60b769de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vF3FeaneTPPMrIUxmm7xf

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-x402-entity-counterparties-lookup-60b769de -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## 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…"
  },
  "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": "st
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-entity-counterparties-lookup-60b769de/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)