# Zerion Wallet PnL

> Zerion Wallet PnL is a paid API for AI agents from api.zerion.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns profit and loss (PnL) data for a given EVM or Solana wallet address across DeFi positions

## Facts

- Endpoint: GET https://api.zerion.io/v1/wallets/:address/pnl?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zerion-wallet-pnl-5dc40d03
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ORnd17qapl8aTrG4AUzju

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 zerion-wallet-pnl-5dc40d03
```

Example prompt: Can you pull up the profit and loss summary for my Ethereum wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e using Zerion?

## When to prefer this

Use this endpoint when you specifically need profit and loss metrics for a wallet — not just portfolio balances or token holdings. It is best suited when the user wants performance analytics (gains/losses) rather than a snapshot of current holdings. Prefer this over generic balance endpoints when the question is 'how much has this wallet made or lost?' rather than 'what does this wallet hold?'

## Known failure modes

- Invalid wallet address format returns an error (must be EVM 0x or Solana base58)
- Wallet address with no on-chain history may return empty or null PnL attributes
- Rate limiting or payment failure (x402) if the per-call fee is not settled
- Unsupported chain or address type may return no data
- Network timeout if the Zerion backend is slow to aggregate multi-chain data

## How this service works

DeFi/web3 interactions for agents

## Output

Returns a JSON object with a data field containing the resource ID, resource type, and attributes describing the wallet's profit and loss metrics (such as realized gains, unrealized gains, and overall performance) along with self and pagination links. Full attribute details are documented at developers.zerion.io.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Wallet address (EVM 0x or Solana base58)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data"
     ],
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string",
         "description": "Resource ID."
        },
        "type": {
         "type": "string",
         "description": "Resource type."
        },
        "attributes": {
         "type": "object",
         "description": "Resource attributes; see https://developers.zerion.io"
        }
       }
      },
      "links": {
       "type": "object",
       "description": "Self and pagination links."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zerion-wallet-pnl-5dc40d03/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zerion.io](https://www.zero.xyz/host/api.zerion.io/llms.txt)