# Arkham x402 Polymarket Wallet Summary Stats

> Arkham x402 Polymarket Wallet Summary Stats 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 aggregate trading statistics for a given Polymarket wallet address, including total volume, fees, trades, and first activity date.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/wallet/summary/stats
- 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-x402-polymarket-wallet-summary-stats-1f3e0d01
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_COMpxXBzuxMWB2qNa4si8

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-summary-stats-1f3e0d01 -d '<json body>'
```

Example prompt: Can you pull up the full trading summary for the Polymarket wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see total volume, fees, number of trades, and when they first started trading?

## When to prefer this

Use this endpoint when you need a quick, comprehensive aggregate summary of a specific wallet's Polymarket trading history — total volume, fees, trade count, and tenure — in a single call. Prefer this over transaction-level endpoints when you need high-level stats rather than individual trade details, and when on-chain Polymarket data specifically is the target (not general DEX or CEX activity).

## Known failure modes

- Invalid or malformed wallet address returns an error
- Wallet address with no Polymarket activity may return zero values or a not-found error
- Payment failure via x402 protocol blocks the request
- Rate limiting if too many requests are made in a short period
- Network timeout if the Arkham backend is slow to respond

## How this service works

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

## Output

A JSON object containing the wallet's cumulative Polymarket statistics: totalVolume (USD string), totalTrades (integer count), totalEvents (integer count), totalFees (USD string), userAddress (checksummed hex), and firstActiveAt (ISO 8601 timestamp of first trade).

## 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": {
  "totalFees": "24948.9331",
  "totalEvents": 395407,
  "totalTrades": 395407,
  "totalVolume": "89383319.07563",
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684",
  "firstActiveAt": "2025-11-07T00:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-wallet-summary-stats-1f3e0d01/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)