# Allium Wallet PnL

> Allium Wallet PnL is a paid API for AI agents from Allium at agents.allium.so, paid per call via x402 or MPP, $0.01/call, status unknown (last checked 2026-10-11).

Returns profit and loss data for a given wallet address across onchain positions and trades

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/wallet/pnl?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Allium
- Docs: https://docs.allium.so
- Website: https://allium.so
- Tags: blockchain, prices, tokens, wallet, balances, transactions, pnl, sql, explorer, solana, base, defi, data
- Canonical page: https://www.zero.xyz/c/allium-pnl-0cfbbee1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gXHShxBuABBGqhi3o1fXi

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 allium-pnl-0cfbbee1 -d '<json body>'
```

Example prompt: Can you pull the profit and loss for wallet address 0x1234...abcd on Base — I want to see how much it has made or lost across all its token trades?

## When to prefer this

Choose this endpoint when you need structured, precomputed profit and loss analytics for a specific wallet address on supported chains (Solana, Base) without writing custom SQL. Prefer it over the raw SQL endpoint when PnL is the specific metric needed and speed matters. It is especially useful for DeFi portfolio analysis, trader performance evaluation, and wallet due diligence.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Unsupported chain or network returns a validation error
- Wallet with no transaction history returns empty PnL data
- Insufficient USDC balance for the $0.03 per-call fee results in payment failure
- Timeout or upstream data unavailability returns a 503 or similar server error

## How this service works

Get wallet profit and loss

## Output

Returns a breakdown of realized and unrealized profit and loss for the specified wallet, including per-token position performance, trade history, and aggregate returns across supported chains like Solana and Base.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "chain",
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network (e.g. ethereum, solana, base)"
      },
      "address": {
       "type": "string",
       "description": "Wallet address"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allium-pnl-0cfbbee1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.allium.so](https://www.zero.xyz/host/agents.allium.so/llms.txt)