# ChainHilt Polymarket Prediction Markets Search

> ChainHilt Polymarket Prediction Markets Search is a paid API for AI agents from chainhilt.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-17).

Search and paginate Polymarket prediction markets with filters for status, liquidity, volume, closing time, and free-text query

## Facts

- Endpoint: GET https://chainhilt.ai/api/v1/predict/polymarket/markets/search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainhilt-polymarket-prediction-markets-search-445723ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3-aiy3e1XapPu0uNvWDRH

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 chainhilt-polymarket-prediction-markets-search-445723ad
```

Example prompt: Find open Polymarket prediction markets about the Fed interest rate decision, sorted by soonest closing time, and show me the top 10 results with their current Yes/No prices.

## When to prefer this

Use this endpoint when you need to discover or enumerate Polymarket prediction markets programmatically — especially when searching by topic, filtering by closing time window (e.g. short-horizon markets), or sorting by liquidity/volume. Prefer over generic web search when you need structured market data including prices, liquidity, and resolution rules. The closingAfter/closingBefore filters are essential for finding time-bound markets like 5-minute crypto slots that text search cannot surface.

## Known failure modes

- 400 Bad Request: invalid query string, malformed cursor, or invalid ISO 8601 date in closingAfter/closingBefore
- 502 Bad Gateway: upstream Polymarket venue failure or timeout
- Empty page with nextCursor present: post-fetch filters eliminated results but more pages exist — caller must continue paging
- Short pages: filters (minLiquidity, minVolume24h, tradable) apply after fetching limit rows, so returned count may be less than limit

## How this service works

Search prediction markets. `closingAfter`/`closingBefore` bound the venue query; other filters apply after fetching `limit` rows, so a page can be short or empty while `nextCursor` is set: keep paging until it is absent. `sort=closingTime` lists open markets closing soonest; with `closingBefore` it finds short-horizon markets such as the 5-minute crypto up/down slots, which text `query` search never returns. Errors: 400 invalid query or cursor, 502 venue failure.

## Output

Returns a paginated list of Polymarket prediction market objects, each including market ID, question text, outcome names with current prices and token IDs, status, closing time, liquidity in USD, 24-hour volume, resolution rules and source, condition ID, tick size, and minimum order size. Includes a nextCursor field for pagination when more results exist.

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "sort": {
       "enum": [
        "relevance",
        "liquidity",
        "volume24h",
        "closingTime"
       ],
       "type": "string",
       "description": "Order: relevance (default), liquidity, volume24h, or closingTime (soonest first)."
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 100,
       "minimum": 1,
       "description": "Markets fetched per page (1-100, default 20); filters apply after the fetch."
      },
      "query": {
       "type": "string",
       "minLength": 1,
       "description": "Free-text search; returns one page with no `nextCursor`. Omit to list markets by `sort`."
      },
      "cursor": {
       "type": "string",
       "pattern": "^\\d+(@\\d+)?$",
       "description": "The previous page's `nextCursor`, unchanged. Ignored with `query`."
      },
      "status": {
       "enum": [
        "open",
        "closed",
        "resolved"
       ],
       "type": "string",
       "description": "Market status. Listings without `query` default to open markets."
      },
      "tradable": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string",
       "description": "\"true\" keeps only markets open for trading on the order book, \"false\" the rest."
      },
      "closingAfter": {
       "type": "string",
       "description": "ISO 8601: only markets closing at or after this time."
      },
      "minLiquidity": {
       "type": "string",
       "pattern": "^[0-9]+(\\.[0-9]+)?$",
       "description": "Minimum market liquidity in USD."
      },
      "minVolume24h": {
       "type": "string",
       "pattern": "^[0-9]+(\\.[0-9]+)?$",
       "description": "Minimum 24-hour volume in USD."
      },
      "closingBefore": {
       "type": "string",
       "description": "ISO 8601: only markets closing at or before this time."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "markets": [
   {
    "id": "512329",
    "fees": {
     "rate": 0,
     "feeType": null
    },
    "venue": "polymarket",
    "status": "open",
    "eventId": "606422",
    "negRisk": false,
    "outcomes": [
     {
      "name": "Yes",
      "price": "0.43",
      "tokenId": "111"
     },
     {
      "name": "No",
      "price": "0.57",
      "tokenId": "222"
     }
    ],
    "question": "Will the Fed cut rates at its December meeting?",
    "tickSize": "0.01",
    "tradable": true,
    "closeTime": "2026-12-10T19:00:00.000Z",
    "liquidity": "125000.5",
    "volume24h": "48210.25",
    "observedAt": "2026-10-30T12:00:00.000Z",
    "resolution": {
     "rules": "Resolves Yes if the FOMC announces a cut to the federal funds target range at its December meeting.",
     "source": "https://www.federalreserve.gov"
    },
    "conditionId": "0x9f1c1c4c1d6a2b2f0d5a7e8b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f",
    "minOrderSize": "5"
   }
  ],
  "nextCursor": "5"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainhilt-polymarket-prediction-markets-search-445723ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainhilt.ai](https://www.zero.xyz/host/chainhilt.ai/llms.txt)
