# Polymarket Free-Text Prediction Market Search

> Polymarket Free-Text Prediction Market Search is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Search open Polymarket prediction markets by free text and return live odds, bid/ask spread, volume, liquidity, and event links as flat JSON

## Facts

- Endpoint: GET https://x402.ottoai.services/pm-search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-free-text-prediction-market-search-343c455a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XHrNDP5GwtYcNPdmbOUkd

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-free-text-prediction-market-search-343c455a
```

Example prompt: What are the current Polymarket odds on the Fed cutting rates before end of year? Search for open prediction markets about Fed rate cuts and show me the live probabilities, spread, and volume.

## When to prefer this

Choose this endpoint when you need to search Polymarket by arbitrary free-text topic rather than browsing top-volume markets; it is 5x cheaper than comparable prediction market search APIs and returns richer metadata (spread, liquidity, bid/ask) in a single flat JSON response without needing to parse nested structures.

## Known failure modes

- Empty results if no open markets match the query string
- Stale odds if Polymarket data feed is delayed
- HTTP 402 if USDC payment is not provided or fails
- HTTP 400 if the required 'query' parameter is missing
- Results may not include recently created markets if index hasn't refreshed

## How this service works

Search Polymarket prediction markets by free text: elections, Fed rates, crypto prices, sports, geopolitics, AI. Returns the top matching open markets with live odds (outcome probabilities), best bid/ask, spread, volume, liquidity, end date and event link as flat JSON. Prediction market search, event odds lookup, "what are the odds of X". $0.001 per call — 5x cheaper than comparable PM search.

## Output

A flat JSON object with status, meta (freshness timestamp), and data containing the top matching open prediction markets — each with market name, outcome probabilities, best bid, best ask, spread, volume, liquidity, end date, and a direct Polymarket event link.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "Free-text search across open prediction markets (e.g. \"fed rate cut\", \"bitcoin 150k\", \"world cup\")"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "status"
     ],
     "properties": {
      "data": {},
      "meta": {
       "type": "object"
      },
      "reason": {
       "type": "string",
       "description": "status=unavailable only; every >=400 is UNCHARGED"
      },
      "status": {
       "enum": [
        "success",
        "unavailable"
       ],
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": "fed rate cut",
   "venue": "polymarket",
   "markets": [],
   "matchCount": 4,
   "generatedAt": "2026-07-10T12:00:00.000Z"
  },
  "meta": {
   "degraded": false,
   "validUntil": "",
   "generatedAt": "",
   "stalenessSec": 0
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-free-text-prediction-market-search-343c455a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ottoai.services](https://www.zero.xyz/host/x402.ottoai.services/llms.txt)