# Polymarket Market Search

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

Searches active Polymarket prediction markets by keyword, returning top matches sorted by 24h volume with prices, probabilities, liquidity, and CLOB token IDs.

## Facts

- Endpoint: POST https://agent402.tools/api/polymarket-search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-market-search-0d4ba162
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oIt-ekBEderAhXWAQOXBO

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-search-0d4ba162 -d '<json body>'
```

Example prompt: Search Polymarket for active markets about the 2024 US presidential election and show me the top 5 results sorted by volume, including current odds and liquidity.

## When to prefer this

Use this endpoint when you need to discover and evaluate Polymarket prediction markets by topic or keyword, especially when you want current implied probabilities and liquidity metrics sorted by recent trading activity. Ideal for agents building trading strategies, monitoring event probabilities, or surfacing relevant markets for a given news topic. Prefer this over manual Polymarket browsing when you need CLOB token IDs for subsequent orderbook queries.

## Known failure modes

- No markets found for obscure or misspelled keywords — returns empty results
- Query too broad returns irrelevant markets ranked by volume
- Market data may be stale if Polymarket API is slow or rate-limited
- Limit parameter outside 1-50 range may cause validation error
- Payment failure (402) if USDC balance insufficient for $0.002 call cost

## How this service works

Search active Polymarket markets by keyword. Returns the top matches sorted by 24h volume, with question, current outcome prices (implied probabilities), volume, liquidity, end date, and CLOB token ids for orderbook lookups.

## Output

Returns a ranked list of matching Polymarket markets (up to the requested limit), each with the market question, current outcome prices as implied probabilities, 24-hour trading volume, available liquidity, market end date, and CLOB token IDs that can be used for orderbook lookups.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Max markets to return (1-50, default 10)."
  },
  "query": {
   "type": "string",
   "description": "Keyword to search market questions, slugs, and descriptions."
  },
  "activeOnly": {
   "type": "boolean",
   "description": "Filter to active+open markets only (default true)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "election",
  "source": "polymarket-gamma",
  "markets": [
   {
    "id": "12345",
    "slug": "will-x-win-election",
    "venue": "polymarket",
    "active": true,
    "closed": false,
    "prices": [
     0.62,
     0.38
    ],
    "volume": 1234567.89,
    "endDate": "2026-11-03T23:59:00Z",
    "outcomes": [
     "Yes",
     "No"
    ],
    "question": "Will X win the election?",
    "venueUrl": "https://polymarket.com/market/will-x-win-election",
    "clobTokenIds": [
     "7290..."
    ]
   }
  ],
  "scannedMarkets": 57,
  "searchExhausted": false,
  "searchedKeywordIndex": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-market-search-0d4ba162/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)