# Arkham Polymarket Wallet PnL Summary

> Arkham Polymarket Wallet PnL Summary is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-15).

Returns a Polymarket wallet's profit/loss summary including total PnL, realized PnL, markets won, total markets, unique markets, and deployed capital.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/wallet/summary/pnl
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-polymarket-wallet-pnl-summary-a5bc1605
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_emhsRGLxQuDHq3EMG7Ujx

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 arkham-polymarket-wallet-pnl-summary-a5bc1605 -d '<json body>'
```

Example prompt: Pull the Polymarket PnL summary for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see total PnL, realized PnL, how many markets they've won, and how much capital they've deployed.

## When to prefer this

Use this endpoint when you need a comprehensive PnL and performance summary for a specific Polymarket wallet address. It is ideal for evaluating trader profitability, researching prediction market whales, or building leaderboards. Prefer this over general blockchain explorers when you need Polymarket-specific metrics like marketsWon, uniqueMarkets, and deployedCapital in a single structured response.

## Known failure modes

- Invalid or non-existent wallet address returns empty or error response
- Wallet has no Polymarket activity — returns zero values across all fields
- Payment failure or insufficient USDC balance via x402 results in 402 Payment Required
- Rate limiting or API key issues return 401/403 errors
- Malformed request body causes 400 Bad Request

## How this service works

Get Arkham Polymarket wallet PnL summary. $0.40 per call.

## Output

Returns a JSON object with the wallet's Polymarket performance metrics: totalPnl (all-time net profit/loss), realizedPnl (locked-in gains/losses), marketsWon (number of markets resolved in favor of the user), marketsTotal (total markets entered), uniqueMarkets (distinct market contracts interacted with), deployedCapital (total USDC deployed across all markets), and userAddress (the queried wallet address).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "addr": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Required. Polymarket trade address (0x + 40 hex chars)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "totalPnl": "1112457.739498369",
  "marketsWon": 700,
  "realizedPnl": "1108849.771518",
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684",
  "marketsTotal": 1435,
  "uniqueMarkets": 1348,
  "deployedCapital": "84658193.540001"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-polymarket-wallet-pnl-summary-a5bc1605/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)