# Arkham x402 – Polymarket Wallet Prediction History

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

Retrieves the full Polymarket prediction market trading history for a given wallet address, including PnL, volume, and resolved market outcomes.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/wallet/prediction-history
- Price: $0.6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-wallet-prediction-history-2c1faf93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S5TpQwLZvGYL_C1WeM3Y-

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-x402-polymarket-wallet-prediction-history-2c1faf93 -d '<json body>'
```

Example prompt: Pull up the full Polymarket prediction history for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see their PnL, total volume, which markets they traded, and how the resolved ones turned out.

## When to prefer this

Use this endpoint when you need granular Polymarket trading history tied to a specific on-chain wallet address, including resolved PnL and per-market breakdowns. Prefer this over generic Polymarket APIs when you also need Arkham's wallet intelligence context or when paying per-request via x402 is acceptable. Best for investigative, research, or copy-trading use cases where depth of history per wallet matters.

## Known failure modes

- Invalid or unrecognized wallet address returns empty results or an error
- Wallet with no Polymarket activity returns empty markets array with totalCount 0
- Insufficient USDC payment (x402) causes request to be rejected before processing
- Rate limiting if too many requests are made in quick succession
- Pagination edge cases if totalCountExact is false for very large histories

## How this service works

Get Arkham Polymarket wallet prediction history. $0.60 per call.

## Output

Returns a paginated list of Polymarket markets the wallet has traded in, each including PnL, total buy/sell USDC volume, net shares, average buy and sell prices, outcome bet on, resolution timestamp, event title, question text, condition ID, token address, and image URL. Also includes total count and a hasMore flag for pagination.

## 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)."
  },
  "sort": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Sort field: value, volume, currentPrice, trades, pnl, shares, buyUsd, avgBuy, sellUsd, avgSell. Default: pnl. When stat…"
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Results per page (1-100, default 20)."
  },
  "order": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Sort order: asc or desc. Default: desc."
  },
  "maxPnl": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Maximum PnL in whole USD (can be negative)."
  },
  "minPnl": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hasMore": true,
  "markets": [
   {
    "pnl": "643126.136941",
    "value": "0",
    "volume": "332768.337261",
    "eventId": 401638,
    "outcome": "No",
    "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/Repetitive-markets/premier+league.jpg",
    "question": "Will Chelsea FC win on 2026-05-04?",
    "netShares": "0",
    "eventTitle": "Chelsea FC vs. Nottingham Forest FC",
    "isResolved": true,
    "resolvedAt": "2026-05-04T20:20:48Z",
    "sharesHeld": "0",
    "avgBuyPrice": "0.34098803308944694087",
    "conditionId": "0x0433839be2e0889423ff0a0efae939272899d09c284d309b346d3991d003c4c0",
    "totalTrades": 71,
    "avgSellPrice": "1.00000000000000000000",
    "currentPrice": "1",
    "tokenAddress": "0x5f10f068a11aa7c2f4244d8d71bcfd1ad3f2ed337d916960eb2a660ad380f892",
    "totalBuyUsdc": "332768.337261",
    "totalSellUsdc": "975894.474202",
    "groupItemTitle": "Chelsea FC"
   }
  ],
  "totalCount": 1435,
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684",
  "totalCountExact": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-wallet-prediction-history-2c1faf93/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)