# Polymarket Search API (x402.agentutility.ai)

> Polymarket Search API (x402.agentutility.ai) is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Searches Polymarket prediction markets by question text, description, or slug with optional category, tag, and liquidity filters — returns market data only, no trading.

## Facts

- Endpoint: POST https://x402.agentutility.ai/polymarket-search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-search-api-x402-agentutility-ai-ae04fa8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1bqDDyoO1xuft9FuKJXr2

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-search-api-x402-agentutility-ai-ae04fa8e -d '<json body>'
```

Example prompt: Search Polymarket for prediction markets about the 2024 US presidential election — filter to markets with meaningful liquidity and show me the top results including their questions and slugs.

## When to prefer this

Use this endpoint when an AI agent needs to discover or search Polymarket prediction markets programmatically, especially when filtering by topic, category, tag, or liquidity without needing to place trades or access order books. Prefer over scraping Polymarket directly because it provides a structured, agent-friendly API with USDC micropayment settlement.

## Known failure modes

- No markets found matching query — returns empty results
- Invalid or unsupported filter parameters — may return error or unfiltered results
- Polymarket data unavailability — upstream data fetch failure
- Payment failure via x402 protocol — call not executed
- Rate limiting or quota exceeded — request rejected

## How this service works

Searches Polymarket prediction markets by question, description, and slug over the returned market page, with optional category/tag/liquidity filters. Data-only; no betting, trading, or order execution. Use it as a Polymarket search API or market query endpoint.

## Output

A list of Polymarket prediction markets matching the search criteria, including market questions, descriptions, slugs, category/tag labels, and liquidity data. Results are read-only market data with no order or trade execution.

## 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": {
      "tag": {
       "type": "string",
       "description": "Polymarket tag slug filter, passed through to upstream."
      },
      "limit": {
       "type": "number",
       "description": "1-100. Default 20."
      },
      "query": {
       "type": "string",
       "description": "Free-text filter applied to question, description, and slug."
      },
      "active": {
       "type": "boolean",
       "description": "Default true. Pass false to include inactive markets."
      },
      "closed": {
       "type": "boolean",
       "description": "Default false. Pass true to include closed markets."
      },
      "offset": {
       "type": "number",
       "description": "Pagination offset."
      },
      "category": {
       "type": "string",
       "description": "Filter by Polymarket category substring, e.g. 'Sports', 'Crypto', 'Politics'."
      },
      "min_liquidity": {
       "type": "number",
       "description": "Minimum liquidity in USD."
      }
     }
    },
    "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",
     "properties": {
      "count": {
       "type": "integer"
      },
      "markets": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "slug": {
          "type": "string"
         },
         "question": {
          "type": "string"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "markets": [
   {
    "slug": "will-ai-company-ipo",
    "question": "Will an AI company IPO?"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-search-api-x402-agentutility-ai-ae04fa8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)