# HivemindOS Related Wallets

> HivemindOS Related Wallets is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.2/call, status unknown (last checked 2026-10-28).

Returns wallets linked to a given address by funding and transfers, its largest counterparties, balance history, and large transactions — useful for identifying team wallets or sybil clusters.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/wallets.related?utm_source=zero.xyz
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-related-wallets-aab00465
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hG4U3Y_-9nhqRRH1FsQvb

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 hivemindos-related-wallets-aab00465 -d '<json body>'
```

Example prompt: Can you find all wallets linked to 0x1234...abcd on Ethereum — show me related wallets by funding and transfers, their largest counterparties, and include any large transactions from the past 30 days?

## When to prefer this

Use this endpoint when you need to map onchain wallet relationships — specifically to find wallets linked by funding flows or transfers, detect sybil clusters, or trace a team's wallet network. Prefer this over generic blockchain explorers when you need structured, agent-ready output with counterparty and balance context in a single call.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain name results in a rejection
- Date range too broad may return empty or truncated results
- Address with no onchain activity may return empty related wallets
- Payment failure (insufficient USDC on Base) prevents the call from completing

## How this service works

Related wallets: wallets linked to one wallet by funding and transfers, its largest counterparties, balance history and large transactions. Use when an agent needs the wallets linked to one address, e.g. to spot a team's other wallets or sybil clusters. $0.20 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A structured response including: a list of wallets linked to the queried address via funding and transfers, the largest counterparties of the address, and optionally the address's balance history and largest transactions over the specified date window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "object",
   "required": [
    "from",
    "to"
   ],
   "properties": {
    "to": {
     "type": "string",
     "format": "date"
    },
    "from": {
     "type": "string",
     "format": "date"
    }
   },
   "description": "The window to read, as YYYY-MM-DD dates. Defaults to recent days."
  },
  "chain": {
   "type": "string",
   "description": "Chain name, such as base, ethereum or solana."
  },
  "address": {
   "type": "string",
   "description": "EVM address (0x…) or Solana address."
  },
  "filters": {
   "type": "object",
   "description": "Optional narrowing, such as a minimum USD value or market cap."
  },
  "request": {
   "type": "string",
   "maxLength": 2000,
   "description": "The read in plain words, naming the address, $SYMBOL, chain or exchange."
  },
  "includeTransactions": {
   "type": "boolean",
   "description": "Also return large transactions."
  },
  "includeHistoricalBalances": {
   "type": "boolean",
   "description": "Also return balance history."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-related-wallets-aab00465/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hivemindos.app](https://www.zero.xyz/host/api.hivemindos.app/llms.txt)