# AgentToll Polymarket Event Scan

> AgentToll Polymarket Event Scan is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Fetches detailed data for a specific Polymarket prediction market event by slug, with optional filtering by edge and liquidity thresholds.

## Facts

- Endpoint: POST https://agenttoll.dev/paid/polymarket/event-scan
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-polymarket-event-scan-61fed307
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AWZ3v9iL523N4-29z1MqC

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 agenttoll-polymarket-event-scan-61fed307 -d '<json body>'
```

Example prompt: Can you pull the Polymarket event data for the 'democratic-presidential-nominee-2028' slug and filter for markets with at least $10,000 in liquidity and a minimum edge of 0.05?

## When to prefer this

Use this endpoint when you need structured, programmatic access to a specific Polymarket event's data by its slug, especially when you want to filter by liquidity or edge thresholds for trading or research decisions. Prefer this over manual Polymarket browsing when building automated agents that need to evaluate prediction market opportunities. This is the right choice when you already know the event slug and need detailed metadata from the Gamma API without scraping the Polymarket UI.

## Known failure modes

- Invalid or non-existent slug returns empty or error response
- Slug shorter than 2 characters is rejected by schema validation
- min_edge value above 0.5 is rejected by schema validation
- Payment failure in USDC/x402 prevents the call from completing
- Polymarket Gamma API downtime causes upstream failure

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns a JSON object containing event metadata sourced from the Polymarket Gamma API, including the event slug, any violation flags on the event, and associated market data. Optional fields may include liquidity and edge details depending on filter parameters.

## 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": {
     "required": [
      "slug"
     ],
     "properties": {
      "slug": {
       "type": "string",
       "minLength": 2
      },
      "min_edge": {
       "type": "number",
       "maximum": 0.5,
       "minimum": 0
      },
      "min_liquidity": {
       "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": {
  "event": {
   "violation": null,
   "event_slug": "democratic-presidential-nominee-2028"
  },
  "source": "Polymarket Gamma API"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-polymarket-event-scan-61fed307/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)