# Arkham x402 Polymarket Event Positions

> Arkham x402 Polymarket Event Positions 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 wallet-level position data for a specific Polymarket prediction market event, including PnL, shares, outcome, and trader details.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/event-positions
- 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-event-positions-2ac7a39e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JJGA8uWqFECadMMIWNDOC

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-event-positions-2ac7a39e -d '<json body>'
```

Example prompt: Pull all wallet positions for the Polymarket event with condition ID 0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1 — I want to see who holds the most shares, their PnL, and how many trades each has made.

## When to prefer this

Use this endpoint when you need on-chain position-level data for Polymarket prediction market events — specifically to identify which wallets hold positions, their PnL, share counts, and outcomes. Prefer this over generic blockchain explorers when you want structured, pre-aggregated Polymarket position intelligence enriched with Arkham's wallet labeling. Best for agent workflows that analyze market sentiment, track whale behavior, or investigate specific trader exposure on Polymarket events.

## Known failure modes

- Invalid or unknown conditionId returns empty results or 404
- Malformed conditionId hex string causes request error
- Event with no positions returns empty positions array
- Rate limiting or payment failure (x402) if USDC payment not provided
- Network timeout if Arkham backend is slow to respond

## How this service works

Get Arkham Polymarket event positions. $0.60 per call.

## Output

Returns a paginated list of wallet positions for a Polymarket event, each containing the wallet address, outcome bet on (Yes/No), number of shares, current value, PnL, token address, condition ID, total number of trades, and an image URL for the market. Also includes a total count of all positions for the event.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max results (default 50, max 1000)."
  },
  "maxPnl": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. Maximum PnL in whole USD (can be negative)."
  },
  "minPnl": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. Minimum PnL in whole USD (can be negative)."
  },
  "offset": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Offset for pagination (default 0)."
  },
  "sortBy": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. \"pnl\" (default), \"shares\", or \"value\"."
  },
  "outcome": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "positions": [
   {
    "pnl": "225636.626185",
    "price": 0,
    "value": "0",
    "shares": "1043537.710844",
    "outcome": "Yes",
    "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/world-cup-winner-netherlands-flag-20260603-192743.png",
    "question": "Will Netherlands win the 2026 FIFA World Cup?",
    "conditionId": "0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1",
    "totalTrades": 7589,
    "userAddress": "0xB687f00464E33934f5d591F224E71C3559ecAeE5",
    "tokenAddress": "0x7baa312d6393ea83c631fb77b47061651a2a9992c40fcac017009611d6a03df4"
   },
   {
    "pnl": "140074.249191",
    "price": 0,
    "value": "0",
    "shares": "236907.947522",
    "outcome": "Yes",
    "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/world-cup-winner-netherlands-flag-20260603-192743.png",
    "question": "Will Netherlands win the 2026 FIFA World Cup?",
    "conditionId": "0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1",
    "totalTrades": 3025,
    "userAddress": "0xCbBa64CDDD05171925FFD05d8F8ABD38C83fDbFf",
    "tokenAddress": "0x7baa312d6393ea83c631fb77b47061651a2a9992c40fcac017009611d6a03df4"
   }
  ],
  "totalCount": 43343,
  "conditionId": "0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1"
 }
}
```

## More

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