# HivemindOS Wallet Token P&L

> HivemindOS Wallet Token P&L is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-28).

Returns realized and unrealized profit and loss broken down by token for a single on-chain wallet, over a specified date range.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/wallets.tokenPnl?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-wallet-token-p-l-2e04143d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F_ChOFj-M2tFQe-KQ27EQ

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-token-p-l-2e04143d -d '<json body>'
```

Example prompt: Can you pull the realized and unrealized profit and loss by token for wallet 0x4f3eD...aB12 on Ethereum, covering January 1 to March 31 2025, sorted by volume descending — I want to see how well they traded before I consider copy-trading them.

## When to prefer this

Use this endpoint when you need per-token realized and unrealized PnL for a specific wallet — especially for copy-trade vetting, whale tracking, or portfolio auditing. Prefer it over generic block explorers when you need structured, computed PnL rather than raw transaction history. It complements the Perp positions endpoint (which covers Hyperliquid perpetuals) by handling spot token trading across EVM and Solana chains.

## Known failure modes

- Invalid or unrecognized wallet address returns an error or empty result
- Unsupported chain name returns a validation error
- Date range with no trading activity returns empty token list
- Payment of $0.05 USDC on Base fails if wallet has insufficient balance or network issue
- Request times out for wallets with extremely high trade counts

## How this service works

Wallet profit and loss by token: one wallet's realized and unrealized profit and loss for each token it traded. Use when an agent needs to know how well a wallet has traded each token before following it. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A structured list of tokens the wallet has traded, each with realized PnL, unrealized PnL, trade volume, and related metrics for the specified date window. Results can be sorted by volume or PnL fields as specified.

## 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."
  },
  "orderBy": {
   "type": "array",
   "maxItems": 3,
   "description": "Optional sort, e.g. [{ field: \"volume\", direction: \"DESC\" }]."
  },
  "request": {
   "type": "string",
   "maxLength": 2000,
   "description": "The read in plain words, naming the address, $SYMBOL, chain or exchange."
  },
  "tokenAddress": {
   "type": "string",
   "description": "EVM address (0x…) or Solana address."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-wallet-token-p-l-2e04143d/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)