# HivemindOS Wallet Profile (Brief)

> HivemindOS Wallet Profile (Brief) is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-30).

Returns a comprehensive profile of a single onchain wallet including token balances, DeFi positions, realized PnL, top counterparties, and related wallets.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/wallets.brief?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-wallet-profile-brief-12174419
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eNlVxRm948L3VAa9dplOl

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-wallet-profile-brief-12174419 -d '<json body>'
```

Example prompt: Can you give me a full profile of the Ethereum wallet 0xABC123... — I want to see its current balances, DeFi positions, realized PnL, and who its biggest counterparties are over the last 30 days?

## When to prefer this

Choose this endpoint when you need a holistic, single-call snapshot of a wallet — balances, PnL, DeFi positions, and counterparties together — rather than querying each data type separately. Prefer it for pre-trade due diligence, trust assessment, or research reporting workflows where breadth matters more than depth on any single metric. If you only need DeFi positions, use the dedicated Wallet DeFi Positions endpoint; if you only need counterparty graphs, use the Related Wallets endpoint.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain name causes a bad request response
- No activity found in the specified date range returns empty fields
- Payment of 0.10 USDC on Base fails or is insufficient — call is not charged on failure
- Date range too wide may result in truncated or partial data
- Solana vs EVM address mismatch with the specified chain returns an error

## How this service works

Wallet profile: one wallet's balances, DeFi positions, realized profit and loss, top counterparties and related wallets. Use when an agent needs to profile a wallet (holdings, profit and loss, counterparties) before copying, trusting or reporting on it. $0.10 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

Returns a structured brief containing the wallet's current token balances, active DeFi positions (lending, borrowing, liquidity, staking), realized profit and loss over the requested window, a ranked list of top counterparties by volume, and linked or related wallet addresses. Optionally includes recent transaction history.

## 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."
  },
  "request": {
   "type": "string",
   "maxLength": 2000,
   "description": "The read in plain words, naming the address, $SYMBOL, chain or exchange."
  },
  "includeTransactions": {
   "type": "boolean",
   "description": "Also return recent transactions."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-wallet-profile-brief-12174419/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)