# Polymarket Search – Crypto Prediction Market Data

> Polymarket Search – Crypto Prediction Market Data is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-02).

Search Polymarket prediction markets by keyword and retrieve event odds, liquidity, volume, and contestedness for crypto and macro topics

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/v1/pm/markets/search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-search-crypto-prediction-market-data-bcab8a4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5GNTYxvF2ShpCUb7Qc2pN

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-crypto-prediction-market-data-bcab8a4b
```

Example prompt: Search Polymarket for Bitcoin price prediction events, show me up to 10 events with 6 markets each, including odds, liquidity, and which ones are most contested right now.

## When to prefer this

Use this endpoint when an AI agent needs real-time Polymarket prediction market probabilities for crypto or macro topics without managing API keys. Ideal for trading agents that want to gauge market sentiment via prediction market odds, check contestedness, or compare liquidity across events. Prefer over direct Polymarket API access when you need pay-per-call pricing via USDC micropayments with no subscription overhead.

## Known failure modes

- No events found for obscure or misspelled keywords — returns empty events array
- Payment failure if USDC balance is insufficient for x402 micropayment
- Rate limiting or worker timeout on the Cloudflare edge if query is too broad
- Stale data if Polymarket hasn't updated recently — check updated_at field
- Invalid query parameter types (e.g. non-integer limit) may return 400 error

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

Returns a list of Polymarket events matching the search keyword, each with event title, URL, end date, total liquidity, and 24h volume. Each event includes individual market questions with yes/no probabilities, best bid/ask prices, 24h price change, liquidity, volume, and a contested flag. Also returns the top contested market overall and metadata like source and update timestamp.

## 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",
     "properties": {
      "q": {
       "type": "string",
       "examples": [
        "bitcoin",
        "ethereum",
        "fed rate",
        "election"
       ],
       "maxLength": 80,
       "description": "Search keyword (default crypto)"
      },
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Events to return (default 8)"
      },
      "markets": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Markets per event (default 6)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "q": "bitcoin",
  "events": [
   {
    "url": "https://polymarket.com/event/bitcoin-above-on-october-30",
    "title": "Bitcoin above ___ on October 30?",
    "markets": [
     {
      "no_prob": 0.38,
      "best_ask": 0.63,
      "best_bid": 0.61,
      "question": "Will the price of Bitcoin be above $80,000 on October 30?",
      "yes_prob": 0.62,
      "change_1d": 0.05,
      "contested": true,
      "liquidity": 50000,
      "volume_24h": 41000,
      "outcome_label": "80,000"
     }
    ],
    "end_date": "2026-10-30T16:00:00Z",
    "liquidity": 610000,
    "volume_24h": 281751.88
   }
  ],
  "source": "polymarket",
  "n_events": 1,
  "updated_at": "2026-10-29T15:30:00Z",
  "top_contested": {
   "event": "Bitcoin above ___ on October 30?",
   "question": "Will the price of Bitcoin be above $80,000 on October 30?",
   "yes_prob": 0.62,
   "volume_24h": 41000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-search-crypto-prediction-market-data-bcab8a4b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)