# Polymarket Market Scan

> Polymarket Market Scan is a paid API for AI agents from tollbooth.memerhuwhite.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Scans Polymarket prediction markets to identify bundle violations and resolution candidates using the Polymarket Gamma API

## Facts

- Endpoint: POST https://tollbooth.memerhuwhite.workers.dev/paid/polymarket/market-scan
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-market-scan-69d13b8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bjBUicKR2b6MgunfApqth

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 polymarket-market-scan-69d13b8b -d '<json body>'
```

Example prompt: Scan the top 100 Polymarket prediction markets and tell me which ones have bundle violations and which are candidates for resolution right now.

## When to prefer this

Use this endpoint when you need to programmatically audit Polymarket prediction markets for compliance issues (bundle violations) or identify markets that are candidates for resolution. Prefer this over manual Polymarket browsing when you want structured, machine-readable output for automated workflows or when monitoring markets at scale. Especially useful for market makers, resolvers, or compliance monitors operating on Polymarket.

## Known failure modes

- Polymarket Gamma API unavailable or rate-limited — returns upstream error
- Invalid request body parameters — returns 400 error
- Payment not processed — x402 payment required error
- No markets found matching scan criteria — returns empty violation and candidate arrays
- Timeout if scanning large market sets

## How this service works

100+ paid x402 MCP tools for AI agents. Prediction markets, SEC filings, federal data, OSINT, academic research, health, environmental. Pay per call in USDC on Base.

## Output

Returns a JSON object with the data source ('Polymarket Gamma API'), the number of markets scanned, a list of bundle violations found (market identifiers and violation details), and a list of resolution candidates (markets that appear ready to be resolved).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 200,
       "minimum": 10
      },
      "min_edge": {
       "type": "number",
       "maximum": 0.5,
       "minimum": 0
      },
      "min_certainty": {
       "type": "number",
       "maximum": 1,
       "minimum": 0.5
      },
      "min_liquidity": {
       "type": "number",
       "minimum": 0
      },
      "min_volume_24h": {
       "type": "number",
       "minimum": 0
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "Polymarket Gamma API",
  "markets_scanned": 100,
  "bundle_violations": [],
  "resolution_candidates": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-market-scan-69d13b8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tollbooth.memerhuwhite.workers.dev](https://www.zero.xyz/host/tollbooth.memerhuwhite.workers.dev/llms.txt)