# Arkham x402 Polymarket Top Events Breakdown

> Arkham x402 Polymarket Top Events Breakdown 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 breakdown of top Polymarket prediction market events with associated markets and wallet-level participation data.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/top-events-breakdown
- 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-top-events-breakdown-d28c2abc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OirbcAGualJfavgQsW5cD

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-breakdown-d28c2abc -d '<json body>'
```

Example prompt: Pull up the Arkham breakdown for Polymarket event 30615 — I want to see which markets are under that event and what wallet activity looks like for address 0xBDDF61Af533fF524D27154e589d2D7A81510C684.

## When to prefer this

Choose this endpoint when you need on-chain wallet-attributed intelligence about Polymarket events specifically — combining prediction market data with Arkham's blockchain analytics. Prefer this over generic Polymarket APIs when wallet identity, attribution, or cross-referencing with on-chain behavior is needed. Best suited for agents doing DeFi research, whale tracking, or prediction market analytics.

## Known failure modes

- Invalid or unknown eventId returns empty markets array
- Invalid Ethereum address format for userAddress causes request failure
- Insufficient USDC balance for x402 payment results in 402 Payment Required
- Rate limiting or API key issues return 401/403 errors
- Event not yet indexed by Arkham returns incomplete or null data

## How this service works

Get Arkham Polymarket top event breakdown. $0.40 per call.

## Output

Returns a JSON object containing the eventId, eventTitle, an array of markets associated with the event, and a userAddress representing the wallet being analyzed — providing a structured breakdown of Polymarket event participation and market composition.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "period": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Period: 1d, 1w, 1m, all. Default: 1d."
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Polymarket trader address."
  },
  "eventId": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Polymarket event ID."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eventId": 30615,
  "markets": [],
  "eventTitle": "World Cup Winner ",
  "userAddress": "0xBDDF61Af533fF524D27154e589d2D7A81510C684"
 }
}
```

## More

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