# Arkham x402 - Polymarket Top Events

> Arkham x402 - Polymarket Top Events is a paid API for AI agents from api.arkm.com, paid per call via x402, $2/call, status unknown (last checked 2026-09-14).

Returns a ranked list of top Polymarket prediction market events with associated trader performance metrics and PnL data.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/top-events
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-top-events-66620f4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7j9Ani6gxPgzJfftVLJYL

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-top-events-66620f4f -d '<json body>'
```

Example prompt: Pull the top Polymarket events ranked by period PnL using Arkham's data feed — I want to see which prediction market events and traders are performing best right now.

## When to prefer this

Choose this endpoint when you need ranked, curated Polymarket prediction market event data with trader-level wallet intelligence and PnL metrics in a single call. Prefer this over generic Polymarket APIs when you also want on-chain wallet attribution (Arkham's core strength) tied to market performance. Best suited for agents doing trading research, leaderboard monitoring, or identifying whale activity on prediction markets.

## Known failure modes

- Insufficient USDC balance for x402 payment — request blocked before processing
- Invalid or missing API key — 401 unauthorized response
- Polymarket data temporarily unavailable — upstream data source error
- Malformed POST body — 400 bad request
- Rate limiting if too many requests are made in a short period

## How this service works

Get Arkham Polymarket top events. $2.00 per call.

## Output

Returns a JSON array of ranked prediction market events from Polymarket, each containing rank position, event ID, event title, icon and image URLs, period PnL (in USD), trade count, and the top trader's wallet address associated with that 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 entries (1-200). Default: 100"
  },
  "order": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Sort order: desc (top wins) or asc (top losses). Default: desc"
  },
  "offset": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Pagination offset. Default: 0"
  },
  "period": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Time period: 1d, 1w, 1m, all. Default: 1d"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "rank": 1,
   "eventId": 511447,
   "iconUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer ball-bba4025f77.png",
   "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer ball-bba4025f77.png",
   "periodPnl": "1242863.7688589205",
   "eventTitle": "Belgium vs. IR Iran - More Markets",
   "tradeCount": 3311,
   "userAddress": "0x204f72f35326db932158CBA6AdfF0B9A1DA95e14"
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-top-events-66620f4f/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)