# Agentbit Wallet Counterparties

> Agentbit Wallet Counterparties is a paid API for AI agents from agentbit.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns a ranked list of counterparties (addresses, names, interaction counts, value flows) from a wallet's most recent ~100 transactions on Base.

## Facts

- Endpoint: POST https://agentbit.app/v1/wallet/counterparties
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentbit-wallet-counterparties-64089fd8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fehLaJqxoK1QnJ8GEV3wC

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 agentbit-wallet-counterparties-64089fd8 -d '<json body>'
```

Example prompt: Who does this Base wallet 0x4395c7e383b7e05665aad7f36ed77c01923dd965 transact with most? Give me the top 10 counterparties ranked by interactions, including how much was sent and received and when they last interacted.

## When to prefer this

Choose this endpoint when you need a quick, ranked relationship map of a Base wallet's recent activity without running full historical indexing. It is ideal for due diligence on unknown addresses, fraud screening, understanding protocol usage patterns, or building a counterparty graph from open chain data. Prefer it over a raw transaction list endpoint when you want aggregated, human-readable counterparty summaries rather than individual transaction records. Note it is a recent-activity sample (~100 txns), not a complete historical graph.

## Known failure modes

- Invalid or malformed EVM address returns an error
- Address with no transactions returns an empty counterparty list
- top parameter out of range (>25 or <1) may return validation error
- Non-Base EVM addresses may return no results since only Base chain is indexed
- Very new wallets with fewer than ~10 transactions may return sparse results
- Network timeouts or upstream RPC issues may result in 5xx errors

## How this service works

Who does this wallet transact with? Recent activity (~100 transactions) aggregated into a ranked counterparty list: address, explorer name where known, interactions in/out, total native value, first/last seen, methods used. The related-wallets answer from open data — honest about being a recent-activity sample.

## Output

A JSON object containing the queried address, network identifier, a note about the sampling window, the number of sampled transactions, the count of unique counterparties found, and an array of ranked counterparty objects each with: address, optional explorer name, sent count, received count, total interactions, total native value in ETH, first seen and last seen ISO-8601 timestamps, and an array of contract methods used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "top": {
   "type": "integer",
   "description": "Max counterparties to return (1-25, default 10)"
  },
  "address": {
   "type": "string",
   "description": "EVM address on Base (0x + 40 hex)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Aggregated from the most recent ~64 native transactions — a recent-activity sample, not a complete relationship graph.",
  "address": "0x4395c7e383b7e05665aad7f36ed77c01923dd965",
  "network": "eip155:8453",
  "counterparties": [
   {
    "name": null,
    "sent": 0,
    "address": "0x14d7809559ef382d292e073f74f5ee86669cf823",
    "methods": [
     "transferWithAuthorization"
    ],
    "received": 40,
    "last_seen": "2026-09-06T09:56:34Z",
    "first_seen": "2026-09-01T10:00:00Z",
    "interactions": 40,
    "total_value_eth": 0
   }
  ],
  "sampled_transactions": 64,
  "unique_counterparties_in_sample": 9
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentbit-wallet-counterparties-64089fd8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbit.app](https://www.zero.xyz/host/agentbit.app/llms.txt)