# Polymarket Snapshot Market Search

> Polymarket Snapshot Market Search is a paid API for AI agents from polymarket-snapshot.x402supply.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Searches Polymarket prediction markets by text query and returns current outcome prices, volume, liquidity, end date, and resolution status.

## Facts

- Endpoint: POST https://polymarket-snapshot.x402supply.com/tools/search_markets?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-snapshot-market-search-f67ab69a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qoa8tyM2GYxmFJ9y_rgxn

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-snapshot-market-search-f67ab69a -d '<json body>'
```

Example prompt: Search Polymarket for the top 5 active prediction markets about the 2024 US presidential election, sorted by liquidity, and show me the current outcome prices and end dates.

## When to prefer this

Choose this endpoint when you need to discover or look up Polymarket prediction markets by topic and retrieve live-ish market data including probabilities, volume, and liquidity. Prefer this over manual Polymarket browsing or scraping when building agents that need programmatic access to prediction market data. Best for research, monitoring sentiment on events, or building dashboards. Not suitable for placing trades or executing transactions — this is read-only market data.

## Known failure modes

- Empty results if query matches no markets — returns empty list rather than an error
- Query too long (over 200 characters) — validation error
- Limit out of range (below 1 or above 25) — validation error
- Payment failure — 402 response if USDC payment is not included or insufficient
- Stale data if Polymarket snapshot is not recently updated — prices may lag real-time
- Invalid order enum value — schema validation error

## How this service works

Searches Polymarket prediction markets by text and returns current outcome prices, volume, liquidity, end date and resolution status. Read-only market data, not financial advice.

## Output

Returns a list of matching Polymarket prediction markets, each including current outcome prices (probabilities), 24-hour trading volume, liquidity depth, market end date, and resolution status. Results are ordered by the specified sort field (volume24hr, liquidity, or endDate) and limited to the requested count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1
  },
  "order": {
   "enum": [
    "volume24hr",
    "liquidity",
    "endDate"
   ],
   "type": "string",
   "default": "volume24hr"
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "active": {
   "type": "boolean",
   "default": true
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-10-09T15:41:09.090Z",
  "count": 2,
  "query": "bitcoin",
  "source": [
   "https://gamma-api.polymarket.com/public-search?q=bitcoin&limit_per_type=2&events_status=active"
  ],
  "markets": [
   {
    "id": "5207028",
    "slug": "bitcoin-above-84k-on-october-9-2026",
    "active": true,
    "closed": false,
    "endDate": "2026-10-09T16:00:00Z",
    "outcomes": [
     {
      "name": "Yes",
      "price": 0.0015,
      "tokenId": "19237762638725087250431461906504177217210669994224395220619355341866160991623"
     },
     {
      "name": "No",
      "price": 0.9985,
      "tokenId": "93618513453377158964239064041600906714858234857183117432206005018664887747326"
     }
    ],
    "question": "Will the price of Bitcoin be above $84,000 on October 9?",
    "resolved": false,
    "liquidity": 32376.21131,
    "volume24hr": 269998.3403630001,
    "volumeTotal": 284993.617939,
    "resolvedOutcome": null
   },
   {
    "id": "5207026",
    "slug": "bitcoin-above-82k-on-october-9-2026",
    "active": true,
    "closed": false,
    "endDate": "2026-10-09T16:00:00Z",
    "outcomes": [
     {
      "name": "Yes",
      "price": 0.9985,
      "tokenId": "76275224781672571834510870490547558994817468433622601301060687031724197252736"
     },
     {
      "name": "No",
      "price": 0.0015,
      "tokenId": "108082883404059740358158280426412241943168347279841724118483048088071392041003"
     }
    ],
    "question": "Will the price of Bitcoin be above $82,000 on October 9?",
    "resolved": false,
    "liquidity": 28428.87938,
    "volume24hr": 175374.7637170001,
    "volumeTotal": 212454.7067089999,
    "resolvedOutcome": null
   }
  ]
 }
}
```

## More

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