# Arkham x402 – Polymarket Events

> Arkham x402 – Polymarket Events 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-14).

Fetches a paginated list of Polymarket prediction market events with pricing, volume, and resolution data via pay-per-request.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/events
- Price: $0.6/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-events-e245d108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iF8XF3rI_yih_cA_pstSg

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-events-e245d108 -d '<json body>'
```

Example prompt: Pull me the top 50 active Polymarket events right now — I want to see their current yes prices, 24-hour USDC volume, and which ones are still open for trading.

## When to prefer this

Choose this endpoint when you need structured, programmatic access to Polymarket prediction market events — especially when you want real-time yes/no prices, 24h volume, and event metadata at scale. Prefer this over scraping Polymarket directly or using public frontends when you need clean JSON, pagination, and reliable data freshness. The x402 pay-per-request model makes it cost-effective for on-demand queries without a subscription commitment.

## Known failure modes

- Payment failure or insufficient USDC balance (x402 payment required per call)
- Invalid or missing API key returns authentication error
- Malformed request body returns 400 error
- Offset or limit out of range returns empty results or error
- Downstream Polymarket data unavailability causes stale or partial response
- Rate limiting if too many requests issued in rapid succession

## How this service works

Get Arkham Polymarket events. $0.60 per call.

## Output

Returns a JSON object containing a paginated list of Polymarket events, each with fields including event ID, slug, title, active/closed/ended/live flags, end date, description, resolution criteria, yes price, 24h USDC volume, 24h price change, market count, and image URLs. Also includes total count and offset for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tag": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. Filter by event tag. Matches lowercase Polymarket tags case-insensitively."
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max events to return (1-100). Default: 50."
  },
  "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."
  },
  "active": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. Filter to active events — not closed and not ended (true/false)."
  },
  "offset": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Pagination offset. Default: 0."
  },
  "search": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "limit": 50,
  "events": [
   {
    "live": false,
    "slug": "will-trump-be-in-the-wc-champions-photo-20260608152527021",
    "ended": false,
    "title": "Will Trump be in the WC Champions Photo?",
    "active": true,
    "closed": false,
    "endDate": "2026-07-20T03:59:00Z",
    "eventId": 572993,
    "iconUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-trump-be-in-the-wc-champions-photo-20260608152527021-eJaeDFLpXz06.jpg",
    "imageUrl": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-trump-be-in-the-wc-champions-photo-20260608152527021-eJaeDFLpXz06.jpg",
    "restricted": true,
    "description": "This market will resolve to “Yes” if Donald Trump is visibly in the frame for the winning team's official team photo following the 2026 FIFA World Cup Final. Otherwise, this market will resolve to “No”.\n\nIf Trump does not attend the 2026 FIFA World Cup Final, this market will resolve to “No”.\n\nIf the 2026 FIFA World Cup Final is cancelled or postponed beyond August 2, 2026, 11:59 PM ET, this market will resolve to “No”.\n\nThe resolution source for this market will be a consensus of credible reporting.",
    "marketCount": 1,
    "volume24hUsdc": "5044026.311715",
    "marketPreviews": [
     {
      "outcomes": [
       "Yes"
      ],
      "question": "Will Trump be in the WC Champions Photo?",
      "resolved": false,
      "yesPrice": 0.9975,
      "conditionId": "0xc0b7319f73f248310b059c231fb069e64dbd68ca81dd9933728ca192b54c3cc4",
      "volume24hUsdc": "5044026.311715",
      "yesPriceChange24h": 0.005000000000000115
     }
    ],
    "volume24hChangePct": 11.94696504405238
   }
  ],
  "offset": 0,
  "totalCount": 717583
 }
}
```

## More

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