# Search Polymarket

> Search Polymarket is a paid API for AI agents from ZeroClick x402 Service Registry at polymarket.withzero.ai, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-12).

Search Polymarket prediction markets to retrieve events, current odds, trading volume, and liquidity for any topic.

## Facts

- Endpoint: POST https://polymarket.withzero.ai/run?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 1
- Provider: ZeroClick x402 Service Registry
- Website: https://withzero.ai
- Tags: search, polymarket, prediction, markets, odds, betting
- Canonical page: https://www.zero.xyz/c/zeroclick-x402-service-registry-search-polymarket-73256026
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OKrLnmUqu3Pe0t9NMhneY

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 zeroclick-x402-service-registry-search-polymarket-73256026 -d '<json body>'
```

Example prompt: Search Polymarket for prediction markets related to Federal Reserve interest rate decisions in the last 30 days and show me the top 10 results with current odds and volume.

## When to prefer this

Use this endpoint when you need real-time crowd-sourced probability estimates on any event — political, financial, sports, or geopolitical. Prefer this over general web search when you specifically want quantified odds and market depth rather than news articles. Best for questions like 'what is the current probability of X happening' backed by real money markets.

## Known failure modes

- No results found for niche or very specific queries — returns empty results array
- Query too broad returns unrelated markets with low relevance scores
- Days parameter outside 1-90 range returns a validation error
- Polymarket data may be stale if markets haven't been recently updated
- Network timeout if Polymarket backend is slow or unavailable

## How this service works

Search Polymarket prediction markets for events, odds, and market data (free, no key needed). Input: search query. Output: events with current odds, volume, and liquidity.

## Output

A list of Polymarket events matching the query, each including the event title, a direct URL to the market, the top market question with current Yes/No odds percentages, trading volume (mapped as likes), current liquidity (mapped as views), last updated date, and a combined relevance and engagement score from 0 to 100. Also returns the total result count and source platform name.

## Example request

```json
{
 "days": 30,
 "limit": 20,
 "query": "artificial intelligence"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "days": {
   "type": "integer",
   "default": 30,
   "maximum": 90,
   "minimum": 1,
   "description": "How many days back to search (default: 30)"
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum results to return (default: 20)"
  },
  "query": {
   "type": "string",
   "description": "Search topic or keywords"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "source",
  "resultCount",
  "results"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "The query that was searched"
  },
  "source": {
   "type": "string",
   "description": "Platform name"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "title",
     "url",
     "author",
     "date",
     "score",
     "engagement",
     "snippet"
    ],
    "properties": {
     "url": {
      "type": "string",
      "description": "Direct link to the Polymarket event"
     },
     "date": {
      "type": "string",
      "description": "Last updated date (ISO 8601)"
     },
     "score": {
      "type": "number",
      "description": "Combined relevance + engagement score (0-100)"
     },
     "title": {
      "type": "string",
      "description": "Event title"
     },
     "author": {
      "type": "string",
      "description": "Platform name (always \"Polymarket\")"
     },
     "snippet": {
      "type": "string",
      "description": "Top market question with current odds"
     },
     "engagement": {
      "type": "object",
      "properties": {
       "likes": {
        "type": "number",
        "description": "Total volume (mapped from volume)"
       },
       "views": {
        "type": "number",
        "description": "Current liquidity (mapped from liquidity)"
       }
      },
      "description": "Engagement metrics",
      "additionalProperties": false
     }
    },
    "additionalProperties": false
   }
  },
  "resultCount": {
   "type": "number",
   "description": "Number of results returned"
  }
 },
 "additionalProperties": false
}
```

## More

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