# Polymarket Prediction Market Snapshot

> Polymarket Prediction Market Snapshot is a paid API for AI agents from api.ssh.autos, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-14).

Fetches a one-page snapshot of active Polymarket prediction market listings, optionally filtered by tag, returning up to 10 results per call.

## Facts

- Endpoint: POST https://api.ssh.autos/v1/markets/polymarket/snapshot?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-prediction-market-snapshot-1acff420
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G99bGrvLyBuQc9YDHxWpb

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-prediction-market-snapshot-1acff420 -d '<json body>'
```

Example prompt: Pull a Polymarket snapshot right now and show me up to 8 active prediction markets tagged 'crypto' — I want to see what people are currently betting on.

## When to prefer this

Use this endpoint when you need a quick, pay-per-call snapshot of live Polymarket prediction markets without setting up an account or subscription. It is ideal for agents that need to monitor prediction market sentiment on demand, filter by topic tag, and retrieve up to 10 market records in a single low-cost call ($0.02 USDC via x402). Prefer it over Kalshi-focused endpoints when specifically targeting Polymarket data.

## Known failure modes

- Empty records array when no markets match the given tag filter (status: succeeded_empty)
- Upstream Polymarket data unavailable or rate-limited, resulting in an error response
- Invalid tag string exceeding 80 characters rejected by schema validation
- maxResults outside allowed range 1–10 rejected with validation error
- Network timeout if Polymarket public data source is slow to respond

## How this service works

Live web and public-record data: marketplaces, real estate, social media, job listings, company registries and government tenders. Pay per call in USDC over x402 with no account, subscribe on the Apify Store, or buy a finished, sourced report.

## Output

Returns a JSON object with a 'records' array of Polymarket prediction market entries (up to the requested maxResults) and a 'summary' object showing the status (e.g. 'succeeded_empty') and total record count. If no matching markets are found, records will be an empty array.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tag": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 80
    },
    {
     "type": "null"
    }
   ],
   "title": "Tag",
   "default": null
  },
  "maxResults": {
   "type": "integer",
   "title": "Maxresults",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "records": [],
  "summary": {
   "status": "succeeded_empty",
   "records": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-prediction-market-snapshot-1acff420/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ssh.autos](https://www.zero.xyz/host/api.ssh.autos/llms.txt)
