# Tanod utilpeek — Polymarket Prediction Market Search

> Tanod utilpeek — Polymarket Prediction Market Search is a paid API for AI agents from tanod.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Search Polymarket prediction markets by keyword, returning outcome probabilities, trading volume, liquidity, and end dates for matching markets.

## Facts

- Endpoint: POST https://tanod.dev/v1/markets/predictions?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-utilpeek-polymarket-prediction-market-search-b149cdb4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dU3gFiGZg2j8lAFeSolB5

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 tanod-utilpeek-polymarket-prediction-market-search-b149cdb4 -d '<json body>'
```

Example prompt: Search Polymarket for active prediction markets about the 2024 US presidential election, sorted by volume, and show me the top 10 results with their outcome probabilities and liquidity.

## When to prefer this

Use this endpoint when an agent needs structured, real-time prediction market data from Polymarket — specifically outcome probabilities, volume, liquidity, and end dates — for a given topic. Prefer this over general web search when you need machine-readable probability estimates from a live prediction market, rather than news articles or opinion pieces.

## Known failure modes

- Query string too short (<2 chars) or too long (>100 chars) returns validation error
- No markets found for the given query returns an empty result set
- Invalid sort or status enum value returns a 400 bad request
- Payment failure via x402 protocol blocks the request
- Polymarket API unavailability causes upstream timeout or 503

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

Returns a list of matching Polymarket prediction markets, each including the market question, current outcome probabilities (e.g. Yes/No percentages), total trading volume, available liquidity, and the market's end/resolution date. Results are sorted and filtered per the requested parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 100,
     "minLength": 2
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Optional text to search in market titles (2-100 characters). Omit to list markets."
  },
  "sort": {
   "anyOf": [
    {
     "enum": [
      "volume",
      "liquidity",
      "end_date",
      "relevance"
     ],
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "relevance (default with q), volume (default without q), liquidity or end_date."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "description": "Markets returned, 1-25 (default 10)."
  },
  "status": {
   "enum": [
    "active",
    "closed",
    "all"
   ],
   "type": "string",
   "default": "active",
   "description": "active (default), closed or all."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cache": "fetched",
  "count": 1,
  "query": "bitcoin",
  "source": {
   "url": "https://gamma-api.polymarket.com",
   "docs": "https://docs.polymarket.com/developers/gamma-markets-api/overview",
   "name": "Polymarket Gamma API"
  },
  "status": "active",
  "markets": [
   {
    "url": "https://polymarket.com/event/bitcoin-above-on-october-10-2026",
    "event": "Bitcoin above ___ on October 10?",
    "active": true,
    "closed": false,
    "end_date": "2026-10-10T16:00:00Z",
    "outcomes": [
     {
      "name": "Yes",
      "price": 0.9995,
      "probability_pct": 99.95
     },
     {
      "name": "No",
      "price": 0.0005,
      "probability_pct": 0.05
     }
    ],
    "question": "Will the price of Bitcoin be above $74,000 on October 10?",
    "volume_usd": 73361.54,
    "liquidity_usd": 95264.47,
    "volume_24h_usd": 71491.57
   }
  ],
  "sorted_by": "relevance",
  "disclaimer": "Data only, not betting advice. Prices are Polymarket's quoted outcome prices (implied probabilities), may lag, and are not a prediction by Tanod. Prediction markets may be restricted where you live."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-utilpeek-polymarket-prediction-market-search-b149cdb4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)